openclaw飞书机器人的配置指南

飞书 API 获取步骤：

第一步：创建飞书应用

1. 打开 飞书开放平台 → 开发者后台（open.feishu.cn）
2. 点击创建企业自建应用
3. 填写应用名称、描述，上传图标
4. 创建后，在应用信息里复制 App ID 和 App Secret

第二步：配置权限

在开放平台 → 你的应用 → 权限管理，开通以下权限：

第三步：配置事件订阅

在事件与回调中：

• 订阅事件：im.message.receive_v1
• 连接模式选 “长连接（WebSocket）”（推荐，无需公网地址）
• 如果选Webhook模式，需要填 verificationToken 和 encryptKey

第四步：发布应用

在版本管理与发布中，创建版本并提交审核（企业自建应用通常无需审核，直接发布）。

第五步：在 OpenClaw 中配置

最简单的方式是运行向导：

复制

openclaw channels login --channel feishu

选择 手动配置（Manual），然后输入：

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

完成后重启 Gateway：

方法1 是输入api进行，方法2是直接扫码

复制

openclaw gateway restart

手动配置示例（advanced）

复制

{  channels: {    feishu: {      accounts: {        default: {          appId: "cli_xxxxxxxxxxxxxxxx",          appSecret: "xxxxxx…xxxx",        },      },      dmPolicy: "pairing",  // 未知用户要先配对      groupPolicy: "allowlist",    },  },}

常见问题

Bot 不响应？

1. 确认应用已发布
2. 确认已添加 Bot 到群聊
3. 确认 WebSocket 模式已开启
4. 检查日志：openclaw logs --follow

App Secret 泄露？→ 在开发者后台重置 App Secret，然后更新配置

结合官方文档，几个容易踩坑的注意事项：

⚠️ 版本要求

• 需要 OpenClaw 2026.4.25 及以上
• 先确认版本：openclaw --version，太低则先升级 openclaw update

⚠️ 国内飞书 App 扫码问题

• QR 码方式创建 bot，国内飞书 App 经常没反应
• 解决：重新跑向导，选手动模式，自己创建应用并粘贴 App ID / App Secret

⚠️ 事件订阅配置

• 必须选 “长连接（WebSocket）”（默认），无需公网地址
• 选 Webhook 模式需要额外配置 verificationToken 和 encryptKey，更麻烦

⚠️ 权限未审批

• 开通权限后要创建版本并发布，权限才正式生效
• 自建应用通常无需审核，但没发布权限不会生效

⚠️ Bot 收不到群消息

• Bot 必须先被添加到群里才能收消息
• 群内默认需要 @mention 才响应（可通过配置关闭）
• 群组策略默认是 allowlist，新群要先在配置里加白名单

⚠️ DM 政策默认只允许机主

• dmPolicy: "allowlist"
  
   默认只有 bot 所有人能发消息
• 其他人发消息会没有响应，需要改为 pairing 或把用户 ID 加入 allowFrom

⚠️ App Secret 泄漏

• 一旦泄露，在开发者后台立刻重置 App Secret，同时更新 OpenClaw 配置并重启

⚠️ 多账号配置

• 如果有多个飞书 Bot，用 defaultAccount 指定默认账号
• 出站路由以默认账号为准

📋 快速检查清单

复制

□ OpenClaw 版本 ≥ 2026.4.25□ 飞书应用已发布□ 权限已开通（至少：im:message、im:chat）□ 事件订阅已开启（im.message.receive_v1）□ 连接模式选的是 WebSocket□ 群组：Bot 已被加入群聊□ DM：机主或已配对用户□ 完成后重启了 Gateway

• 如果你自己配置过程中卡住了，也可以留言交流。