OpenClaw 飞书机器人配置指南

10 分钟搞定企业 AI 助手 🦞

大家好呀！我是古吉怪～今天给大家带来超实用的 OpenClaw 飞书机器人配置教程！配置完成后，你的飞书里就会有一个随叫随到的 AI 助手啦！✨

🎯 配置前准备

在开始之前，请确保你已经：

✅ 安装了 OpenClaw✅ 有飞书管理员权限✅ 准备好 10 分钟时间  

📝 第一步：添加飞书渠道

方式一：交互式添加（推荐新手）

openclaw channels add

然后根据提示选择 Feishu，输入 App ID 和 App Secret 就 OK 啦！

方式二：命令行添加（老手专用）

openclaw config set channels.feishu.appId "<App_ID>"openclaw config set channels.feishu.appSecret "<App_Secret>"openclaw config set channels.feishu.enabled trueopenclaw config set channels.feishu.connectionMode websocketopenclaw gateway restart

🏗️ 第二步：创建飞书应用

1️⃣ 访问飞书开放平台

• 国内版：https://open.feishu.cn/app^[1]
• 国际版：https://open.larksuite.com/app^[2]

2️⃣ 创建企业自建应用

点击 创建应用 → 企业自建应用，填写名称和描述～

3️⃣ 启用机器人能力

在 添加应用能力 > 机器人 页面：

• ✅ 开启机器人能力
• ✅ 配置机器人头像和名称

4️⃣ 配置权限（关键步骤！）

在 权限管理 页面，点击 批量导入，粘贴以下 JSON：

{"scopes":{"tenant":["im:message","im:message.p2p_msg:readonly","im:message.group_at_msg:readonly","im:message:send_as_bot","im:resource","contact:contact.base:readonly"],"user":["im:message:readonly","im:chat:read","drive:file:download","drive:file:upload","docx:document:readonly","docx:document:write_only"]}}

💡 提示：上面是精简版权限，够用就好！如果需要更多功能，可以添加完整权限包～

5️⃣ 获取凭证

回到 凭证与基础信息 页面，复制这两项：

• 🔑 App ID
• 🔐 App Secret

🔔 第三步：配置事件订阅

⚠️ 重要前提

确保已完成：

1. ✅ 运行了 openclaw channels add
2. ✅ 网关已启动（openclaw gateway status 检查）

配置步骤

1. 进入 事件订阅 页面
2. 选择 使用长连接接收事件（WebSocket 模式）
3. 添加事件：im.message.receive_v1
4. 保存配置

⚠️ 如果网关没启动，长连接会保存失败哦！

🚀 第四步：发布应用

1. 进入 版本管理与发布 页面
2. 创建新版本
3. 提交审核并发布
4. 等待审批（企业自建应用通常秒过）

🔐 第五步：配对授权

1️⃣ 发送测试消息

在飞书中找到你的机器人，发一条消息～

2️⃣ 获取配对码

机器人会回复一个配对码

3️⃣ 批准配对

openclaw pairing approve feishu <配对码>

4️⃣ 开始对话

批准后就可以和 AI 助手正常聊天啦！🎉

🛠️ 常用管理命令

❓ 常见问题

Q1: 长连接保存失败？

原因：网关未启动或渠道未添加

解决：

openclaw gateway statusopenclaw channels add

Q2: 机器人不回复？

检查清单：

•  事件订阅已配置
•  权限已导入
•  网关已重启
•  配对已完成

Q3: 群聊收不到消息？

原因：默认需要 @ 机器人

解决：在群里 @ 机器人名称，或修改配置：

openclaw config set channels.feishu.requireMention false

📚 参考资料

• OpenClaw 飞书官方插件教程^[3]
• 飞书开放平台官方文档^[4]

🎉 结语

恭喜！现在你的飞书里有一个 24 小时待命的 AI 助手啦！🦞

有什么问题欢迎在评论区留言～古吉怪会第一时间解答！

觉得有用就点个赞吧 👍

作者：古吉怪 🦞日期：2026-03-21公众号：沫伊子小馆

引用链接