agent-father

# 👨‍🍼 Agent Father Skill

创建新 Agent 和员工的完整解决方案，自动从 openclaw.json 读取飞书配置，包含 JSON 配置、会话管理、群组配置和岗前培训。

🚀 快速开始

创建单个员工

```bash # 基本用法 ./scripts/create-employee.sh <姓名> <工号> <电话> [描述] [初始用户]

# 示例：创建客服工程师 ./scripts/create-employee.sh "客服工程师" "CS-001" "13800138000" "客服团队" ```

批量创建员工

```bash # 使用批量脚本 ./scripts/batch-create.sh employees.csv ```

删除员工

```bash ./scripts/delete-agent.sh <agent-id> ```

---

📋 核心脚本

1. create-employee.sh - 创建员工

用法： ```bash ./scripts/create-employee.sh <agent-name> <role> <phone> [description] [initial-user] ```

参数： | 参数 | 必填 | 说明 | 示例 | |------|------|------|------| | agent-name | ✅ | Agent 显示名称 | `客服工程师` | | role | ✅ | 工号/角色代码 | `CS-001` | | phone | ✅ | 联系电话 | `13800138000` | | description | ❌ | 群组描述 | `客服团队` | | initial-user | ❌ | 初始成员用户 ID | `ou_xxx` |

1. 执行流程：
2. ✅ 创建飞书群组
3. ✅ 创建独立工作区
4. ✅ 生成 agent.json 配置
5. ✅ 创建 IDENTITY.md 和 SOUL.md
6. ✅ 注册到 openclaw
7. ✅ 更新员工名单

---

2. delete-agent.sh - 删除员工

用法： ```bash ./scripts/delete-agent.sh <agent-id> ```

• 功能：
• 删除 agent 目录
• 删除工作区
• 从 openclaw.json 移除配置
• 从员工名单移除
• 可选：删除飞书群组

---

3. create-feishu-chat.sh - 创建飞书群组

用法： ```bash ./scripts/create-feishu-chat.sh --name "群名称" --description "描述" --users "ou_xxx,ou_yyy" ```

• 参数：
• `--name`: 群名称（必填）
• `--description`: 群描述（可选）
• `--users`: 初始成员，逗号分隔（可选）
• `--owner`: 群主用户 ID（可选）
• `--type`: 群类型 public/private/group（默认：group）

配置： 自动从 `~/.openclaw/openclaw.json` 读取飞书 App ID 和 App Secret

---

4. onboarding.sh - 员工入职培训

用法： ```bash ./scripts/onboarding.sh <agent-id> ```

• 功能：
• 生成岗前培训材料
• 配置工作流程
• 设置工作规范

---

🔧 工具函数

list-employees - 列出所有员工

```bash # 查看员工名单 cat ~/.openclaw/workspace/employees.json | jq '.employees[] | {id, name, phone, chatId}' ```

get-agent-info - 获取 Agent 信息

```bash # 查看指定 Agent 配置 cat ~/.openclaw/agents/<agent-id>/agent/agent.json | jq . ```

check-agent-status - 检查 Agent 状态

```bash # 检查配置是否有效 openclaw agents list --bindings ```

---

📁 目录结构

``` agent-father/ ├── SKILL.md # 技能文档 ├── QUICKSTART.md # 快速开始指南 ├── scripts/ │ ├── create-employee.sh # 创建员工（主脚本） │ ├── delete-agent.sh # 删除员工 │ ├── create-feishu-chat.sh # 创建飞书群组 │ ├── onboarding.sh # 入职培训 │ └── batch-create.sh # 批量创建 ├── references/ │ ├── templates/ # 配置模板 │ └── examples/ # 使用示例 └── 修复报告.md # 问题修复记录 ```

---

🎯 使用场景

场景 1: 创建新岗位

```bash # 创建产品经理 ./scripts/create-employee.sh "产品经理" "PM-001" "13900139000" "产品团队"

# 创建测试工程师 ./scripts/create-employee.sh "测试工程师" "QA-001" "13700137000" "测试团队" ```

场景 2: 员工离职

```bash # 删除员工（保留数据） ./scripts/delete-agent.sh cs-001

# 删除员工（包含飞书群组） ./scripts/delete-agent.sh cs-001 --delete-chat ```

---

⚠️ 注意事项

1. 命名规范

• Agent ID: 小写字母 + 数字 + 连字符（如：`cs-001`）
• 工号格式: 大写字母 + 连字符 + 数字（如：`CS-001`）
• 避免使用: `main` 是保留名称

2. 飞书配置

确保 `~/.openclaw/openclaw.json` 包含飞书配置：

```json { "channels": { "feishu": { "appId": "cli_xxx", "appSecret": "xxx" } } } ```

---

🔍 故障排查

问题 1: "main" is reserved **解决**: 使用其他名称，如 `cs-001`、`dev-001`

问题 2: JSON 配置无效 **解决**: ```bash openclaw status openclaw doctor --fix ```

问题 3: 飞书群组创建失败 **解决**: ```bash cat ~/.openclaw/openclaw.json | grep -A 2 feishu openclaw channels login --channel feishu ```

---

_用 AI 赋能团队，让每个岗位都有专属智能助手。_