OpenClaw 终于支持飞书

10 分钟让 🦞 接入飞书

不需要公网 IP，不需要回调地址，WebSocket 长连接搞定一切。

官方通道插件

OpenClaw今日更新2026.2.2版本通道新增飞书支持。

飞书插件优势亮点：

• • WebSocket 长连接：不需要公网 IP，不需要配置回调地址
• • 消息类型丰富：文本、图片、文件、音频、视频都支持
• • 流式卡片：支持打字机效果，体验更好
• • 权限灵活：私聊、群聊策略可分别配置

适合内网部署、家庭服务器、没有固定公网 IP 的场景。

整体流程

安装插件 → 创建飞书应用 → 配置权限 → 启用机器人 → 配置事件 → 发布应用 → 配置 OpenClaw → 启动

大约 10 分钟完成。

一、安装飞书插件

openclaw plugins install @openclaw/feishu

安装完成后，可以用向导配置：

openclaw onboard

或者手动配置：

openclaw channels add

选择 Feishu，按提示输入 App ID 和 App Secret。

二、创建飞书应用

2.1 登录开放平台

• • 飞书：https://open.feishu.cn/app
• • Lark（国际版）：https://open.larksuite.com/app

2.2 创建应用

1. 1. 点击「创建企业自建应用」
2. 2. 填写应用名称和描述
3. 3. 记录 App ID（格式：cli_xxx）和 App Secret

三、配置权限

在「权限管理」页面，点击「批量开通」，粘贴以下 JSON：

{  "scopes": {    "tenant": [      "im:message",      "im:message:send_as_bot",      "im:message.p2p_msg:readonly",      "im:message.group_at_msg:readonly",      "im:message:readonly",      "im:resource",      "im:chat.members:bot_access",      "im:chat.access_event.bot_p2p_chat:read"    ],    "user": [      "im:chat.access_event.bot_p2p_chat:read"    ]  }}

可选：流式卡片权限

如果想要打字机效果（推荐），额外添加：

效果对比：

• • 有此权限：回复显示为卡片，支持实时更新
• 
• • 无此权限：回复显示为普通文本

四、启用机器人

在「应用能力」→「机器人」中：

1. 1. 启用机器人能力
2. 2. 设置机器人名称

五、配置事件订阅

⚠️ 最容易漏的配置！收不到消息就检查这里。

前提：确保 Gateway 正在运行。

openclaw gateway status

在「事件与回调」中：

1. 1. 选择「使用长连接接收事件」（WebSocket 模式）
2. 2. 添加事件：im.message.receive_v1

如果 Gateway 未运行，长连接配置可能无法保存。

六、发布应用

1. 1. 在「版本管理与发布」创建版本
2. 2. 提交审核并发布
3. 3. 等待管理员审批（企业自建应用通常自动通过）

七、配置 OpenClaw

方式一：配置文件

编辑 ~/.openclaw/openclaw.json：

{  "channels": {    "feishu": {      "enabled":true,      "accounts": {        "main": {          "appId": "cli_xxx",          "appSecret": "xxx"        }      }    }  }}

方式二：环境变量

export FEISHU_APP_ID="cli_xxx"export FEISHU_APP_SECRET="xxx"

八、启动并验证

# 启动 Gatewayopenclaw gateway start# 查看状态openclaw gateway status# 查看日志openclaw logs --follow

在飞书中找到你的机器人，发送一条消息测试。

九、访问控制

私聊策略

审批配对：

openclaw pairing list feishuopenclaw pairing approve feishu <CODE>

群聊策略

默认需要 @机器人 才会响应。可按群配置取消：

{  "channels": {    "feishu": {      "groups": {        "oc_xxx": { "requireMention":false }      }    }  }}

十、故障排查

收不到消息

1. 1. 确认应用已发布并审批通过
2. 2. 确认事件订阅包含 im.message.receive_v1
3. 3. 确认使用「长连接」模式
4. 4. 确认 Gateway 正在运行

openclaw gateway statusopenclaw logs --follow

群里不响应

1. 1. 确认机器人已加入群
2. 2. 确认 @提及了机器人
3. 3. 确认 groupPolicy不是 disabled

消息显示为普通文本

缺少 cardkit:card:write权限。添加后需重新发布应用。

十一、常用命令速查

总结

飞书配置的核心步骤：

1. 1. 安装插件：openclaw plugins install @openclaw/feishu
2. 2. 创建应用：获取 App ID 和 App Secret
3. 3. 配置权限：批量导入 JSON
4. 4. 启用机器人：开启机器人能力
5. 5. 配置事件：选择长连接 + 添加 im.message.receive_v1
6. 6. 发布应用：提交审核
7. 7. 配置 OpenClaw：填入凭证
8. 8. 启动验证：openclaw gateway start

容易踩坑：忘记配置事件订阅，或者 Gateway 没启动就配置长连接。

参考文档：https://docs.openclaw.ai/zh-CN/channels/feishu