OpenClaw + 飞书 搭建专属 AI 机器人
介绍如何使用 OpenClaw 结合飞书创建 AI 机器人。首先安装 Node.js 及 OpenClaw 工具,配置 AI 模型 API。接着在飞书开放平台创建企业自建应用,获取 App ID 和 Secret。随后将凭证写入 OpenClaw 配置并启动 Gateway。最后在飞书端授权配对,即可实现对话功能。流程涵盖环境准备、应用创建、权限配置及连接测试。

介绍如何使用 OpenClaw 结合飞书创建 AI 机器人。首先安装 Node.js 及 OpenClaw 工具,配置 AI 模型 API。接着在飞书开放平台创建企业自建应用,获取 App ID 和 Secret。随后将凭证写入 OpenClaw 配置并启动 Gateway。最后在飞书端授权配对,即可实现对话功能。流程涵盖环境准备、应用创建、权限配置及连接测试。

当前版本 OpenClaw(2026.2.22-2)已内置飞书插件,无需额外安装。
在飞书里直接跟 AI 对话,就像跟同事聊天一样自然。本文带你从零开始,用 OpenClaw 搭建一个飞书 AI 机器人。全程命令行操作,10 分钟搞定。
OpenClaw 依赖 Node.js 运行,首先确保你的 Node 版本不低于 22。
推荐使用 nvm 管理 Node 版本,打开终端执行:
# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
# 加载 nvm(避免重启终端)
. "$HOME/.nvm/nvm.sh"
# 安装 Node.js 24
nvm install 24
# 验证安装
node -v # 应输出 v24.13.1
npm -v # 应输出 11.8.0
📎 Node.js 官网:https://nodejs.org/en/download

进入 OpenClaw 官网 https://openclaw.ai/ ,我们通过 npm 全局安装:
# 安装 OpenClaw
npm i -g openclaw
# 运行引导向导(加 --install-daemon 安装守护进程,让 Gateway 在后台持续运行)
openclaw onboard --install-daemon
💡 加了
--install-daemon后,Gateway 会作为系统守护进程自动启动(macOS 用 LaunchAgent,Linux 用 systemd),重启电脑也不会丢。如果不加,后面启动openclaw gateway时关掉终端机器人就断了。
📎 GitHub 地址:https://github.com/openclaw/openclaw

OpenClaw 需要接入一个大语言模型作为'大脑'。你可以使用 Anthropic、OpenAI 等官方 API,也可以通过第三方中转服务获取。
这里以 Claude Haiku 为例。Haiku 是 Anthropic 的轻量级模型,响应快、成本低,非常适合日常对话场景。如果你需要更强的推理能力,也可以换成 claude-sonnet 或 claude-opus 等模型。
在终端依次执行以下命令:
# 1. 设置 API 地址
openclaw config set -- models.providers.my_api.baseUrl "你的 API 地址"
# 2. 设置 API 类型
openclaw config set -- models.providers.my_api.api "openai-completions"
# 3. 设置 API Key
openclaw config set -- models.providers.my_api.apiKey "你的 API 密钥"
# 4. 设置默认模型(可替换为其他模型)
openclaw config set -- agents.defaults.model.primary "my_api/claude-haiku-4-5-20251001"
⚠️ 注意:
config set和路径之间的--是两个英文半角短横线,不要从网页复制,手动敲键盘上的减号键两次。
如果你不习惯命令行,也可以通过 Dashboard 配置:
models.providers 部分,直接编辑 JSON💡 Dashboard 的 Form 表单视图对自定义 Provider 支持有限,建议直接用 Raw JSON 编辑器修改。
访问 https://open.feishu.cn/app ,如果没有账号,用手机号注册即可。
按照下图步骤操作:




创建完成后点击发布。
这两个值后面配置 OpenClaw 时要用到,务必保存好。

回到终端,将飞书应用的凭证写入 OpenClaw 配置:
# 设置飞书 App ID
openclaw config set -- channels.feishu.appId "你的 AppID"
# 设置飞书 App Secret
openclaw config set -- channels.feishu.appSecret "你的 AppSecret"
# 启动 OpenClaw Gateway
openclaw gateway
💡 新版 OpenClaw 已内置飞书支持,不需要额外安装插件。
回到飞书开放平台,为应用添加必要的权限和事件订阅。
在「权限管理」页面,搜索 im,将 im 相关的权限全部勾选(包括消息读取、发送、群组管理等),确保机器人能正常收发消息。
💡 OpenClaw 使用 WebSocket 模式连接飞书,不需要配置事件订阅的回调地址(Request URL),保持为空即可。



修改完权限后,需要重新发布一个版本,点击确认发布。

在手机飞书上给机器人发一条消息,你会收到类似这样的提示:
OpenClaw: access not configured. Your Feishu user id: ou_72c25a66a2248f494484a792b18d0c12 Pairing code: RYXBPRNJ Ask the bot owner to approve with: openclaw pairing approve feishu RYXBPRNJ
这是 OpenClaw 的安全机制,防止陌生人使用你的机器人。需要两步操作:
在终端中点击提示的链接,开启相关权限。


在终端执行配对命令,将你的飞书账号绑定为授权用户:
openclaw pairing approve feishu RYXBPRNJ
将
RYXBPRNJ替换为你实际收到的配对码。

⚠️ 每创建一个新的飞书机器人应用,都需要重新走一遍这个配对流程。
一切就绪,现在可以在飞书里愉快地和 AI 对话了 🎉


微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online
JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online
Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online