OpenClaw 接入飞书官方插件完整指南(一步一步)

这篇是给“要能跑、要稳定、要少废话”的你。
风格一句话：先通链路，再谈丝滑。

0. 先讲清：官方插件 vs 社区插件

你看到的核心差异可以记成一句：

• 官方插件：强调“用户身份授权”能力，文档/消息/日历/多维表格操作更完整。

• 社区原插件：机器人模式够用，但很多时候要手动复制粘贴上下文。

粤语版总结：“一个系‘代你入场做嘢’，一个系‘喺门口帮你传话’。”

1) 前置检查（5分钟）

1.1 OpenClaw 版本

先看版本：

openclaw -v

建议版本：

• Linux/macOS：2026.2.26+

• Windows：2026.3.2+

低于建议版本就升级：

npm install -g openclaw

1.2 插件源（npm）

npm config set registry https://registry.npmjs.org

2) 飞书开放平台建应用（10-15分钟）

2.1 创建企业自建应用

• 打开：https://open.feishu.cn/app

• 点击：创建企业自建应用

• 填应用名、描述、图标

2.2 开启机器人能力

路径：应用能力 → 添加应用能力 → 机器人

2.3 获取凭证

路径：基础信息 → 凭证与基础信息

记下两项：

• App ID（cli_xxx）

• App Secret

3) 一次性导入权限（重点）

路径：开发配置 → 权限管理 → 批量导入/导出权限

把你准备好的完整 JSON 权限清单导入（你发的那份即可）。可以参考这个链接 所有权限也复制粘贴到页面https://separate-tellurium-a0b.notion.site/OpenClaw-31c9d69bbe658055b051c966f9996f34

经验：权限导少了，后面你会反复“补授权”，流程很断。
粤语：“一次过搞掂，唔好挤牙膏式开权限。”

4) 发布应用 + 事件订阅

4.1 发布版本

• 创建版本

• 填版本说明

• 确认发布

4.2 事件订阅（长连接）

• 订阅方式：长连接（WebSocket）

• 至少添加：接收消息事件（im.message.receive_v1）

• 若要卡片交互，也要配置卡片回调相关能力

5) 安装飞书官方插件（OpenClaw）

在终端执行：

openclaw gateway run

如果历史装过别的飞书插件，官方安装流程会自动做禁用切换。

验证插件状态：

openclaw plugins list

理想状态：

• feishu-openclaw-plugin = loaded

• 旧 feishu = disabled（若存在）

6) 配对绑定（首次私聊必经）

在飞书里给机器人发任意消息，拿到配对码（5分钟有效）。

然后终端执行：

openclaw pairing approve feishu <配对码> --notify

完成后你就能正常对话。

7) 授权与自检

在飞书聊天里可用：

• /feishu start：看插件版本与状态

• /feishu doctor：基础诊断

• /feishu auth：补全用户授权

一句让它学习能力边界的话：

“学习一下我安装的新飞书插件，列出有哪些能力。”

8) 常见问题（高频）

Q1：机器人收不到消息

先查三件事：

1. 应用已发布通过

2. 事件订阅是长连接且事件已加

3. 网关在跑

命令：

openclaw gateway status
openclaw logs --follow

Q2：群里不回

• 是否有 @机器人（默认常见策略是需要@）

• 群策略是否限制了 chat_id

Q3：配置乱了

/feishu doctor
feishu-plugin-onboard doctor
feishu-plugin-onboard doctor --fix

9) 一套“能复用”的最小验收清单

• 私聊发“1”，10秒内有回

• 群聊 @ 后稳定回

• 文档读取、消息检索、多维表写入至少各测一次

• 重启后仍可用：openclaw gateway restart 后复测通过

10) 粤语梗收尾（送你三句）

• “沉默是金”版：先看日志，唔好乱改。

• “海阔天空”版：链路一通，能力自然放大。

• “不再犹豫”版：先上最小可用，再慢慢加权限。

一句总诀：

“先稳阵，再丝滑；先跑通，再优雅。”