使用 OpenClaw 在飞书搭建专属 AI 机器人

使用 OpenClaw 在飞书搭建专属 AI 机器人 | 极客日志

使用 OpenClaw 在飞书搭建专属 AI 机器人

当前版本 OpenClaw（2026.2.22-2）已内置飞书插件，无需额外安装。

本文将带你从零开始，使用 OpenClaw 搭建一个飞书 AI 机器人。全程命令行操作，约 10 分钟完成。

一、准备工作

1.1 安装 Node.js（版本 ≥ 22）

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

Node.js 下载页面

1.2 安装 OpenClaw

通过 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 官网

二、配置 AI 模型

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 配置：

启动 Gateway 后，浏览器打开 http://127.0.0.1:18789/
点击顶部 Config 标签页，切换到 Raw JSON 编辑器
找到 models.providers 部分，直接编辑 JSON
保存后 Gateway 自动热加载生效，无需重启

Dashboard 的 Form 表单视图对自定义 Provider 支持有限，建议直接用 Raw JSON 编辑器修改。

三、创建飞书应用

3.1 进入飞书开放平台

访问 https://open.feishu.cn/app ，如果没有账号，用手机号注册即可。

3.2 创建企业自建应用

按照下图步骤操作：

创建应用 - 步骤 1

创建应用 - 步骤 2

创建应用 - 步骤 3

创建应用 - 步骤 4

创建完成后点击发布。

3.3 记录 App ID 和 App Secret

这两个值后面配置 OpenClaw 时要用到，务必保存好。

App ID 和 App Secret

四、连接 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），保持为空即可。

权限配置 - 步骤 1

权限配置 - 步骤 2

权限配置 - 步骤 3

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

重新发布

六、首次使用：授权配对

在手机飞书上给机器人发一条消息，你会收到类似这样的提示：

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 的安全机制，防止陌生人使用你的机器人。需要两步操作：

6.1 开启权限

在终端中点击提示的链接，开启相关权限。

开启权限 - 步骤 1

开启权限 - 步骤 2

6.2 授权配对

在终端执行配对命令，将你的飞书账号绑定为授权用户：

openclaw pairing approve feishu RYXBPRNJ

将 RYXBPRNJ 替换为你实际收到的配对码。

配对成功

每创建一个新的飞书机器人应用，都需要重新走一遍这个配对流程。

七、开始使用

一切就绪，现在可以在飞书里愉快地和 AI 对话了。

使用效果

使用 OpenClaw 在飞书搭建专属 AI 机器人