OpenClaw 飞书机器人部署笔记

OpenClaw 项目资源

• GitHub 仓库：https://github.com/openclaw/openclaw
• 官方文档：https://docs.openclaw.ai/
• 飞书插件：https://www.npmjs.com/package/@m1heng-clawd/feishu
• GLM 模型官方 API：https://bigmodel.cn/glm-coding

一、安装 OpenClaw

前置要求

1. 需要 GLM-4.7 API，或者支持 200K token 的模型接口；
2. 如果打算本地跑大上下文，硬件门槛不低。文档里给出的可行组合是 RTX4090-48G 配合 GLM-4.7-flash-Q4，我会把它当成'能试，但别先乐观'的参考；
3. 先装好 Node.js。Windows 可以用 winget 找下载入口，装完后用 npm --version 和 node --version 确认环境没问题。

安装命令

npm install -g openclaw@latest 

二、飞书机器人配置

1. 去飞书开放平台创建应用，拿到 App ID 和 App Secret；
2. 配置时先把机器人加进去并命名；
3. 在'事件与回调'里把订阅方式改成长连接。这个地方要看 OpenClaw 里的 Channels 状态，得是 Enabled 和 OK，没连上通常不是飞书那边单点问题；
4. 改完后重新创建并发布一个新版本，名称保持一致就行。

使用时有两点比较实在：权限提示可以直接复制到飞书平台，让它自己识别；机器人发到飞书后，在对话框里输入 /new 能新建会话，但别把上下文拉得太长，不然 token 很快就顶满了。

权限管理中添加以下权限：

contact:contact(imessage(botcontact:user.base:readonlyim:resource)

三、飞书插件安装

先看 OpenClaw 官方信息，确认最新版本是否已经内置飞书支持。能省掉手动装插件就省掉，后面排错会少很多。

Windows 10/11 如果碰到 spawn npm ENOENT，一般是环境里找不到 npm。可以先补依赖：

cd C:\Users\Administrator\.openclaw\extensions\feishu
npm install @larksuiteoapi/node-sdk 

再安装插件：

openclaw plugins install ./feishu-0.1.4.tgz 

如果安装结果里提示缺依赖，就按上面的依赖命令补一下。在线安装不通的时候，回到官方文档手动装，通常比继续硬顶更省时间。

下载最新版本时，先去插件官网确认版本号，再替换下面链接里的版本。别直接拿旧包用，兼容性问题往往出在这里：

curl -O https://registry.npmjs.org/@m1heng-clawd/feishu/-/feishu-0.1.4.tgz