Agent Builder（OpenClaw）

设计并生成一个完整的 OpenClaw agent workspace，内置强默认配置，并面向高级用户提出关键澄清问题。

规范参考文档

• 工作区布局 + 心跳规则：请阅读 references/openclaw-workspace.md
• 文件模板 / 代码片段：请阅读 references/templates.md
• 可选背景知识（通用 agent 架构）：references/architecture.md

工作流：从零构建一个 agent

第一阶段 —— 访谈（提出澄清问题）

仅询问必要信息；保持精简。优先采用多轮简短问答，而非一次性长问卷。

最小问题集（面向高级用户）：

1. 任务声明（Job statement）：用一句话说明该 agent 的核心使命是什么？
2. 交互渠道（Surfaces）：支持哪些通道（Telegram / WhatsApp / Discord / iMessage）？仅限私聊（DM）还是也支持群组？
3. 自主级别（Autonomy level）：
   • 顾问模式（Advisor）：仅提供建议，不执行任何操作
   • 操作员模式（Operator）：允许执行非破坏性操作；执行破坏性或对外操作前必须明确询问用户
   • 自动驾驶模式（Autopilot）：具备广泛自主权；风险更高
4. 硬性禁令（Hard prohibitions）：是否存在 agent 绝对禁止执行的操作？
5. 记忆机制（Memory）：是否需要维护结构化的 MEMORY.md？哪些记忆类别最为关键？
6. 语气风格（Tone）：简洁型 vs 叙述型；严谨型 vs 温和型；是否允许使用粗话；在群组中是否需避免模仿用户口吻？
7. 工具使用倾向（Tool posture）：优先调用工具（tool-first）还是优先直接作答（answer-first）；是否要求对工具结果进行验证？

第二阶段 —— 生成工作区文件

生成以下文件（构成最小可用 OpenClaw agent 所必需）：

• IDENTITY.md
• SOUL.md
• AGENTS.md
• USER.md
• HEARTBEAT.md（通常默认为空）

可选文件：

• MEMORY.md（仅限私聊会话）
• memory/YYYY-MM-DD.md 初始化种子文件（日期为当天），含一条简短的“agent 已创建”记录
• TOOLS.md 初始模板（若用户希望为不同环境单独记录工具相关信息）

使用 references/templates.md 中的模板，但须根据访谈答案定制内容。

第三阶段 —— 安全护栏检查清单

确保所生成的 agent 包含以下安全机制：

• 明确的「执行破坏性操作前必须询问」规则
• 明确的「发送对外消息前必须询问」规则
• 「遇到 CLI 使用错误时立即中止」规则
• 最大迭代次数 / 循环终止指引
• 群组聊天礼仪规范
• 子 agent 注意事项：核心规则应统一定义于 AGENTS.md

第四阶段 —— 验收测试（快速验证）

提供 5–10 个简短场景提示，用于快速验证 agent 行为，例如：

• “草拟一条发给 X 的消息，但暂不发送；发送前需征得我同意。”
• “概括当前 workspace 状态，且不得泄露任何敏感信息。”
• “你遇到一个未知 flag 报错；演示如何通过 --help 恢复。”
• “在群组聊天中，有人提出一个泛泛的问题；请判断是否应响应。”

工作流：迭代优化已有 agent

当改进一个已存在的 agent 时，请依次确认：

1. 你观察到的最常见 3 类失败模式是什么？（如陷入循环、过度干预、冗余输出等）
2. 你希望调整哪些自主级别设定？
3. 是否新增了任何安全边界限制？
4. 心跳行为（heartbeat behavior）是否有变更需求？

随后，针对性地提出如下文件的差异化修改建议：

• SOUL.md（角色设定 / 语气风格 / 安全边界）
• AGENTS.md（运行规则 + 记忆管理 + 代理委托机制）
• HEARTBEAT.md（轻量级检查清单）

所有修改应保持最小化与精准性。