OpenClaw超简单4：飞书 Channel 配置

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

一、前置条件

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

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

Step 1 - 登录开放平台

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

Step 2 - 创建企业自建应用

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

Step 3 - 复制 App ID 和 App Secret

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

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

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

Step 4 - 开启机器人能力

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

Step 5 - 配置权限

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

主要需要的权限类别：

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

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

在左侧菜单找到事件与回调
选择使用长连接接收事件（WebSocket 模式，不需要公网服务器）
勾选需要订阅的事件（消息接收相关）

Step 7 - 发布应用

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

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

三、配置到 OpenClaw

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

openclaw onboard

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

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

编辑 ~/.openclaw/openclaw.json：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "accounts": {
        "main": {
          "appId": "cli_xxxxxxxxxxxxxxxx",
          "appSecret": "你的 AppSecret"
        }
      }
    }
  }
}

四、启动 Gateway 并完成配对

Step 1 - 启动 Gateway

openclaw gateway

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

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

Bot 会回复一个配对码。

Step 3 - 完成配对

在终端执行：

openclaw pairing list feishu
openclaw pairing approve feishu <配对码>

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

五、进阶配置

Lark 国际版用户

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

{
  "channels": {
    "feishu": {
      "enabled": true,
      "accounts": {
        "main": {
          "appId": "cli_xxx",
          "appSecret": "xxx",
          "domain": "lark"
        }
      }
    }
  }
}

减少 API 调用

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

{
  "channels": {
    "feishu": {
      "enabled": true,
      "accounts": {
        "main": {
          "appId": "cli_xxx",
          "appSecret": "xxx",
          "typingIndicator": false,
          "resolveSenderNames": false
        }
      }
    }
  }
}

群聊配置

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

{
  "channels": {
    "feishu": {
      "enabled": true,
      "accounts": {
        "main": {
          "appId": "cli_xxx",
          "appSecret": "xxx",
          "groupPolicy": "open",
          "requireMention": true
        }
      }
    }
  }
}

groupPolicy：open（所有群都可用）/ allowlist（仅白名单群）/ disabled
requireMention：true 表示群里必须 @ Bot 才响应

六、常见问题

Bot 在飞书里没有响应

先检查：

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

配对后还是无法对话

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