跳转到主要内容

​
Agent Runtime 🤖

OpenClaw 运行一个源自 pi-mono 的嵌入式智能体运行时。

​
工作区（必需）

OpenClaw 使用单一智能体工作区目录（agents.defaults.workspace）作为智能体唯一的工作目录（cwd），用于工具和上下文。 建议：使用 openclaw setup 在缺失时创建 ~/.openclaw/openclaw.json 并初始化工作区文件。 完整工作区布局 + 备份指南：智能体工作区 如果启用了 agents.defaults.sandbox，非主会话可以在 agents.defaults.sandbox.workspaceRoot 下使用按会话隔离的工作区覆盖此设置（参见 Gateway 网关配置）。

​
Bootstrap files (injected)

在 agents.defaults.workspace 内，OpenClaw 期望以下用户可编辑的文件：
  • AGENTS.md — 操作指令 + “记忆”
  • SOUL.md — 人设、边界、语气
  • TOOLS.md — 用户维护的工具说明（例如 imsg、sag、约定）
  • BOOTSTRAP.md — 一次性首次运行仪式（完成后删除）
  • IDENTITY.md — 智能体名称/风格/表情
  • USER.md — 用户档案 + 偏好称呼
在新会话的第一轮，OpenClaw 将这些文件的内容直接注入智能体上下文。 Blank files are skipped. 空文件会被跳过。大文件会被修剪和截断并添加标记，以保持提示词精简（阅读文件获取完整内容）。 如果文件缺失，OpenClaw 会注入一行”文件缺失”标记（openclaw setup 将创建安全的默认模板）。 BOOTSTRAP.md 仅在全新工作区（没有其他引导文件存在）时创建。如果你在完成仪式后删除它，后续重启不应重新创建。 If you delete it after completing the ritual, it should not be recreated on later restarts. 要完全禁用引导文件创建（用于预置工作区），请设置： 
{ agent: { skipBootstrap: true } }

​
内置工具

Core tools (read/exec/edit/write and related system tools) are always available, subject to tool policy. 核心工具（read/exec/edit/write 及相关系统工具）始终可用，受工具策略约束。apply_patch 是可选的，由 tools.exec.applyPatch 控制。TOOLS.md 不控制哪些工具存在；它是关于_你_希望如何使用它们的指导。 TOOLS.md does not control which tools exist; it’s guidance for how you want them used.

​
技能

OpenClaw 从三个位置加载 Skills（名称冲突时工作区优先）：
  • 内置（随安装包提供）
  • 托管/本地：~/.openclaw/skills
  • 工作区：<workspace>/skills
Skills 可通过配置/环境变量控制（参见 Gateway 网关配置 中的 skills）。

​
pi-mono 集成

OpenClaw 复用 pi-mono 代码库的部分内容（模型/工具），但会话管理、设备发现和工具连接由 OpenClaw 负责。
  • 无 pi-coding 智能体运行时。
  • 不读取 ~/.pi/agent 或 <workspace>/.pi 设置。

​
会话

会话记录以 JSONL 格式存储在：
  • ~/.openclaw/agents/<agentId>/sessions/<SessionId>.jsonl
The session ID is stable and chosen by OpenClaw. Legacy Pi/Tau session folders are not read.

​
流式传输中的引导

When queue mode is steer, inbound messages are injected into the current run. 当队列模式为 steer 时，入站消息会注入当前运行。 队列在每次工具调用后检查；如果存在排队消息，当前助手消息的剩余工具调用将被跳过（工具结果显示错误”Skipped due to queued user message.”），然后在下一个助手响应前注入排队的用户消息。 When queue mode is followup or collect, inbound messages are held until the current turn ends, then a new agent turn starts with the queued payloads. See Queue for mode + debounce/cap behavior. Block streaming sends completed assistant blocks as soon as they finish; it is off by default (agents.defaults.blockStreamingDefault: "off"). 分块流式传输在助手块完成后立即发送；默认为关闭（agents.defaults.blockStreamingDefault: "off"）。 通过 agents.defaults.blockStreamingBreak 调整边界（text_end 与 message_end；默认为 text_end）。 使用 agents.defaults.blockStreamingChunk 控制软块分块（默认 800–1200 字符；优先段落分隔，其次换行；最后是句子）。 使用 agents.defaults.blockStreamingCoalesce 合并流式块以减少单行刷屏（发送前基于空闲的合并）。非 Telegram 渠道需要显式设置 *.blockStreaming: true 以启用分块回复。 工具启动时发出详细工具摘要（无防抖）；Control UI 在可用时通过智能体事件流式传输工具输出。 更多详情：流式传输 + 分块。 Control soft block chunking with agents.defaults.blockStreamingChunk (defaults to 800–1200 chars; prefers paragraph breaks, then newlines; sentences last). Coalesce streamed chunks with agents.defaults.blockStreamingCoalesce to reduce single-line spam (idle-based merging before send). Non-Telegram channels require explicit *.blockStreaming: true to enable block replies. Verbose tool summaries are emitted at tool start (no debounce); Control UI streams tool output via agent events when available. More details: Streaming + chunking.

​
模型引用

配置中的模型引用（例如 agents.defaults.model 和 agents.defaults.models）通过在第一个 / 处分割来解析。
  • 配置模型时使用 provider/model。
  • 如果模型 ID 本身包含 /（OpenRouter 风格），请包含提供商前缀（例如：openrouter/moonshotai/kimi-k2）。
  • 如果省略提供商，OpenClaw 将输入视为别名或默认提供商的模型（仅在模型 ID 中没有 / 时有效）。

​
配置（最小）

至少需要设置：
  • agents.defaults.workspace
  • channels.whatsapp.allowFrom（强烈建议）
下一篇：群聊 🦞