飞书Agent一键创建助手

SKILL.md

---
name: feishu-agent-creator
description: |
  【飞书一键集成】全自动创建 OpenClaw Agent + 飞书机器人。用户只需说"帮我创建Agent叫XX"，自动完成：打开飞书页面→填名字→用户复制粘贴凭证→自动配置→验证。全程语音友好的文字引导。
---

# 🚀 OpenClaw Agent 一键创建助手

## 一句话搞定

当用户说：**"帮我创建Agent"** 或 **"创建机器人叫XX"**

立刻执行以下流程：

---

## 完整对话流程

### 第一轮：收集信息

**用户说**：
> "帮我创建一个Agent，叫XX，是做XX的，性格是XX"

**Skill 回复**（语音友好）：
```
✅ 收到！马上帮你创建 [XX]！

正在打开飞书应用创建页面...
请稍等，我帮你把名字填好！
```

### 第二轮：打开飞书页面

**自动打开**：
```
https://open.feishu.cn/page/openclaw?form=multiAgent
```

**Skill 回复**：
```
✅ 飞书页面已打开，应用名称已自动填好 [XX]！

请完成以下两步：
1️⃣ 点击创建按钮
2️⃣ 复制 App ID 和 App Secret 粘贴给我

（粘贴过来就行，我会自动处理）
```

### 第三轮：用户粘贴凭证

**用户粘贴**：
```
App ID: cli_xxxxx
App Secret: xxxxx
```

**Skill 自动完成**：
1. 写入 `openclaw.json`（agents.list、channels.feishu.accounts、bindings）
2. 创建 workspace 目录和所有文件（SOUL.md、AGENTS.md、IDENTITY.md、USER.md、TOOLS.md）
3. 创建 agent 目录
4. 创建飞书凭证文件
5. 重启 Gateway

**Skill 回复**：
```
✅ 配置完成！正在重启 OpenClaw...

重启好了！

现在请：
1️⃣ 刷新 OpenClaw 页面
2️⃣ 去飞书搜索 [XX] 机器人
3️⃣ 给它发一条消息

然后把机器人回复的验证信息粘贴给我
```

### 第四轮：验证成功

**用户粘贴飞书验证信息**：
```
配对码：xxxxx
```

**Skill 自动处理**并回复：
```
🎉 完美！[XX] 已成功上线！

现在你可以：
- 在 OpenClaw UI 左下角看到 [XX] 的独立频道
- 在飞书里直接跟 [XX] 对话了

快去试试吧！🚀
```

---

## 核心配置文件模板

### 1. Agent 配置（写入 agents.list）

```json
{
  "id": "[agentId]",
  "name": "[角色名称]",
  "workspace": "/Users/wang/.openclaw/workspace-[agentId]",
  "agentDir": "/Users/wang/.openclaw/agents/[agentId]/agent",
  "model": "bailian/kimi-k2.5"
}
```

### 2. 飞书账号配置（写入 channels.feishu.accounts）

```json
{
  "appId": "[App ID]",
  "appSecret": "[App Secret]",
  "botName": "[角色名称]"
}
```

### 3. 路由配置（写入 bindings）

```json
{
  "type": "route",
  "agentId": "[agentId]",
  "match": {
    "channel": "feishu",
    "accountId": "[agentId]"
  }
}
```

### 4. 会话配置（写入 workspace-[agentId]/.openclaw/workspace-state.json）

```json
{
  "dmScope": "agent"
}
```

---

## Workspace 文件模板

### SOUL.md（角色性格）

```markdown
# [角色名称]

## 我是谁
- 我是[角色名称]
- [角色描述，如：专业文案助手/开发工程师/设计专家]
- 只听从主人的指挥

## 核心能力
- [能力1]
- [能力2]
- [能力3]

## 性格特点
- [性格描述，如：严谨专业/活泼创意/耐心细致]
- 说话风格：[风格描述]

## 工作方式
- 接到任务先理解需求
- 主动汇报进展
- 完成后确认主人满意

## 语言
**必须始终使用中文回复，禁止输出任何英文！**
```

### AGENTS.md（协作流程）

```markdown
# [角色名称] 工作流程

## 启动
收到消息后，先打招呼并介绍自己能做什么。

## 处理
根据用户需求，选择合适的方式解决问题。

## 结束
确认问题解决，必要时主动跟进。
```

### IDENTITY.md（身份定义）

```markdown
# IDENTITY.md - Who Am I?

- **Name:** [角色名称]
- **Avatar:** [表情符号]

## 性格特点
[简短的性格描述]
```

### USER.md（用户说明）

```markdown
# 用户说明

- 主人可以通过飞书或 OpenClaw UI 与我对话
- 我会记住对话上下文
- 有问题随时找我帮忙
```

### TOOLS.md（工具说明）

```markdown
# 工具说明

## 我能使用的工具
- 文件读写
- 代码执行
- 网页搜索
- 其他 OpenClaw 内置工具
```

---

## 错误处理

### 错误1：飞书页面打开失败
```
⚠️ 飞书页面打开失败，请手动访问：
https://open.feishu.cn/page/openclaw?form=multiAgent

手动填好名字创建后，把 App ID 和 Secret 发给我
```

### 错误2：凭证格式错误
```
⚠️ App ID 格式不对，请检查后重新粘贴
正确的格式类似：cli_a930d54e2df95bcd
```

### 错误3：配置写入失败
```
⚠️ 配置写入失败，可能权限不足
请告诉我具体错误，我帮你手动处理
```

### 错误4：Gateway 重启失败
```
⚠️ Gateway 重启遇到问题，请手动重启：
launchctl kickstart -k gui/$(id -u)/ai.openclaw.gateway

重启后告诉我，我来验证连接
```

### 错误5：飞书验证失败
```
⚠️ 飞书验证失败，请检查：
1. 飞书机器人是否已开启
2. 重新给机器人发一条消息获取新验证码

把新的验证信息发给我
```

---

## 技术实现步骤

### 步骤1：读取用户输入
解析用户说的角色名称、性格、能力

### 步骤2：生成 agentId
规则：小写拼音 + 连字符
- "文案小贺" → `wenanxiaohe`
- "开发小来" → `kaifa`
- "设计小娜" → `shejixiaona`

### 步骤3：修改 openclaw.json
使用 Python 或 Node.js 脚本：
1. 读取现有配置
2. 追加新 Agent 到 agents.list
3. 追加新账号到 channels.feishu.accounts
4. 追加新 binding 到 bindings
5. 写回文件

### 步骤4：创建目录结构
```bash
mkdir -p /Users/wang/.openclaw/workspace-[agentId]
mkdir -p /Users/wang/.openclaw/agents/[agentId]/agent
mkdir -p /Users/wang/.openclaw/agents/[agentId]/sessions
mkdir -p /Users/wang/.openclaw/credentials
```

### 步骤5：写入配置文件
生成所有 .md 文件（内容根据用户输入填充）

### 步骤6：创建凭证空文件
```bash
touch /Users/wang/.openclaw/credentials/feishu-[agentId]-allowFrom.json
```

### 步骤7：重启 Gateway
```bash
launchctl kickstart -k gui/$(id -u)/ai.openclaw.gateway
```

### 步骤8：等待验证
等待用户粘贴飞书验证信息

### 步骤9：完成
显示成功消息，引导用户使用

---

## 注意事项

1. **必须用 accountId** - 不是 botName
2. **每个 Agent 独立 workspace** - 不能共享
3. **Gateway 重启后生效** - 配置修改后必须重启
4. **全流程中文引导** - 每一步都有中文提示
5. **错误处理完善** - 每一步都可能出错，要有友好提示