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 对模型上下文长度有一定需求，建议优先使用支持 200K token 的 API 模型（如 GLM-4.7）。
关于本地部署，如果你打算跑大上下文任务，硬件门槛较高。以 RTX 4090-48G 显卡配合 GLM-4.7-flash-Q4 版本为例，实测 200K 上下文下速度约为 20 token/s。这意味着处理一次 10 万 token 的任务大约需要 80 分钟。如果追求效率，建议至少保证 200 token/s 的速度，这样单次任务可控制在 8 分钟左右，否则频繁开启新会话会影响体验。
开发环境方面，请确保已安装 Node.js。Windows 用户可通过 winget show --id OpenJS.NodeJS 查找最新链接，或在终端管理员模式下运行 npm --version 和 node --version 验证安装。
全局安装命令如下：
npm install -g openclaw@latest
飞书机器人配置
这一步是打通飞书的关键。首先访问飞书开放平台创建应用，获取 App ID 和 App Secret。
- 添加机器人：命名后进入事件与回调设置。
- 订阅方式：务必将两处订阅方式改为长连接模式。注意检查 OpenClaw 中 Channels 状态是否为 Enabled 和 OK。
- 发布版本：修改后需创建并发布新版本，保持名称一致。
权限管理部分，需要在插件网站或飞书后台添加以下权限：
contact:contact（全部） im:message（全部） bot（全部） contact:user.base:readonly im:resource
实际使用中，遇到权限提示可直接复制到飞书平台自动识别。在对话框输入 /new 即可创建新会话，注意不要长时间连续对话，以免超出 Token 限制。
飞书插件安装
虽然新版 OpenClaw 可能内置了飞书支持，但手动安装插件通常更灵活。
Windows 手动安装
如果遇到 spawn npm ENOENT 错误，可以尝试手动安装依赖：
cd C:\Users\Administrator\.openclaw\extensions\feishu
npm install @larksuiteoapi/node-sdk
随后安装插件包：
openclaw plugins install ./feishu-0.1.4.tgz
若在线安装失败，说明官方尚未完全支持，此时需参考官方文档手动操作。下载最新版本时，请确保版本号与你的 OpenClaw 版本兼容，避免不匹配问题。
推荐方式
在 Ubuntu 或 Windows WSL2 环境下，直接安装更为便捷：
openclaw plugins install @m1heng-clawd/feishu
配置并启动服务
完成插件安装后，需要配置飞书连接信息。通过 CLI 设置环境变量，包括 App ID、Secret 以及连接模式等：
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
启动网关服务：
openclaw onboard --install-daemon openclaw gateway
默认情况下，系统会尝试开机自启。建议根据实际需求管理系统启动项，避免不必要的后台占用。
首次使用与访问
首次运行时需在 Settings/Connection 中配置 Token。临时访问方式如下：
http://<GATEWAY_ADDRESS>:<PORT>/__openclaw__/?token=YOUR_GATEWAY_TOKEN
控制面板默认地址为：
http://127.0.0.1:18789/__openclaw__/
如需获取访问令牌，可查看配置文件：
cat ~/.openclaw/openclaw.json
至此，基础环境搭建完毕。后续可根据业务需求调整模型参数或扩展其他渠道。