核心用法
Agent Builder 是面向 OpenClaw 生态的智能体工程化工具,采用四阶段工作流实现代理的端到端构建:
1. 访谈阶段(Phase 1):通过 7 个高信噪比问题快速锚定代理的核心参数——使命陈述、通信表面(Telegram/WhatsApp/Discord/iMessage 等)、自治等级(Advisor/Operator/Autopilot 三档)、硬禁止行为、记忆策略、语调偏好、工具调用姿态。
2. 生成阶段(Phase 2):自动输出最小可行工作空间,包含 IDENTITY.md(身份定义)、SOUL.md(人格与行为准则)、AGENTS.md(操作规则与子代理管理)、USER.md(用户画像)、HEARTBEAT.md(自检计划);可选扩展 MEMORY.md 及日期化记忆片段、TOOLS.md 环境工具说明。
3. 护栏阶段(Phase 3):强制植入五条安全机制——破坏性操作前确认、外发消息前确认、CLI 错误即停、最大迭代/循环熔断、群聊礼仪规范,并强调子代理规则必须沉淀于 AGENTS.md。
4. 验收阶段(Phase 4):提供 5–10 条场景化测试用例(如「草拟但不发送消息」「群聊中判断是否响应」),验证代理行为边界。
对于存量代理迭代,工具支持手术式微调:基于三大故障模式(循环、越权、冗余)定位问题,针对性修改 SOUL.md、AGENTS.md、HEARTBEAT.md。
显著优点
- 架构规范性:严格遵循 OpenClaw 工作空间标准,强制引用
references/openclaw-workspace.md与templates.md,降低配置漂移风险。 - 安全内置:将「破坏性操作确认」「群聊身份识别」从建议项提升为强制检查项,符合高自治代理的安全基线。
- 渐进式披露:采用多轮短问答替代冗长问卷,尊重高级用户的时间成本。
- 可审计性:生成文件天然支持版本控制,记忆模块按日期切片便于回溯。
潜在缺点与局限性
- 生态锁定:深度绑定 OpenClaw 文件协议与目录结构,迁移至其他代理框架(如 AutoGPT、LangChain 的 Agent 实现)需人工重写。
- 模板依赖:若
references/templates.md未及时更新,生成内容可能滞后于 OpenClaw 最新规范。 - 心跳计划空转:默认
HEARTBEAT.md常为空,用户若缺乏运维意识,长期运行代理可能出现状态腐化。 - 无运行时监控:仅负责「生成配置」,不代理实际执行或提供在线调试能力。
适合人群
- AI 产品经理/工程师:需快速原型化垂直领域代理(客服、投研、日程助理)。
- OpenClaw 生态用户:希望标准化团队内多代理的配置管理与安全对齐。
- 高级终端用户:具备一定技术背景,愿意通过 Markdown 文件微调代理行为。
常规风险
- 自治等级误判:用户可能高估代理的上下文理解能力,将 Advisor 级任务误设为 Autopilot,导致意外操作。
- 记忆泄露:若
MEMORY.md包含敏感信息且未设置访问控制,多用户共享工作空间时存在数据泄露隐患。 - 子代理规则碎片化:开发者可能将关键约束写在
SOUL.md而非AGENTS.md,导致子代理继承失效。 - 参考文件缺失:运行依赖
references/openclaw-workspace.md等外部文件,若环境配置不全将中断工作流。