使用 OpenClaw 与飞书搭建专属 AI 机器人
当前版本 OpenClaw（2026.2.22-2）已内置飞书插件，无需额外安装。
你有没有想过，在飞书里直接跟 AI 对话，就像跟同事聊天一样自然？
今天这篇文章，带你从零开始，用 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
📎 Node.js 官网：https://nodejs.org/en/download
1.2 安装 OpenClaw
进入 OpenClaw 官网 https://openclaw.ai/ ，我们通过 npm 全局安装：
# 安装 OpenClaw
npm install -g openclaw
# 运行引导向导（加 --install-daemon 安装守护进程，让 Gateway 在后台持续运行）
openclaw onboard --install-daemon
💡 加了
--install-daemon后，Gateway 会作为系统守护进程自动启动（macOS 用 LaunchAgent，Linux 用 systemd），重启电脑也不会丢。如果不加，后面启动openclaw gateway时关掉终端机器人就断了。
📎 GitHub 地址：https://github.com/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 创建企业自建应用
按照下图步骤操作：
创建完成后点击发布。
3.3 记录 App ID 和 App Secret
这两个值后面配置 OpenClaw 时要用到，务必保存好。
四、连接 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 的安全机制，防止陌生人使用你的机器人。需要两步操作：
6.1 开启权限
在终端中点击提示的链接，开启相关权限。
6.2 授权配对
在终端执行配对命令，将你的飞书账号绑定为授权用户：
openclaw pairing approve feishu RYXBPRNJ
将
RYXBPRNJ替换为你实际收到的配对码。
⚠️ 每创建一个新的飞书机器人应用，都需要重新走一遍这个配对流程。
七、开始使用
一切就绪，现在可以在飞书里愉快地和 AI 对话了 🎉
写在最后
整个流程总结下来就三件事：
- 装 OpenClaw：npm 一行命令搞定
- 建飞书应用：拿到 App ID 和 Secret
- 连起来：配置好模型和飞书凭证，启动 Gateway
如果你在部署过程中遇到问题，欢迎留言交流。
