打造你的家庭 AI 助手（二）：飞书机器人接入你的 OpenClaw

在上一篇文章中，我们完成了 OpenClaw 的安装和基础配置。现在，让我们把这只「小龙虾」接入飞书，用手机就能远程控制你的 AI 助手。

第一步：在飞书开放平台创建应用

1.1 进入飞书开放平台

打开浏览器，访问飞书开放平台：https://open.feishu.cn/app?lang=zh-CN

使用你的飞书账号登录。

1.2 创建企业自建应用

找到页面右上角的「创建应用」按钮，点击后填写：
应用名称：OpenClaw（或其他你喜欢的名字）
应用描述：家庭 AI 助手
创建完成后，进入应用管理页面。

1.3 获取 App ID 和 App Secret

在左侧菜单找到「凭证与基础信息」，你会看到：
App ID：复制并保存
App Secret：复制并保存
这两个值在后续配置中会用到。

第二步：配置应用权限

这是最容易踩坑的一步。在左侧找到「权限管理」，点击「开通权限」，搜索并开通以下权限：

必选权限：
im:message- 发送和接收消息
im:chat:readonly- 只读聊天信息
im:chat:update- 更新聊天信息
事件订阅权限：
im:message.receive_v1- 接收消息事件
im:message.message_read_v1- 消息已读事件
im:chat.member.bot.added_v1- 机器人被添加到群组
im:chat.member.bot.deleted_v1- 机器人被从群组移除
配置完成后，在「版本管理与发布」页面创建版本并发布。

第三步：为 OpenClaw 安装飞书插件

打开终端，输入以下命令安装飞书插件：
openclaw plugins install @m1heng-clawd/feishu

等待 1-2 分钟，插件会自动下载并安装。

第四步：配置 OpenClaw 连接飞书

在终端中执行以下命令，将你的飞书应用凭证告诉 OpenClaw：

设置 App ID

openclaw config set channels.feishu.appId “你的App ID”

设置 App Secret

openclaw config set channels.feishu.appSecret “你的App Secret”

启用飞书频道

openclaw config set channels.feishu.enabled true

第五步：重启 OpenClaw 网关

为了让配置生效，重启网关：
openclaw gateway restart

重启后，打开 OpenClaw 网页端，看到「Feishu」选项即表示插件安装成功。

第六步：配置飞书事件回调

这一步是连接成功的关键。

6.1 设置事件接收方式

回到飞书开放平台，进入你的应用设置，在「事件配置」或「事件与回调」页面：
选择「长链接」作为接收事件的方式
点击保存

6.2 添加事件订阅

在事件配置页面，点击「添加事件」，添加以下事件：

⚠️ 注意：im.message.receive_v1是最关键的事件，没有它机器人根本收不到消息！

所有事件添加完成后，点击保存。

6.3 发布新版本

因为我们修改了配置，需要重新发布：
回到「版本管理与发布」页面
点击「创建版本」
点击「发布」

这一步非常重要，不发布的话，你的事件配置改动不会生效。

第七步：验证连接

配置完成后，验证飞书机器人是否正常工作：
打开飞书客户端（手机或电脑端均可）
在搜索栏搜索「OpenClaw」或你给应用起的名字
点击搜索结果中的机器人，点击「添加到」
打开与 OpenClaw 的对话窗口
发送一条消息测试，比如：「你好，请帮我查询一下天气」
如果机器人能够正常回复，说明飞书接入成功！

常见问题排查

Q：机器人收不到消息？
检查im.message.receive_v1事件是否已添加
检查应用是否已发布新版本
检查 OpenClaw 网关是否在运行
Q：显示「机器人已暂停」？
回到飞书开放平台，检查应用状态
确保应用已发布且在审核通过状态
Q：配置正确但无法连接？
检查 App ID 和 App Secret 是否正确
重启 OpenClaw 网关：openclaw gateway restart

进阶配置（可选）

更换 AI 模型

可以切换到其他国内模型（如 MiniMax、Kimi 等）：

openclaw configsetprovider"minimax"# 或其他模型

特别注意默认启用的minimax是国际版本的，需要修改 ~/.openclaw/openclaw.json，把baseUrl 替换成国内版本的API：https://api.minimaxi.com/anthropic

"models":{"mode":"merge","providers":{"minimax":{"baseUrl":"https://api.minimaxi.com/anthropic","api":"anthropic-messages",.......}}

添加飞书技能

openclaw skills install feishu-xxx

至此，你的 OpenClaw 已经成功接入飞书！现在你可以随时在飞书中召唤你的 AI 助手，让它帮你完成各种任务。

有问题欢迎在评论区交流～

系列文章：
打造你的家庭 AI 助手（一）：OpenClaw 安装与配置
打造你的家庭 AI 助手（二）：飞书机器人接入你的 OpenClaw