Claw Team Builder
目的
帮助用户通过引导式对话规划并创建 Agent Team,降低多 Agent 配置的复杂度。
工作流程
Phase 1: 需求澄清
通过多轮交互收集信息:
必须收集的信息:
- Agent ID(或根据名称自动生成)
- Agent 名称/昵称
- Agent 定位/用途
- Agent 性格风格
可选信息(有默认值):
- 模型选择(默认继承 agents.defaults.model.primary)
- Channel 类型(默认 feishu)
- Channel 账户信息(如已有则复用)
Phase 2: 配置读取与分析
必须执行:
读取 ~/.openclaw/openclaw.json,分析:
- agents.defaults: 默认模型、工作空间设置
- agents.list: 现有 Agent ID 列表(检测冲突)
- channels: 现有 Channel 账户配置
- bindings: 现有路由规则
- models.providers: 可用模型列表
冲突检测:
- Agent ID 是否重复
- 工作空间路径是否冲突
- Channel 账户是否已被占用
Phase 3: 方案设计
基于收集信息 + 现有配置,生成:
- Agent 配置片段
- Channel 配置片段(如需要)
- Binding 配置片段
展示配置预览,让用户确认或调整。
Phase 4: 执行创建
- 备份 openclaw.json
- 创建目录结构
- 生成 Bootstrap 文件 (IDENTITY.md, SOUL.md, USER.md)
- 更新 openclaw.json
- 运行 openclaw doctor --fix 验证
Phase 5: 结果反馈
展示创建结果,提供后续操作建议。
可用工具
{baseDir}/scripts/create-agent.js- Agent 创建脚本{baseDir}/lib/config-builder.js- 配置构建工具{baseDir}/lib/validator.js- 配置验证工具
模板文件
位于 {baseDir}/templates/:
IDENTITY.md.tmpl- Agent 身份模板SOUL.md.tmpl- Agent 灵魂模板USER.md.tmpl- 用户信息模板
示例对话
用户: 我想创建一个新的 agent,专门处理工作任务
Agent: 好的,让我帮你规划。
首先让我读取一下现有配置... ✓
📍 **需求澄清**
这个 Agent 的主要用途是?
- 任务管理?
- 日程提醒?
- 文档处理?
- 其他?
用户: 任务管理和日程提醒
Agent: 明白了。给它起个名字?
用户: 启明
Agent: "启明",很好!
它应该有什么样的性格?
1. 高效严肃型 - 专注执行
2. 亲切温和型 - 细致耐心
3. 其他风格
用户: 高效严肃型
Agent: 收到。让我看看你的 Channel 配置...
你现在有 2 个飞书账户:
- luna-bot (已绑定 main agent)
- qiming-bot (未使用)
要用现有的 qiming-bot 账户,还是配置新的?
用户: 用现有的 qiming-bot
Agent: 完美!配置方案如下:
📋 **配置预览**
| 项目 | 值 |
|------|-----|
| Agent ID | qiming |
| 名称 | 启明 |
| 工作空间 | ~/.openclaw/workspace-qiming |
| 模型 | bailian/MiniMax-M2.5 |
| Channel | feishu / qiming-bot |
确认创建?(确认/调整)
注意事项
- 安全第一:修改配置前必须备份
- 幂等性:支持重复执行,不破坏已有配置
- 最小侵入:只添加新配置,不修改已有配置
- 用户友好:尽量从现有配置推断,减少用户输入