Agent Builder

🧬 端到端构建高自治 OpenClaw 代理

OpenClaw 智能体工作流构建器,支持从零设计完整代理环境(身份、人格、规则、记忆、心跳计划),并提供迭代优化与安全护栏检查。

收藏
16.6k
安装
6.5k
版本
1.0.0
CLS 安全性认证2026-05-06
点击查看完整报告 >

使用说明

核心用法

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.mdAGENTS.mdHEARTBEAT.md

显著优点

  • 架构规范性:严格遵循 OpenClaw 工作空间标准,强制引用 references/openclaw-workspace.mdtemplates.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 等外部文件,若环境配置不全将中断工作流。

安全解读

核心用法

Agent Builder 是 OpenClaw 生态的官方工具 Skill,用于端到端构建高表现力的 AI Agent。核心功能分为两大场景:

1. 从零构建 Agent

  • 通过 7 个精炼问题收集需求(Job statement、交互渠道、自主级别、硬性禁止事项、记忆策略、语气风格、工具使用偏好)
  • 生成标准工作区文件:IDENTITY.md(人格定义)、SOUL.md(灵魂/行为准则)、AGENTS.md(操作规则与技能清单)、USER.md(用户画像)、HEARTBEAT.md(定时自检清单)
  • 可选生成 MEMORY.md 及结构化日志种子文件

2. 迭代优化现有 Agent

  • 诊断 Top 3 故障模式(循环、越权、冗长等)
  • 针对性修改 SOUL.md、AGENTS.md、HEARTBEAT.md
  • 保持最小化、外科式改动原则

显著优点

  • 架构严谨:遵循 OpenClaw 官方 workspace 规范,文件职责分离清晰
  • 安全内置:生成的模板强制包含"破坏性操作前询问""出站消息前确认""CLI 错误熔断"等 guardrails
  • 零攻击面:纯 Markdown 文档型 Skill,无可执行代码、无依赖、无网络
  • 场景适配:支持 Advisor/Operator/Autopilot 三级自主模型,匹配不同风险容忍度

潜在局限

  • 需外部执行:本身不执行文件写入,依赖宿主环境(如 OpenClaw CLI 或 IDE 插件)落地生成
  • 模板化上限:复杂记忆架构或动态子代理编排需手动微调
  • 生态绑定:深度耦合 OpenClaw 文件规范,迁移至其他 Agent 框架需重构

适合人群

  • OpenClaw 生态开发者、技术产品经理
  • 需要"合规优先" Agent 的企业内训/法务/财务场景
  • 希望快速验证 Agent 设计后再工程化的原型团队

常规风险

  • 误配置风险:用户可能选择 Autopilot 级别但未充分测试,导致过度自主
  • 模板理解偏差:MEMORY.md 等可选文件若配置不当,可能泄露敏感上下文至群聊
  • 版本漂移:迭代阶段若未同步更新所有 .md 文件,可能出现规则冲突

Agent Builder 内容

references文件夹
手动下载zip · 5.9 kB
architecture.mdtext/markdown
请选择文件