飞书接入 OpenClaw 详细教程：打造你的智能助手

发布时间：2026-03-06 | 作者：winter.yu

前言

在 AI 助手日益普及的今天，如何将自己的智能助手无缝接入日常工作流成为了许多开发者关注的焦点。OpenClaw 是一个强大的 AI 代理平台，而飞书作为国内领先的企业协作工具，两者的结合能够为你的团队带来前所未有的效率提升。本文将手把手教你如何将 OpenClaw 接入飞书，让你的 AI 助手在飞书中随时待命。

为什么选择飞书 + OpenClaw？

• 深度协作：飞书提供了群聊、私聊、文档等丰富的协作场景
• 实时响应：OpenClaw 能够在飞书中实时接收和响应消息
• 多模态支持：支持文本、图片、卡片等多种消息格式
• 企业级安全：飞书的权限体系与 OpenClaw 的安全策略完美结合

准备工作

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

1. 飞书开发者账号：拥有一个飞书企业账号，并具备开发者权限
2. OpenClaw 环境：已安装并配置好 OpenClaw（建议 v22.22.0 及以上版本）
3. 公网服务器：OpenClaw 需要能够被飞书服务器访问（可通过内网穿透或云服务器实现）

第一步：创建飞书应用

1.1 进入飞书开发者后台

访问 飞书开放平台，点击「开发者后台」进入应用管理页面。

1.2 创建企业自建应用

1. 点击「创建应用」按钮
2. 选择「企业自建应用」
3. 填写应用信息：
   • 应用名称：OpenClaw Assistant（可自定义）
   • 应用描述：基于 OpenClaw 的智能 AI 助手
   • 应用图标：上传一个合适的图标

1.3 记录关键凭证

创建成功后，在「凭证与基础信息」页面，记录下以下信息：

• App ID（应用 ID）
• App Secret（应用密钥）

⚠️ 重要：App Secret 只显示一次，请务必保存好！

第二步：配置应用权限

为了让 OpenClaw 能够正常收发消息，需要开通以下权限：

2.1 权限配置清单

进入「权限管理」页面，添加以下权限：

权限名称	权限 Key	说明
读取用户 user_id	contact:user.id:readonly	获取用户身份
获取用户手机号	contact:user.phone:readonly	识别用户
读取群组信息	im:chat:readonly	获取群聊信息
读取单聊信息	im:message:readonly	接收私聊消息
读取群聊消息	im:message.group:readonly	接收群聊消息
发送消息	im:message:send	发送消息到私聊
发送消息到群聊	im:message:send_as_bot	发送消息到群聊
上传图片或文件	im:resource	发送多媒体消息

2.2 配置事件订阅

进入「事件与回调」页面，配置事件订阅：

1. 请求地址：填写你的 OpenClaw 飞书端点
2. 加密密钥：点击「重新生成」并记录下来
3. 订阅事件：添加 im.message.receive_v1 和 im.chat.member.bot.added_v1

第三步：配置 OpenClaw

3.1 编辑配置文件

打开 OpenClaw 的配置文件，添加飞书配置：

providers:
  feishu:
    enabled: true
    app_id: "cli_xxxxxxxx"
    app_secret: "xxxxxxxxxxxxxxxx"
    verification_token: "xxxxxxxxxxxxxxxx"
    webhook:
      path: "/feishu/events"
      verify_signature: true

3.2 配置消息处理

handlers:
  - provider: feishu
    enabled: true
    agent: default

3.3 启动 OpenClaw

openclaw start

第四步：发布与测试

1. 创建发布版本（可选提交审核）
2. 在飞书中搜索应用并测试

常见问题排查

Q1: 收不到消息？

• 检查公网可访问性
• 确认 verification_token 配置正确

Q2: 机器人提示”暂无权限”？

• 开通所有必要权限并重新发布

Q3: 消息发送失败？

• 检查 im:message:send 权限是否已开通

结语

通过本文的介绍，你应该已经成功将 OpenClaw 接入了飞书。现在可以开始构建智能客服、代码助手、会议纪要等场景了！

---

参考资料：

• OpenClaw 官方文档
• 飞书开放平台文档