飞书 × OpenClaw 接入教程

📊 流程总览

flowchart TD
subgraph "飞书开放网站"
A --> B
B --> C
C --> D
D --> E
end
subgraph "OpenClaw 侧"
F --> G
G --> H
end
E --> I{测试连接}
H --> I
I -->|成功| J
I -->|失败| K
K --> I

🔧 详细步骤

再看第一部分，飞书后台配置

Step 1️⃣ 创建应用

1. 打开 飞书开放网站
2. 点击「创建公司自建应用」
3. 填写应用名称、描述、图标
4. 创建完成后进入应用详情页

Step 2️⃣ 开启机器人能力

应用能力 → 机器人 → 开启 → 填写机器人名称

Step 3️⃣ 配置权限

进入「权限管理」→「批量导入」，粘贴以下 JSON：

{ "scopes": { "tenant": }}

Step 4️⃣ 配置事件订阅

事件与回调 → 事件配置

1. 请求方式选择「使用长连接接收事件」✅
2. 添加事件搜索并添加 im.message.receive_v1

flowchart LR
A --> B
B --> C
B --> D

Step 5️⃣ 记录凭证

进入「凭证与基础信息」，复制：

• App IDcli_xxxxxxxxxx
• App Secret

第二部分的观点是，OpenClaw 配置

Step 6️⃣ 安装飞书插件

# 检查插件是否已安装openclaw plugins list | grep feishu# 如未安装，执行安装openclaw plugins install @openclaw/feishu

Step 7️⃣ 配置凭证

编辑配置文件 ~/.openclaw/openclaw.json在 env 部分添加：

{ "env": { "FEISHU_APP_ID": "cli_xxxxxxxxxx","FEISHU_APP_SECRET": "你的AppSecret" }}

或通过环境变量启动网关：

FEISHU_APP_ID=cli_xxx FEISHU_APP_SECRET=xxx openclaw gateway

Step 8️⃣ 重启网关

openclaw gateway restart# 看日志确认连接openclaw logs --follow | grep feishu

从成功标志来看。

 Starting WebSocket long-connection... WebSocket client started 

至于第三部分，发布与测试

Step 9️⃣ 发布应用

版本管理与发布 → 创建版本 → 填写更新说明 → 发布

Step 10️⃣ 测试连接

1. 打开飞书 App
2. 搜索你的机器人名称
3. 发送「你好」测试
4. 收到回复即成功 🎉

🔍 常见问题排查

flowchart TD A --> B{检查网关日志} B -->|无 feishu 日志| C B -->|有连接日志| D{检查飞书后台} D --> E D --> F D --> G C --> H E -->|未配置| I F -->|未发布| J G -->|未添加| K

问题 ：搜不到机器人

• 检查应用是否已发布上线
• 检查应用可用范围是否包含自己

问题 ：机器人不回复

• 查看 openclaw logs | grep feishu
• 确认事件订阅已配置
• 确认 im.message.receive_v1 事件已添加

问题 ：收到配对码

执行以下命令批准配对：

openclaw pairing approve feishu <配对码>

📁 相关文件

文件方法说明主配置~/.openclaw/openclaw.json凭证和渠道配置插件目录~/.openclaw/extensions/feishu/飞书插件源码日志文件/tmp/openclaw/openclaw-YYYY-MM-DD.log运行日志

🔗 参考链接

• 飞书开放网站
• OpenClaw 文档
• 飞书机器人开发教程

©八佰 | --

。

---