在 Node 模式下接入飞书,和 WSL 环境在安装插件这一步是完全一样的,都用 openclaw plugins install 这个命令。唯一的区别在于,配置完成后,你需要确保受信任的根证书列表是最新的(比如以管理员身份运行一次 node -e "require('https').globalAgent.options.ca = require('tls').rootCertificates"),以避免潜在的本地根证书过期导致的连接失败;而 WSL 环境通常不会出现这个问题。
🛠️ 第一步:在飞书开放平台创建应用并获取凭证
- 登录并创建 :访问飞书开放平台,用管理员账号登录后,创建一个"企业自建应用"。
- 获取凭证 :创建完成后,在"凭证与基础信息 "页面,你将看到
App ID和App Secret,记录下这两个信息。 - 添加机器人能力 :在应用的"应用能力 "页面,添加"机器人"能力。
- 配置权限 :在"权限管理 "页面,确保开启以下核心权限:
im:message(获取与发送单聊、群组消息)im:message.group_at_msg:readonly(读取群聊 @ 机器人的消息)im:message.p2p_msg:readonly(读取用户发给机器人的单聊消息)im:message:send_as_bot(以应用身份发送消息)im:resource(获取与上传图片或文件资源,按需开启)
- 发布应用 :在"版本管理与发布 "页面,创建一个新版本并发布。注意 :应用必须是"已发布"状态,飞书插件才能正常连接,否则插件启动会失败。
- 配置事件回调(关键步骤) :在插件的 App ID/Secret 配置完成并重启 Gateway 之后,你需要回到飞书开放平台的"事件与回调 "页面,订阅
im.message.receive_v1事件,并选择"使用长连接接收事件"。
⚙️ 第二步:在 PowerShell 中安装飞书插件
-
安装插件 :在管理员 PowerShell 中运行下面命令,安装社区中最常用的插件。任选其一即可:
powershell# 官方推荐插件 openclaw plugins install openclaw-feishu # 或社区流行插件 openclaw plugins install @overlink/openclaw-feishu # 推荐:第三个脚本 npx -y @larksuite/openclaw-lark@2026.4.7 install --version 2026.4.7 --tools-version 1.0.37 备注:鼠标移到Windows PowerShell标题栏点击右键,点击属性,在弹出的窗口上方点击字体栏,选择最上面的第一个英文字体MS Gothic就行了。 -
编辑配置 :在管理员 PowerShell 中运行
notepad "$env:USERPROFILE\.openclaw\openclaw.json"。在配置文件中找到或创建channels和plugins字段,并填入以下配置:json"channels": { "openclaw-feishu": { "enabled": true, "appId": "cli_你的AppID", "appSecret": "你的AppSecret" } }, "plugins": { "entries": { "openclaw-feishu": { "enabled": true } } }注意 :将
cli_你的AppID和你的AppSecret替换为你在第一步中获取的真实凭证。appId格式类似cli_xxxxxxxx,请务必确保填写正确。保存并关闭文件。
-
重启并验证 :在 PowerShell 中依次运行以下命令,重启 Gateway 使配置生效,并检查状态:
powershellopenclaw gateway restart openclaw channels status openclaw-feishu如果状态显示为
ON和OK,则表明插件已成功运行。
💡 如何选择插件?
目前社区中有多个飞书插件可选,以下是对比:
| 插件名称 (npm 包名) | 主要特点 | 推荐场景 |
|---|---|---|
openclaw-feishu |
官方维护,功能全面,支持多账号 | 大多数用户的默认首选 |
@overlink/openclaw-feishu |
支持飞书/Lark双版本,WebSocket/Webhook双模式,富媒体和文件处理强大 | 需要同时接入国内/国际版或对文件处理有高要求 |
feishu-openclaw |
轻量级,安装简单 | 对配置要求不高的简单场景 |
如无特殊需求,可从 openclaw-feishu 开始使用。
💎 总结
- 核心步骤 :就是"安装插件→配置凭证→重启→配置事件"这四个步骤。
- 平台通用 :这里的
openclaw plugins install命令在所有支持 Node.js 的平台上通用(Windows/macOS/Linux),你无需担心环境差异。 - 重启生效 :每次修改
openclaw.json配置文件后,必须重启 Gateway 才能生效 (openclaw gateway restart)。