Claw Team Builder

目的

帮助用户通过引导式对话规划并创建 Agent Team，降低多 Agent 配置的复杂度。

工作流程

Phase 1: 需求澄清

通过多轮交互收集信息：

必须收集的信息：

1. Agent ID（或根据名称自动生成）
2. Agent 名称/昵称
3. Agent 定位/用途
4. 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: 方案设计

基于收集信息 + 现有配置，生成：

1. Agent 配置片段
2. Channel 配置片段（如需要）
3. Binding 配置片段

展示配置预览，让用户确认或调整。

Phase 4: 执行创建

1. 备份 openclaw.json
2. 创建目录结构
3. 生成 Bootstrap 文件 (IDENTITY.md, SOUL.md, USER.md)
4. 更新 openclaw.json
5. 运行 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 |

确认创建？(确认/调整)

注意事项

1. 安全第一：修改配置前必须备份
2. 幂等性：支持重复执行，不破坏已有配置
3. 最小侵入：只添加新配置，不修改已有配置
4. 用户友好：尽量从现有配置推断，减少用户输入