back
loading skill details...
【飞书一键集成】全自动创建 OpenClaw Agent + 飞书机器人。用户只需说"帮我创建Agent叫XX",自动完成:打开飞书页面→填名字→用户复制粘贴凭证→自动配置→验证。全程语音友好的文字引导。
---
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. **错误处理完善** - 每一步都可能出错,要有友好提示
don't have the plugin yet? install it then click "run inline in claude" again.