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

1. 启动 Gateway 后，浏览器打开 http://127.0.0.1:18789/
2. 点击顶部 Config 标签页，切换到 Raw JSON 编辑器
3. 找到 models.providers 部分，直接编辑 JSON
4. 保存后 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 对话了 🎉

总结

整个流程主要包含以下步骤：

1. 装 OpenClaw：npm 一行命令搞定
2. 建飞书应用：拿到 App ID 和 Secret
3. 连起来：配置好模型和飞书凭证，启动 Gateway