claw-team-builder

# 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)
- qimin...