OpenClaw 集成飞书机器人部署指南
OpenClaw 是一个开源智能体框架，支持通过插件扩展多平台交互能力。本文将演示如何将其接入飞书机器人，实现 AI 助手在 IM 场景下的落地。
环境准备
首先确保本地已安装 Node.js。可通过终端运行 node --version 验证版本。若需本地部署大模型，请注意显存需求：GLM-4.7 等模型对上下文长度支持较高，建议配备高性能显卡（如 RTX 4090），否则推理速度可能难以满足实时对话需求。
全局安装 OpenClaw：
npm install -g openclaw@latest
飞书应用配置
前往飞书开放平台创建应用，获取 App ID 和 App Secret。关键配置点如下：
- 事件订阅：将订阅方式改为长连接（WebSocket），并确保 OpenClaw 中 Channels 状态为 Enabled。
- 权限管理：添加以下权限以支持消息收发与用户信息读取：
(注：具体权限名称请以飞书官方文档为准)contact:contact(imessage) im:message(bot) contact:user.base:readonly im:resource - 发布：修改后创建并发布新版本，保持名称一致。
插件安装与配置
OpenClaw 默认可能未包含飞书插件，需手动安装。推荐优先尝试在线安装：
openclaw plugins install @m1heng-clawd/feishu
若网络受限或版本不兼容，可下载对应版本的 .tgz 包进行离线安装。安装依赖时如遇 spawn npm ENOENT 错误，请检查 Node.js 环境变量是否生效。
配置通道参数，替换实际密钥：
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
系统启动项过多时，建议在系统设置中管理相关开机任务，避免资源占用。
首次使用需在 Settings/Connection 中配置 Token。临时访问控制面板地址为：
http://<GATEWAY_ADDRESS>:<PORT>/__openclaw__//?token=YOUR_GATEWAY_TOKEN
本地默认访问地址通常为：
http://127.0.0.1:18789/__openclaw__/
令牌文件位于 ~/.openclaw/openclaw.json，可直接读取获取。
