使用 OpenClaw 在飞书搭建专属 AI 机器人
介绍如何使用 OpenClaw 结合飞书搭建专属 AI 机器人。主要步骤包括:安装 Node.js 环境及 OpenClaw 工具;配置大语言模型 API;在飞书开放平台创建企业自建应用并获取凭证;将飞书凭证写入 OpenClaw 配置并启动 Gateway;最后在飞书中授权配对完成连接。全程命令行操作,支持守护进程运行,实现自然对话交互。

介绍如何使用 OpenClaw 结合飞书搭建专属 AI 机器人。主要步骤包括:安装 Node.js 环境及 OpenClaw 工具;配置大语言模型 API;在飞书开放平台创建企业自建应用并获取凭证;将飞书凭证写入 OpenClaw 配置并启动 Gateway;最后在飞书中授权配对完成连接。全程命令行操作,支持守护进程运行,实现自然对话交互。

当前版本 OpenClaw(2026.2.22-2)已内置飞书插件,无需额外安装。
本文将带你从零开始,使用 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
参考文档:https://nodejs.org/en/download

通过 npm 全局安装 OpenClaw:
# 安装 OpenClaw
npm i -g openclaw
# 运行引导向导(加 --install-daemon 安装守护进程,让 Gateway 在后台持续运行)
openclaw onboard --install-daemon
添加 --install-daemon 后,Gateway 会作为系统守护进程自动启动(macOS 用 LaunchAgent,Linux 用 systemd),重启电脑也不会丢失服务。如果不加,关闭终端后机器人会断开。
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 部分,直接编辑 JSONDashboard 的 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
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML 转 Markdown 互为补充。 在线工具,Markdown 转 HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML 转 Markdown在线工具,online