OpenClaw 集成飞书机器人部署指南

OpenClaw 是一款基于 Node.js 的智能体开发框架，支持通过插件扩展多平台能力。本文详细记录了将 OpenClaw 接入飞书机器人的完整流程，涵盖环境搭建、API 密钥配置及插件安装步骤。重点说明了本地部署对算力的要求，以及如何在飞书开放平台完成应用创建与长连接回调设置。通过配置网关与权限策略，可实现飞书会话与 AI 模型的无缝对接，适用于构建自动化办公助手或内部服务机器人。

HadoopMan发布于 2026/3/27更新于 2026/9/847 浏览

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，可直接读取获取。