Agent Runtime 🤖

Workspace (required)

Bootstrap files (injected)

• AGENTS.md — operating instructions + “memory”
• SOUL.md — persona, boundaries, tone
• TOOLS.md — user-maintained tool notes (e.g. imsg, sag, conventions)
• BOOTSTRAP.md — one-time first-run ritual (deleted after completion)
• IDENTITY.md — agent name/vibe/emoji
• USER.md — user profile + preferred address

{ agent: { skipBootstrap: true } }

Built-in tools

Skills

• Bundled (shipped with the install)
• Managed/local: ~/.openclaw/skills
• Workspace: <workspace>/skills

pi-mono integration

• No pi-coding agent runtime.
• No ~/.pi/agent or <workspace>/.pi settings are consulted.

Sessions

• ~/.openclaw/agents/<agentId>/sessions/<SessionId>.jsonl

Steering while streaming

Model refs

• Use provider/model when configuring models.
• If the model ID itself contains / (OpenRouter-style), include the provider prefix (example: openrouter/moonshotai/kimi-k2).
• If you omit the provider, OpenClaw treats the input as an alias or a model for the default provider (only works when there is no / in the model ID).

Configuration (minimal)

• agents.defaults.workspace
• channels.whatsapp.allowFrom (strongly recommended)