2026 最新版：OpenClaw (Clawdbot) 飞书接入保姆级教程

为什么要把 OpenClaw 接入飞书？

飞书是目前国内最受互联网团队欢迎的办公平台之一。把 OpenClaw 接入飞书后，你的 AI 助手可以直接在群聊或私聊中响应，实现：

• 实时问答和知识检索
• 自动整理会议纪要
• 定时推送日报/周报
• 多维表格数据处理

本文基于 2026 年最新版 OpenClaw 和飞书开放平台，提供完整的接入流程。

前提条件：你需要一台已部署 OpenClaw 的服务器。如果还没有，先前往 腾讯云 OpenClaw 专题页 完成一键部署。

---

准备工作

1. 确认 OpenClaw 已正常运行

SSH 登录服务器，执行：

docker ps

确认 OpenClaw 相关容器处于 Up 状态。或者直接访问 http://服务器IP:3210 确认 Dashboard 可用。

部署教程：云上 OpenClaw 一键秒级部署指南

2. 注册飞书开放平台应用

登录 飞书开放平台，创建一个"企业自建应用"：

1. 点击创建应用 → 选择企业自建应用
2. 填写应用名称（如"AI 助手"）和描述
3. 获取 App ID 和 App Secret——后续配置要用

---

核心配置步骤

Step 1：配置飞书应用权限

在飞书开放平台的应用管理页面，进入权限管理，开通以下权限：

• im:message - 获取与发送消息
• im:message.group_at_msg - 接收群组 @ 消息
• im:resource - 获取消息中的资源文件
• contact:user.id:readonly - 获取用户 ID

Step 2：配置事件订阅

进入事件订阅页面：

1. 设置请求地址（Webhook URL）：

http://你的服务器IP:3210/api/feishu/webhook

2. 订阅以下事件：

   • im.message.receive_v1 - 接收消息
   • im.message.message_read_v1 - 消息已读

3. 飞书会发送一个验证请求，OpenClaw 会自动处理验证，无需手动操作。

Step 3：在 OpenClaw 中配置飞书渠道

登录 OpenClaw Dashboard (http://服务器IP:3210)：

1. 进入渠道管理或Channel 配置
2. 添加飞书渠道
3. 填入从飞书开放平台获取的：
   • App ID
   • App Secret
   • Verification Token（在事件订阅页面获取）
   • Encrypt Key（如有配置加密）

Step 4：发布应用并测试

1. 回到飞书开放平台，点击版本管理 → 创建版本 → 提交审核
2. 如果是企业内部应用，管理员可以直接通过审核
3. 审核通过后，在飞书中搜索你的应用名称，添加到群组或发起私聊

发送一条消息测试，如果 AI 正常回复，说明接入成功。

---

避坑指南

坑 1：Webhook 地址不可达

症状：飞书提示"请求地址验证失败"

排查：

• 确认服务器防火墙已放行 3210 端口
• 确认使用的是公网 IP，而非内网 IP
• 如果服务器在国内，确保飞书能正常访问

坑 2：消息接收正常但不回复

症状：Dashboard 中能看到消息记录，但飞书端没有回复

排查：

• 检查应用权限是否已全部开通
• 确认应用已发布并通过审核
• 检查 OpenClaw 日志是否有报错：docker logs openclaw

坑 3：群聊中不响应

症状：私聊正常，群聊 @ 机器人没反应

排查：

• 确认已订阅 im.message.group_at_msg 事件
• 确认群聊中已添加了该机器人
• 部分飞书版本需要在群设置中开启"机器人"功能

---

进阶玩法

接入飞书只是开始，配合 OpenClaw 的 Skills 系统，你可以实现更多场景：

• 飞书多维表格集成：让 AI 自动读取和更新业务数据
• 定时消息推送：每天早上自动发送行业简报
• 文档问答：上传内部文档，让 AI 基于知识库回答问题

Skills 安装参考：Installing OpenClaw Skills and Practical Applications

---

总结

飞书 + OpenClaw 的组合，可以让你的团队在最熟悉的办公环境中直接使用 AI 能力。整个接入过程不复杂，主要时间花在飞书开放平台的权限配置上。

如果你还没有部署 OpenClaw，现在正是好时机：腾讯云 OpenClaw 限时优惠，一键部署，几分钟搞定。