agent-father

创建和管理 AI Agent/员工的全流程工具。支持一键创建 Agent、飞书群组、工作区配置、员工入职。自动从 openclaw.json 读取配置。使用场景：(1) 创建新 Agent/员工，(2) 批量入职，(3) 群组配置，(4) 岗前培训，(5) 员工管理。

👨‍🍼 Agent Father Skill

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

🚀 快速开始

创建单个员工

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

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

批量创建员工

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

删除员工

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

---

📋 核心脚本

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

用法：

./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. ✅ 生成 agent.json 配置
4. ✅ 创建 IDENTITY.md 和 SOUL.md
5. ✅ 注册到 openclaw
6. ✅ 更新员工名单

---

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

用法：

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

功能：

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

---

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

用法：

./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 - 员工入职培训

用法：

./scripts/onboarding.sh <agent-id>

功能：

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

---

🔧 工具函数

list-employees - 列出所有员工

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

get-agent-info - 获取 Agent 信息

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

check-agent-status - 检查 Agent 状态

# 检查配置是否有效
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: 创建新岗位

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

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

场景 2: 员工离职

# 删除员工（保留数据）
./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 包含飞书配置：

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

---

🔍 故障排查

问题 1: "main" is reserved

解决: 使用其他名称，如 cs-001、dev-001

问题 2: JSON 配置无效

解决:

openclaw status
openclaw doctor --fix

问题 3: 飞书群组创建失败

解决:

cat ~/.openclaw/openclaw.json | grep -A 2 feishu
openclaw channels login --channel feishu

---

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