Back to skills
extension
Category: OtherNo API key required

飞书Agent一键创建助手

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

personAuthor: wangziqi821-ship-ithubclawhub

🚀 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)

{
  "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)

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

3. 路由配置(写入 bindings)

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

4. 会话配置(写入 workspace-[agentId]/.openclaw/workspace-state.json)

{
  "dmScope": "agent"
}

Workspace 文件模板

SOUL.md(角色性格)

# [角色名称]

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

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

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

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

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

AGENTS.md(协作流程)

# [角色名称] 工作流程

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

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

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

IDENTITY.md(身份定义)

# IDENTITY.md - Who Am I?

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

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

USER.md(用户说明)

# 用户说明

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

TOOLS.md(工具说明)

# 工具说明

## 我能使用的工具
- 文件读写
- 代码执行
- 网页搜索
- 其他 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:创建目录结构

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:创建凭证空文件

touch /Users/wang/.openclaw/credentials/feishu-[agentId]-allowFrom.json

步骤7:重启 Gateway

launchctl kickstart -k gui/$(id -u)/ai.openclaw.gateway

步骤8:等待验证

等待用户粘贴飞书验证信息

步骤9:完成

显示成功消息,引导用户使用


注意事项

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