OpenClaw 保姆级教程 04-夜雨聆风

OpenClaw 保姆级教程 04

飞书接入指南：让 AI 机器人在群聊中陪你聊天

│ 导读：上一篇我们在终端里和 AI 对话了。这一篇，把它接入飞书。以后在群里@它，它就能秒回。全程约 10 分钟，跟着走就行。

🚀开篇

OpenClaw 支持多种渠道接入，飞书是最常用的之一。

接入原理很简单：

• 在飞书开放平台创建一个机器人应用

• 配置权限和事件订阅

• 把 App ID/Secret 填进OpenClaw

• 在飞书里@机器人，它就能干活了

📱 01 创建飞书应用

打开飞书开放平台：https://open.feishu.cn

点击“创建应用“，填写应用名称和描述（随便填，比如“我的 AI 助理“）。

创建成功后，进入应用详情页，记录两个关键信息：

• App ID（应用凭证）

• App Secret（应用密钥）

│ ⚠️ 注意：App Secret 只显示一次，务必复制保存。丢了只能重置。

🔐 02 配置权限

在应用详情页，进入“权限管理“，开启以下权限：

权限名称	说明
im:message	获取与发送单聊、群聊消息
im:message.group_at_msg:readonly	接收群聊中@机器人的消息
im:chat	获取群信息

配置完后，点击“批量开通“或手动逐个开通。

🔔 03 配置事件订阅

进入“事件订阅“页面，配置以下内容：

• 请求地址：留空（OpenClaw 使用长连接模式，不需要公网 URL）

• 订阅事件：添加“接收消息im.message.receive_v1″

启用“长连接“模式（WebSocket），这样不需要公网服务器也能接收消息。

│ 💡 提示：长连接模式适合个人/小团队使用。如果企业级部署，建议使用 Webhook + 公网域名。

⚙️ 04 接入 OpenClaw

回到终端，运行以下命令添加飞书渠道：

┌── bash ──openclaw channels add feishu└──────────────

向导会提示你输入：

• App ID

• App Secret

• Encryption Secret（加密密钥，可选）

• Verification Token（验证令牌，可选）

输入完成后，OpenClaw 会自动建立长连接。

验证连接状态：

┌── bash ──openclaw status└──────────────

看到 Feishu 渠道显示“Connected”，就说明接入了。

💬 05 在飞书里测试

打开飞书，找到你的机器人（或在群里@它），发送：

“你好，我是测试消息。“

如果机器人回复了，恭喜你，接入成功！

现在你可以在群里@它，让它帮你：

• 整理会议纪要

• 查询资料

• 翻译文档

• 自动化重复任务

🔧 06 常见问题速查

症状	排查建议
机器人不回复	检查事件订阅是否开启，权限是否授予
长连接断开	检查网络，重启 openclaw gateway
权限不足报错	回飞书开放平台补全权限，重新发布应用
消息延迟	长连接模式偶有延迟，可尝试 Webhook

📌 07 本部分小结

来，回顾一下今天的成果：

• ✅ 创建了飞书应用（记录 App ID/Secret）

• ✅ 配置了权限和事件订阅

• ✅ 接入了 OpenClaw（长连接模式）

• ✅ 在飞书里成功对话！

现在，你的 AI 助理已经住进飞书了。下一篇，我们给它加上安全防护，防止它乱回消息。

🎯领取步骤（30 秒搞定）

1️⃣点击文章顶部「关注」本号（程大虾）

2️⃣后台发送关键词【保姆级教程 04】保姆级教程04.pdf

3️⃣收到小程序链接，点击直接下载（无需登录/解压）

📚教程目录

📌 收藏本篇，随时回顾🔔 关注我，获取后续教程更新