代理运行时

什么是代理？你的 AI 大脑、工作区和工具访问——集于一体。Moltbot 运行源自 p-mono 的单一嵌入式代理运行时。

工作区（必选）

Moltbot 使用单一代理工作区目录（agents.defaults.workspace）作为代理对工具和上下文的唯一工作目录（cwd）。推荐：使用 moltbot setup 在缺失时创建 ~/.clawdbot/moltbot.json 并初始化工作区文件。完整工作区布局与备份说明：代理工作区。若启用 agents.defaults.sandbox，非主会话可在 agents.defaults.sandbox.workspaceRoot 下使用每会话工作区覆盖（见网关配置）。

引导文件（注入）

在 agents.defaults.workspace 内，Moltbot 期望这些用户可编辑文件：

AGENTS.md — 操作说明与「记忆」
SOUL.md — 人设、边界、语气
TOOLS.md — 用户维护的工具说明（如 imsg、sag、约定）
BOOTSTRAP.md — 一次性首次运行仪式（完成后删除）
IDENTITY.md — 代理名称/风格/表情
USER.md — 用户资料与偏好称呼

在新会话的首次轮次，Moltbot 将这些文件内容直接注入代理上下文。空文件跳过。大文件会被截断并加标记以保持提示精简（完整内容需读文件）。若文件缺失，Moltbot 注入一行「缺失文件」标记（moltbot setup 会创建安全默认模板）。仅全新工作区（无其他引导文件）会创建 BOOTSTRAP.md。若在仪式完成后删除，后续重启不应再创建。要完全禁用引导文件创建（用于预置工作区），设置：


{ agent: { skipBootstrap: true } }

内置工具

核心工具（read/exec/edit/write 及相关系统工具）在工具策略允许下始终可用。apply_patch 为可选，由 tools.exec.applyPatch 控制。TOOLS.md 不控制哪些工具存在；它是对你希望如何使用它们的指导。

技能

Moltbot 从三处加载技能（名称冲突时工作区优先）：内置（随安装）、托管/本地 ~/.clawdbot/skills、工作区 <workspace>/skills。技能可由配置/环境控制（见网关配置中的 skills）。

会话

会话记录以 JSONL 存储在：~/.clawdbot/agents/<agentId>/sessions/<SessionId>.jsonl。会话 ID 由 Moltbot 稳定选择。旧版 Pi/Tau 会话目录不会被读取。

流式中的转向

当队列模式为 steer 时，入站消息会注入当前运行。每次工具调用后检查队列；若有排队消息，当前助手消息的剩余工具调用会被跳过（错误工具结果带「Skipped due to queued user message.」），然后将排队的用户消息注入下一轮助手响应前。当队列模式为 followup 或 collect 时，入站消息会保留到当前轮次结束，再以排队负载启动新一轮代理。参见队列。块流式在 text_end 或 message_end 发出部分回复。详见流式与分块。

模型引用

配置中的模型引用（如 agents.defaults.model、agents.defaults.models）按第一个 / 分割解析。配置模型时使用 provider/model。若模型 ID 本身含 /（OpenRouter 风格），需带提供商前缀（如 openrouter/moonshotai/kimi-k2）。省略提供商时，Moltbot 将输入视为别名或默认提供商的模型（仅当模型 ID 中无 / 时有效）。

配置（最小）

至少设置：agents.defaults.workspace、channels.whatsapp.allowFrom（强烈推荐）。

下一篇：群聊