打造你的家庭 AI 助手（二）：飞书机器人接入你的 OpenClaw
在上一篇文章中我们完成了 OpenClaw 的安装和基础配置。现在让我们把这只「小龙虾」接入飞书用手机就能远程控制你的 AI 助手。第一步在飞书开放平台创建应用1.1 进入飞书开放平台打开浏览器访问飞书开放平台https://open.feishu.cn/app?langzh-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 IDopenclaw config set channels.feishu.appId “你的App ID”设置 App Secretopenclaw 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必需 收取消息im.message.message_read_v1读取消息标记im.chat.member.bot.added_v1机器人被添加到群组im.chat.member.bot.deleted_v1机器人被从群组移除⚠️ 注意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 configsetproviderminimax# 或其他模型特别注意默认启用的minimax是国际版本的需要修改 ~/.openclaw/openclaw.json把baseUrl 替换成国内版本的APIhttps://api.minimaxi.com/anthropicmodels:{mode:merge,providers:{minimax:{baseUrl:https://api.minimaxi.com/anthropic,api:anthropic-messages,.......}}添加飞书技能openclaw skills install feishu-xxx至此你的 OpenClaw 已经成功接入飞书现在你可以随时在飞书中召唤你的 AI 助手让它帮你完成各种任务。有问题欢迎在评论区交流系列文章打造你的家庭 AI 助手一OpenClaw 安装与配置打造你的家庭 AI 助手二飞书机器人接入你的 OpenClaw
)
