基于 OpenClaw 部署飞书机器人实战

前置准备

在开始之前，请确保满足以下环境要求：

1. Node.js 环境：建议安装最新版 Node.js。Windows 用户可通过 winget 查找并安装（winget install OpenJS.NodeJS.LTS），安装后终端输入 node --version 和 npm --version 验证。
2. API 模型支持：OpenClaw 需要支持长上下文的 API，例如 GLM-4.7 或具备 200K token 能力的模型。
3. 本地部署注意：若选择本地部署大模型，对显存要求较高。以 RTX4090 为例，运行 200K 上下文需特定量化版本，且推理速度受硬件限制明显。若追求流畅体验，建议优先使用云端 API 服务。

飞书应用配置

1. 创建应用：访问飞书开放平台创建新应用，获取 App ID 和 App Secret。
2. 权限设置：在权限管理中添加以下范围：

   contact:contact(imessage)
   im:message
   bot
   contact:user.base:readonly
   im:resource
   

3. 回调配置：在'事件与回调'中将订阅方式改为长连接（WebSocket）。确保 OpenClaw 中 Channels 状态为 Enabled 和 OK 后再发布新版本。

插件安装与配置

安装方式

推荐直接使用 npm 安装官方插件，如遇依赖问题可参考手动方案：

openclaw plugins install @m1heng-clawd/feishu

若在线安装失败，可尝试下载最新版本的 tgz 包手动安装：

curl -O https://registry.npmjs.org/@m1heng-clawd/feishu/-/feishu-latest.tgz
openclaw plugins install ./feishu-latest.tgz

*注：如遇 spawn npm ENOENT 错误，请检查环境变量或手动安装依赖 @larksuiteoapi/node-sdk。

连接配置

将获取的凭证填入配置命令中：

openclaw config set channels.feishu.appId "YOUR_APP_ID"
openclaw config set channels.feishu.appSecret "YOUR_APP_SECRET"
openclaw config set channels.feishu.enabled true
openclaw config set channels.feishu.connectionMode websocket
openclaw config set channels.feishu.dmPolicy pairing
openclaw config set channels.feishu.groupPolicy allowlist
openclaw config set channels.feishu.requireMention true

启动与服务管理

使用 daemon 模式启动网关服务：

openclaw onboard --install-daemon openclaw gateway

默认情况下服务会随系统启动，建议通过系统工具检查并禁用不必要的开机自启项，以减少资源占用。

首次使用与访问

1. 配置密钥：在 Settings/Connection 中填入 Gateway Token。
2. 访问面板：浏览器打开 http://127.0.0.1:18789/__openclaw__/。
3. 临时访问：也可通过带 Token 的链接直接访问：

   http://<GATEWAY_ADDRESS>:<PORT>/__openclaw__/?token=YOUR_GATEWAY_TOKEN
   

4. 会话管理：在飞书对话框输入 /new 开启新会话。注意控制对话长度，避免超出 Token 限制导致中断。