agent-builder

核心用法

Agent Builder 是 OpenClaw 生态的官方代理构建技能，采用四阶段工作流帮助用户从零设计或迭代优化 AI 代理。Phase 1 通过精简的访谈问卷（使命陈述、渠道选择、自主级别、硬性禁令、记忆策略、语气风格、工具姿态）收集关键需求；Phase 2 生成标准工作空间文件（IDENTITY.md、SOUL.md、AGENTS.md、USER.md、HEARTBEAT.md 及可选 MEMORY.md）；Phase 3 强制嵌入安全护栏清单，包括破坏性操作前确认、外发消息前确认、CLI 错误终止、循环熔断机制、群聊礼仪等；Phase 4 提供 5-10 个验收测试场景验证行为。对于现有代理迭代，技能支持针对性微调 SOUL.md（人格/边界）、AGENTS.md（操作规则/记忆/委托）、HEARTBEAT.md（心跳检查清单），保持变更最小化。

显著优点

1. 架构规范性：严格遵循 OpenClaw 工作空间标准，确保生成的代理具备一致的文件结构和可维护性。
2. 安全优先设计：内置多层护栏机制，从架构层面预防代理越权、误操作和无限循环等典型风险。
3. 迭代友好：区分"从零构建"与"行为调优"两种模式，后者采用手术式 diff 策略，避免过度修改。
4. 文档即代码：纯 Markdown 配置驱动，无需编程基础即可创建复杂代理，降低 AI 工程门槛。
5. 可验证性：提供标准化验收测试模板，确保代理行为符合预期后再投入生产。

潜在缺点与局限性

1. 生态绑定：深度依赖 OpenClaw 特定规范，生成的配置无法直接迁移至 LangChain、AutoGPT 等其他代理框架。
2. 静态模板局限：当前版本仅生成文档模板，不包含运行时环境自动配置或一键部署能力，用户需手动搭建执行环境。
3. 高级场景覆盖不足：对于需要复杂多代理协作、动态工具发现、或实时学习机制的尖端场景，模板化生成可能显得僵化。
4. 无可视化界面：纯文本交互流程，对偏好图形化配置的用户不够友好。

适合的目标群体

• AI 产品经理：快速将代理概念转化为可执行规范，对齐技术实现。
• 开发者与提示工程师：需要标准化脚手架加速 OpenClaw 代理开发，减少重复性文档编写。
• 安全敏感型组织：内置护栏清单满足合规要求，适合金融、医疗等高风险场景。
• 代理运维团队：通过迭代工作流持续优化生产环境代理的行为边界和心跳策略。

使用风险

1. 配置误用风险：生成的护栏规则依赖用户正确填写访谈答案，若对"Autopilot"级别理解不足可能导致过度授权。
2. 模板过时风险：OpenClaw 规范演进后，本地引用的 templates.md 可能滞后，建议定期同步官方仓库。
3. 验收测试覆盖不足：提供的 5-10 个场景为基线测试，复杂边缘 case 仍需用户自行补充验证。
4. 无运行时保护：本技能仅负责"设计时"配置生成，代理实际运行时的资源消耗、API 限流、异常熔断需额外基础设施保障。