集成飞书后，您可以通过飞书机器人、接收告警、使用飞书账号登录OpenClaw，甚至将工作流通知发送到飞书群。整个过程主要分为在OpenClaw中配置和在飞书开放平台创建应用两部分

openclaw openclaw中文博客 2026-04-09 1

核心集成流程图

graph TD
    A[开始集成] --> B[飞书开放平台创建企业自建应用]
    B --> C[配置应用： 权限、事件、安全]
    C --> D[获取关键凭证： App ID, Secret, Verif Token, Encrypt Key]
    D --> E[在OpenClaw管理后台填写凭证]
    E --> F[发布应用/启用能力]
    F --> G[测试： 邀请机器人、发送消息]
    G --> H[集成成功]

第一部分：在飞书开放平台创建和配置应用

登录并创建应用
- 访问飞书开放平台。
- 使用具有企业管理员权限的飞书账号登录。
- 进入“开发者后台”，点击“创建企业自建应用”。
- 填写应用名称（如 OpenClaw助手）、描述，并上传图标。
获取应用凭证
- 在应用详情页,找到 “凭证与基础信息” 页面。
- 记录下以下关键信息,稍后需要在OpenClaw中配置：
  - App ID
  - App Secret
配置权限
- 进入 “权限管理” 页面，为您的应用添加以下所需权限（根据您的集成需求选择）：
  - 基础权限：
    - contact:user.id:readonly （获取用户信息）
    - contact:user.base:readonly
  - 机器人权限：
    - im:message （发送和接收消息）
    - im:message.group_at_msg （发送群消息并@所有人）
    - im:message.p2p_msg （发送单聊消息）
  - 事件订阅权限：
    - 如果您需要接收OpenClaw的告警或通知,需要 im:message.notify 等。
  - 安全设置（重要）：
    - 进入 “安全设置” 页面。
    - 在 “IP白名单” 中，添加您部署OpenClaw服务器的公网IP地址，否则飞书会拒绝调用。
启用和配置机器人
- 在应用功能栏,点击 “机器人”。
- 点击 “启用机器人”。
- 您可以在“机器人信息”中设置机器人名称、头像和描述。
配置事件订阅（可选，用于接收OpenClaw主动通知）
- 在应用功能栏,点击 “事件订阅”。
- 开启事件订阅。
- 填写 “请求网址 URL”：这将是OpenClaw提供的一个回调地址，通常是 https://你的openclaw域名/feishu/callback。 （先记下这个格式，具体URL在OpenClaw配置后获得）
- 飞书会生成 “Encrypt Key” 和 “Verification Token”。务必记录这两项，它们对验证请求至关重要。
- 添加需要订阅的事件,为了接收机器人的消息事件，您需要添加 im.message.receive_v1 事件。
发布应用
- 完成以上配置后,在 “版本管理与发布” 页面，创建一个新版本并填写说明。
- 申请发布，企业自建应用通常需要由企业管理员审核通过。
- 审核通过后,在 “可用性” 页面，将应用添加到指定的飞书群或整个企业。

第二部分：在OpenClaw管理后台配置飞书集成

登录OpenClaw管理后台

使用管理员账号登录您的OpenClaw Web管理界面。
找到飞书集成配置
- 导航到 “系统设置” 或 “集成配置” 或 “第三方服务” 相关菜单。
- 找到 “飞书” 或 “Lark” 的配置项。
填写飞书应用信息
- 将在飞书开放平台获取的凭证填入对应字段：
  - App ID -> 飞书应用ID
  - App Secret -> 飞书应用密钥
  - Verification Token -> 验证令牌 （来自事件订阅）
  - Encryption Key -> 加密密钥 （来自事件订阅）
- 回调URL： OpenClaw可能会显示一个回调URL（如 https://your-domain.com/api/feishu/webhook）。将此URL完整地复制到飞书开放平台“事件订阅”的“请求网址”中。
配置功能开关
- 根据需求启用相关功能：
  - 飞书登录：允许用户使用飞书账号登录OpenClaw。
  - 机器人通知：将OpenClaw的任务结果、系统告警发送到指定飞书群或用户。
  - 指令接收：允许在飞书中@机器人，向OpenClaw发送指令（如 /status）。
测试连接
- 保存配置后,通常会有一个 “测试连接” 或 “验证” 按钮。
- 点击测试,OpenClaw会尝试与飞书服务器通信，验证凭证是否正确，成功会显示“验证成功”。
同步组织架构（可选）

如果启用了飞书登录,可能需要手动触发一次组织架构同步，将飞书中的用户和部门信息同步到OpenClaw。

第三部分：测试与使用

测试机器人
- 在已添加该应用的飞书群中,@您创建的机器人，发送一个简单的问候（如“你好”）。
- 如果配置了指令处理,OpenClaw应该会回复，您可能需要在OpenClaw中配置机器人的响应逻辑。
测试飞书登录
- 在OpenClaw登录页面,点击 “飞书登录” 按钮。
- 系统应跳转至飞书授权页面,授权后即可登录OpenClaw。
测试通知

在OpenClaw中触发一个操作（如运行一个工作流、产生一个告警），检查指定的飞书群或用户是否收到通知。

常见问题与排查

“回调地址验证失败”：
- 检查OpenClaw的公网IP是否已添加到飞书的IP白名单。
- 检查飞书“请求网址”与OpenClaw提供的回调URL是否完全一致（包括https）。
- 检查OpenClaw服务是否正常运行且能从外网访问。
- 检查 Verification Token 和 Encryption Key 是否填写正确。
机器人无响应：
- 检查飞书应用是否已成功发布并添加到对应群聊。
- 检查OpenClaw的机器人功能是否已启用。
- 查看OpenClaw和飞书开放平台的日志,寻找错误信息。
飞书登录失败：
- 检查OpenClaw中飞书登录功能开关是否打开。
- 检查飞书应用是否申请了正确的用户信息权限（如 contact:user.base:readonly）。
- 检查用户是否在应用的可使用范围内。