OpenClaw 飞书机器人集成完全指南

基于阿里云官方文档 + feishu-bot-config 技能优化 + 多 Agent 管理最佳实践

---

📖 目录

1. 方案概述
2. 环境准备
3. [安装 feishu-bot-config 技能（推荐）](#安装 feishu-bot-config 技能（推荐）)
4. 创建飞书应用
5. [配置 OpenClaw（三种方式）](#配置 OpenClaw（三种方式）)
6. 配对与验证
7. [多 Agent 管理](#多 Agent 管理)
8. 定时任务与高级功能
9. 常见问题排查
10. 命令速查表

---

方案概述

什么是 OpenClaw 飞书集成？

OpenClaw（原 Moltbot、Clawdbot）集成飞书后，你可以在飞书群聊或单聊中，通过自然语言直接与 AI Agent 交互。

两种配置方案对比

特性	阿里云标准方案	feishu-bot-config 技能方案
配置方式	手动执行多条命令	对话中自动完成
配对方式	手动执行 openclaw pairing approve	将配对码发给 Agent 自动配对
多 Agent 管理	需手动切换配置	自然语言指定 Agent
错误排查	自行检查日志	技能自动诊断
适用版本	OpenClaw 2026.2.9+	所有版本
推荐度	⭐⭐⭐	⭐⭐⭐⭐⭐

---

环境准备

硬件要求

• 轻量应用服务器（阿里云）或任意 Linux/Mac 服务器
• 内存：≥2 GiB
• OpenClaw 版本：建议 2026.2.9 及以上

购买与部署（阿里云轻量应用服务器）

1. 登录阿里云轻量应用服务器控制台
2. 选择 应用镜像 → OpenClaw 镜像
3. 实例规格：内存 2GiB 以上
4. 完成购买后，在应用详情页获取：
   • OpenClaw WebUI 访问地址
   • 随机生成的端口号
   • 管理员 Token

端口放通（重要）

# 在阿里云控制台执行端口放通命令
# 或手动开放 OpenClaw 的随机端口

⚠️ 端口放通会使服务暴露于公网，使用后建议一键关闭 WebUI 公网访问。

---

安装 feishu-bot-config 技能（推荐）

📥 安装 feishu-bot-config 技能

你可以通过以下两种方式之一，将飞书自动化配置技能添加到 OpenClaw 中。

方式一：自动安装（最推荐，对话即完成）

这是最简单的方法。你只需要直接在 OpenClaw 的对话界面中，向 Agent 发送以下指令：

"请帮我从这个地址 https://github.com/70asunflower/my-skills/tree/main/feishu-bot-config 克隆并安装飞书配置技能到 skills 文件夹。"

Agent 会自动完成以下操作：

1. 解析指令：识别下载地址和目标文件夹。
2. 执行克隆 ：使用 git clone 命令将技能仓库下载到 OpenClaw 的 skills 目录。
3. 确认安装：安装完成后，Agent 会回复安装结果。

✅ 优势：无需手动操作命令，无需担心路径错误，全程由 Agent 自动完成。

方式二：手动安装（适用于自动方式失败或无网络环境）

如果自动安装方式不可用，可以按照以下步骤手动操作：

1. 进入技能目录 ：打开终端，进入 OpenClaw 的 skills 文件夹。

   cd ~/openclaw/skills   # 如果你的安装路径不同，请替换为实际路径

2. 克隆技能仓库 ：执行以下命令，将技能下载到 feishu-bot-config 文件夹中。

   git clone https://github.com/70asunflower/my-skills/tree/main/feishu-bot-config ./feishu-bot-config

   注意 ：如果提示 git 命令未找到，请先安装 Git。如果上述命令报错，可以尝试仅克隆整个仓库，再复制所需文件夹：

   git clone https://github.com/70asunflower/my-skills.git
   cp -r my-skills/feishu-bot-config .
   rm -rf my-skills

3. 验证安装 ：确保 ~/openclaw/skills/feishu-bot-config 文件夹存在，并且其中包含 skill.json 等文件。

安装完成后，即可按照文档后续步骤，使用该技能来自动化配置飞书机器人。

验证安装

在 OpenClaw 对话中发送：

列出已安装的技能

应能看到 feishu-bot-config 在列表中。

技能功能

功能	说明
自动配置	根据 App ID/Secret 自动生成配置
自动配对	解析配对码并执行 approve 命令
多 Agent 管理	支持为不同 Agent 配置独立机器人
状态诊断	检查配置、连接、权限问题
配置迁移	导出/导入飞书配置

---

创建飞书应用

步骤 1：创建应用

1. 访问 飞书开放平台
2. 点击 创建企业自建应用
3. 填写应用名称、描述，上传图标
4. 点击 创建

步骤 2：获取凭证

进入 凭证与基础信息 页面，复制：

• App ID （格式：cli_xxx）
• App Secret

步骤 3：配置权限

进入 权限管理 → 批量导入/导出权限，粘贴以下 JSON：
📋 完整权限配置（点击展开）

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "docs:document.content:read",
      "event:ip_list",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}

点击 下一步 → 确认新增权限 → 申请开通。

步骤 4：添加机器人能力

左侧导航栏 → 添加应用能力 → 机器人 → 配置

步骤 5：配置事件订阅（长连接）

1. 左侧导航栏 → 事件与回调
2. 订阅方式 → 选择 使用长连接接收事件 → 保存
3. 添加事件 → 搜索 im.message.receive_v1 → 确认添加

步骤 6：发布应用

1. 左侧导航栏 → 版本管理与发布
2. 点击 创建版本
3. 填写版本号（如 1.0.0）和更新说明
4. 保存并提交审核
5. 审核通过后发布

---

配置 OpenClaw（三种方式）

方式一：自动配置（推荐，需 feishu-bot-config 技能）

在 OpenClaw 对话中发送：

请帮我配置飞书机器人，App ID 是 cli_a945xxxxxxxxxxxxxxx，App Secret 是 1WovbkJPRxxxxxxxxxxxxxxx

Agent 会自动：

• 生成配置文件
• 设置必要的参数
• 返回配置结果

方式二：半自动配置（手动 + 技能辅助）

1. 手动创建配置文件 ~/.openclaw/channels/feishu.json：

{
  "enabled": true,
  "appId": "cli_xxx",
  "appSecret": "xxx",
  "connectionMode": "websocket",
  "dmPolicy": "pairing",
  "groupPolicy": "allowlist",
  "requireMention": true
}

2. 在对话中发送：

   请帮我验证飞书配置是否正确

方式三：纯手动配置（阿里云标准方式）

openclaw config set channels.feishu.appId "你的_app_id"
openclaw config set channels.feishu.appSecret "你的_app_secret"
openclaw config set channels.feishu.enabled true
openclaw config set channels.feishu.connectionMode websocket
openclaw config set channels.feishu.dmPolicy pairing
openclaw config set channels.feishu.groupPolicy allowlist
openclaw config set channels.feishu.requireMention true

openclaw gateway restart

配置参数说明

参数	说明	推荐值
enabled	是否启用飞书通道	true
appId	飞书应用 App ID	从飞书开放平台获取
appSecret	飞书应用 Secret	从飞书开放平台获取
connectionMode	连接模式	websocket（长连接）
dmPolicy	私聊策略	pairing（需配对）
groupPolicy	群聊策略	allowlist（白名单）
requireMention	是否需要 @	true

---

配对与验证

标准配对流程

步骤 1：发起对话

在飞书中搜索你的机器人，发送任意消息（如"你好"）。

步骤 2：获取配对码

机器人回复类似：

OpenClaw: access not configured.
Your Feishu user id: ou_5969847348fxxxxxxxxxxxxxxxxx
Pairing code: GFxxxxxx
Ask the bot owner to approve with:
openclaw pairing approve feishu GFxxxxxx

步骤 3：完成配对

自动方式（推荐）：将上述回复内容发送给 OpenClaw Agent：

机器人回复了以下内容，请帮我完成配对：
[粘贴机器人回复的完整内容]

手动方式：

openclaw pairing approve feishu GFxxxxxx

步骤 4：验证

再次向飞书机器人发送消息，应能得到正常回复。

通过终端命令配对（备用方案）

# 登录服务器后
# 查看待配对列表
openclaw pairing list feishu

# 批准配对
openclaw pairing approve feishu YXXX

群聊中使用

• 在群聊中需 @机器人 才能触发响应
• 首次在群聊中使用可能也需要配对（取决于 groupPolicy 设置）

---

多 Agent 管理

场景说明

当你配置了多个 Agent（如 work-agent、personal-agent、test-agent），每个 Agent 可以拥有独立的飞书机器人。

核心操作

1. 为新 Agent 配置飞书机器人

向已可用的 Agent 发送：

请帮我为 work-agent 配置飞书机器人，App ID 是 cli_work_xxxxx，App Secret 是 work_secret_xxxxx

2. 完成新 Agent 的配对

在飞书中向 work-agent 对应的机器人发送消息获取配对码，然后：

这是 work-agent 的配对码 GF12345，你帮我给 work-agent 配置一下

3. 查看所有 Agent 状态

列出所有 Agent 的飞书配置状态

4. 为特定 Agent 重新配对

请为 work-agent 重新配对，配对码是 GFnew12345

5. 删除某个 Agent 的配置

帮我移除 test-agent 的飞书机器人配置

6. 排查特定 Agent 的问题

请帮我排查 work-agent 的飞书机器人连接问题

管理技巧

技巧	说明
保留管理 Agent	建议保留一个 admin-agent 专门用于管理其他 Agent
命名规范	使用有意义的 Agent 名称，如 customer-service、data-analysis
权限隔离	每个 Agent 使用独立的飞书应用，互不干扰
批量配置	可一次性发送多个 Agent 的配置请求

批量配置示例

请帮我依次为以下 Agent 配置飞书机器人：
- agent_a: App ID cli_a_xxx, Secret a_xxx
- agent_b: App ID cli_b_xxx, Secret b_xxx
- agent_c: App ID cli_c_xxx, Secret c_xxx

---

定时任务与高级功能

创建定时任务

通过对话创建定时任务，并将结果发送到飞书群。

步骤 1：获取群机器人 Webhook

1. 在飞书群聊中点击 设置 → 群机器人
2. 点击 添加机器人 → 选择 自定义机器人
3. 填写名称和描述 → 添加
4. 复制 Webhook 地址

步骤 2：创建定时任务

在 OpenClaw 对话中：

每天早上8点查询北京天气，发送到 [Webhook地址]

步骤 3：测试任务

立即发送一条测试消息到 [Webhook地址]

步骤 4：修改或取消任务

把天气查询任务改成每天早上9点执行
取消天气查询任务

其他高级功能

功能	示例指令
定时提醒	每周五下午3点提醒我周报，发送到飞书
数据报表	每天早上10点发送昨日销售数据到飞书群
监控告警	当服务器CPU超过80%时，发送告警到飞书
内容推送	每天推送一条AI新闻到我的飞书私聊

---

常见问题排查

Q1: 机器人无响应

可能原因：

• OpenClaw 服务未运行
• 飞书配置未生效
• 长连接断开

排查方法：

请帮我检查飞书机器人连接状态

或手动检查：

openclaw status --deep
openclaw gateway restart

Q2: 配对失败，提示"没有待处理的配对请求"

解决方法：

# 查看当前配对请求
openclaw pairing list feishu

# 如果没有记录，重新向机器人发消息获取新配对码

Q3: 群聊中 @机器人 无响应

检查项：

• requireMention 是否为 true
• 群聊是否在白名单中（groupPolicy 设置）
• 机器人是否已被添加到群聊

Q4: 权限不足错误

解决方法：

1. 检查飞书应用是否已申请所有必要权限
2. 确认权限已生效（可能需要重新发布应用）
3. 在飞书开放平台重新授权

Q5: 多 Agent 配置混乱

排查方法：

请列出所有 Agent 的飞书配置详情

技能会返回每个 Agent 的：

• 配置文件路径
• App ID（脱敏）
• 配对状态
• 最后活跃时间

Q6: WebUI 无法访问

解决方法：

1. 检查防火墙是否放通 OpenClaw 端口
2. 确认 Token 是否正确
3. 尝试重启 OpenClaw 网关

---

命令速查表

配置管理

操作	命令/对话指令
自动配置	请帮我配置飞书机器人，App ID: xxx, Secret: xxx
查看状态	检查飞书机器人状态
重启网关	openclaw gateway restart
查看配置	openclaw config get channels.feishu

配对管理

操作	命令/对话指令
自动配对	这是配对码 GFxxx，帮我完成配对
查看配对列表	openclaw pairing list feishu
手动批准	openclaw pairing approve feishu GFxxx
取消配对	openclaw pairing revoke feishu

多 Agent 管理

操作	对话指令
为指定 Agent 配置	为 work-agent 配置飞书，App ID: xxx, Secret: xxx
查看所有 Agent	列出所有 Agent 的飞书配置状态
为指定 Agent 配对	这是 work-agent 的配对码 GFxxx，帮我配置
排查指定 Agent	检查 work-agent 的飞书连接
删除指定 Agent 配置	移除 test-agent 的飞书配置

定时任务

操作	对话指令
创建定时任务	每天早上8点[任务内容]，发送到 [Webhook]
测试任务	立即发送测试消息到 [Webhook]
修改任务	把[任务名]改成[新内容]
取消任务	取消[任务名]

故障排查

操作	命令/对话指令
深度状态检查	openclaw status --deep
查看日志	openclaw logs --tail 50
技能诊断	请诊断飞书机器人配置问题
重新加载配置	openclaw config reload

---

附录

文件结构

~/.openclaw/
├── channels/
│   └── feishu.json          # 飞书通道配置
├── skills/
│   └── feishu-bot-config/   # 飞书配置技能
│       ├── skill.json
│       ├── main.py
│       └── README.md
├── agents/
│   ├── default/              # 默认 Agent
│   └── work-agent/           # 其他 Agent
│       └── config.json
└── logs/
    └── openclaw.log

相关链接

• 阿里云官方文档
• feishu-bot-config 技能
• 飞书开放平台
• OpenClaw GitHub

安全建议

1. 保护 App Secret：不要提交到公开仓库
2. 保护配对码：配对码有效期有限，及时处理
3. 限制群聊权限 ：使用 groupPolicy: allowlist 限制可用的群聊
4. 定期轮换凭证：定期更换 App Secret
5. 关闭不必要的公网访问：使用后关闭 WebUI 公网访问

---

更新日志

日期	版本	更新内容
2026-04-03	2.0	整合 feishu-bot-config 技能，增加多 Agent 管理
2026-01-29	1.0	初始版本（阿里云官方文档）

---