飞书（国际版 Lark）的接入比 Telegram 稍微复杂一些，主要因为需要在飞书开放平台创建一个企业应用。不过不需要企业认证，个人飞书账号就可以完成全部操作。

一、前置条件

  • 已完成 OpenClaw 安装（参见第1篇）
  • 飞书账号（个人账号即可）

二、在飞书开放平台创建应用

Step 1 - 登录开放平台

打开 飞书开放平台，用你的飞书账号登录。

Step 2 - 创建企业自建应用

  1. 点击右上角创建应用
  2. 选择企业自建应用
  3. 填写应用名称（随意，比如 OpenClaw Bot）和描述，创建

Step 3 - 复制 App ID 和 App Secret

进入应用后，在凭证与基础信息页面找到：

  • App ID：格式为 cli_xxxxxxxxxxxxxxxx
  • App Secret：点击"查看"获取

把这两个值复制保存，后面配置 OpenClaw 时要用。

Step 4 - 开启机器人能力

在左侧菜单找到添加应用能力，选择机器人，开启。

Step 5 - 配置权限

在左侧菜单找到权限管理，需要开启以下权限（可以批量导入官方提供的 scope 列表，参考官方文档）：

主要需要的权限类别：

  • 读取和发送消息相关权限
  • 获取用户信息权限
  • 群组消息相关权限（如果要在群里使用）

Step 6 - 开启事件订阅（WebSocket 模式）

  1. 在左侧菜单找到事件与回调
  2. 选择使用长连接接收事件（WebSocket 模式，不需要公网服务器）
  3. 勾选需要订阅的事件（消息接收相关）
WebSocket 模式是关键：OpenClaw 在本地运行，不需要公网 IP 或服务器，飞书通过 WebSocket 长连接主动推送消息。

Step 7 - 发布应用

完成配置后，点击创建版本并提交发布。

  • 如果你的飞书是个人使用，自己就是管理员，可以直接审批通过
  • 企业版需要管理员审批

三、配置到 OpenClaw

方式 A：通过 onboard 向导（推荐）

bash
1openclaw onboard

向导会提示你选择 Channel，选择飞书后按提示填入 App ID 和 App Secret。

方式 B：手动编辑配置文件

编辑 ~/.openclaw/openclaw.json：

json
 1{
 2  "channels": {
 3    "feishu": {
 4      "enabled": true,
 5      "accounts": {
 6        "main": {
 7          "appId": "cli_xxxxxxxxxxxxxxxx",
 8          "appSecret": "你的 AppSecret"
 9        }
10      }
11    }
12  }
13}

四、启动 Gateway 并完成配对

Step 1 - 启动 Gateway

bash
1openclaw gateway

Step 2 - 在飞书里找 Bot 发消息

打开飞书，在搜索里搜索你创建的应用名称（比如 OpenClaw Bot），点进去发一条消息。

Bot 会回复一个配对码。

Step 3 - 完成配对

在终端执行：

bash
1openclaw pairing list feishu
2openclaw pairing approve feishu <配对码>

批准后，在飞书里正常对话即可。

五、进阶配置

Lark 国际版用户

如果你使用的是 Lark（飞书国际版），在配置里加上 domain 字段：

json
 1{
 2  "channels": {
 3    "feishu": {
 4      "enabled": true,
 5      "accounts": {
 6        "main": {
 7          "appId": "cli_xxx",
 8          "appSecret": "xxx",
 9          "domain": "lark"
10        }
11      }
12    }
13  }
14}

减少 API 调用

飞书每次发消息默认会调用 API 获取用户名等信息。如果想减少 API 调用次数：

json
 1{
 2  "channels": {
 3    "feishu": {
 4      "enabled": true,
 5      "accounts": {
 6        "main": {
 7          "appId": "cli_xxx",
 8          "appSecret": "xxx",
 9          "typingIndicator": false,
10          "resolveSenderNames": false
11        }
12      }
13    }
14  }
15}

群聊配置

在飞书群里使用 Bot，需要配置群组策略：

json
 1{
 2  "channels": {
 3    "feishu": {
 4      "enabled": true,
 5      "accounts": {
 6        "main": {
 7          "appId": "cli_xxx",
 8          "appSecret": "xxx",
 9          "groupPolicy": "open",
10          "requireMention": true
11        }
12      }
13    }
14  }
15}
  • groupPolicy：open（所有群都可用）/ allowlist（仅白名单群）/ disabled
  • requireMention：true 表示群里必须 @ Bot 才响应

六、常见问题

Bot 在飞书里没有响应

先检查：

  1. 应用是否已发布并审批通过
  2. Gateway 是否在运行：openclaw gateway status
  3. 事件订阅是否开启了 WebSocket 模式
  4. 查看日志：openclaw logs --follow

配对后还是无法对话

确认应用权限里包含了消息读取和发送权限，然后重启 Gateway。

下一篇：微信 ClawBot 配置！