Skip to content

飞书配置指南

在飞书上运行 OpenClaw AI 助手的完整步骤

前置要求

在开始之前,你需要有一个飞书账号,并能够访问飞书开放平台。如果你是个人用户,可以使用「自建应用」模式。

1

第一步:创建飞书应用

打开飞书开放平台 (open.feishu.cn),登录后进入「开发者后台」,点击「创建企业自建应用」。

  • 填写应用名称(如:我的 AI 助手)
  • 填写应用描述(可选)
  • 上传应用图标(可选)
  • 选择你所在的企业(或创建个人版)
第一步:创建飞书应用

截图示例

2

第二步:获取凭证

在创建好的应用页面,找到「凭证与基础信息」,复制以下两个值备用:

App ID(格式:cli_xxxx)App Secret
第二步:获取凭证

截图示例

3

第三步:配置权限

在左侧菜单点击「权限管理」,申请以下权限:

  • im:message - 发送和接收消息
  • im:message.group_at_msg - 接收群聊@消息
  • im:message.receive_v1 - 接收消息事件
第三步:配置权限

截图示例

4

第四步:发布应用

配置好权限后,需要创建版本并发布应用才能生效:

  • 点击「创建版本」
  • 填写版本号(如 1.0.0)
  • 填写更新说明
  • 点击「保存」后再点击「发布」
第四步:发布应用

截图示例

5

第五步:在 OpenClaw 中配置

打开 OpenClaw Desktop,进入「通道」设置,选择「飞书」,粘贴第二步复制的 App ID 和 App Secret。

💡 推荐选择「轮询模式」,简单稳定,无需配置 Webhook。

第五步:在 OpenClaw 中配置

截图示例

6

第六步:测试

在飞书中找到你的机器人,直接发送一条消息。如果配置正确,AI 会回复你!

第六步:测试

截图示例

⚠️ 第六步:测试 - 在飞书中找到你的机器人,直接发送一条消息。如果配置正确,AI 会回复你!

常见问题

提示「App Secret 不正确」

请到飞书开放平台重新复制 App Secret,注意不要有空格。如果还是不行,可以尝试重新生成。

机器人没有回复

1. 确认应用已发布;2. 确认已添加机器人为联系人;3. 检查 OpenClaw 是否在运行。

如何获取 API 密钥?

参考「免费API」页面,国内各大厂都提供免费额度。