最新OpenClaw官方版本已添加对飞书/Lark插件的支持，快来看看如何配置飞书？

状态：生产就绪，支持机器人私聊和群组。使用 WebSocket 长连接模式接收消息。

需要插件

安装 Feishu 插件：

openclaw plugins install @openclaw/feishu

本地 checkout（在 git 仓库内运行）：

openclaw plugins install ./extensions/feishu

快速开始

添加飞书渠道有两种方式：
​
方式一：通过安装向导添加（推荐）
如果您刚安装完 OpenClaw，可以直接运行向导，根据提示添加飞书：

openclaw onboard

向导会引导您完成：
创建飞书应用并获取凭证
配置应用凭证
启动网关
✅ 完成配置后，您可以使用以下命令检查网关状态：

openclaw gateway status - 查看网关运行状态
openclaw logs --follow - 查看实时日志

​
方式二：通过命令行添加
如果您已经完成了初始安装，可以用以下命令添加飞书渠道：

openclaw channels add

然后根据交互式提示选择 Feishu，输入 App ID 和 App Secret 即可。
✅ 完成配置后，您可以使用以下命令管理网关：

openclaw gateway status - 查看网关运行状态
openclaw gateway restart - 重启网关以应用新配置
openclaw logs --follow - 查看实时日志

第一步：创建飞书应用

​
1. 打开飞书开放平台
访问 飞书开放平台，使用飞书账号登录。
Lark（国际版）请使用 https://open.larksuite.com/app，并在配置中设置 domain: "lark"。
​
2. 创建应用
点击 创建企业自建应用
填写应用名称和描述
选择应用图标

3. 获取应用凭证
在应用的 凭证与基础信息 页面，复制：
App ID（格式如 cli_xxx）
App Secret
❗ 重要：请妥善保管 App Secret，不要分享给他人。

4. 配置应用权限
在 权限管理 页面，点击 批量导入 按钮，粘贴以下 JSON 配置一键导入所需权限：

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "event:ip_list",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
  }
}

1. 启用机器人能力

在 应用能力 > 机器人 页面：
开启机器人能力
配置机器人名称

6. 配置事件订阅
⚠️ 重要提醒：在配置事件订阅前，请务必确保已完成以下步骤：
运行 openclaw channels add 添加了 Feishu 渠道
网关处于启动状态（可通过 openclaw gateway status 检查状态）
在 事件订阅 页面：
选择 使用长连接接收事件（WebSocket 模式）
添加事件：im.message.receive_v1（接收消息）
⚠️ 注意：如果网关未启动或渠道未添加，长连接设置将保存失败。

1. 发布应用

在 版本管理与发布 页面创建版本
提交审核并发布
等待管理员审批（企业自建应用通常自动通过）
​

第二步：配置 OpenClaw

​
通过向导配置（推荐）
运行以下命令，根据提示粘贴 App ID 和 App Secret：

openclaw channels add

选择 Feishu，然后输入您在第一步获取的凭证即可。

通过配置文件配置
编辑 ~/.openclaw/openclaw.json：

{
  channels: {
    feishu: {
      enabled: true,
      dmPolicy: "pairing",
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
          botName: "我的AI助手",
        },
      },
    },
  },
}

通过环境变量配置

export FEISHU_APP_ID="cli_xxx"
export FEISHU_APP_SECRET="xxx"

Lark（国际版）域名
如果您的租户在 Lark（国际版），请设置域名为 lark（或完整域名），可配置 channels.feishu.domain 或 channels.feishu.accounts.<id>.domain：

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

第三步：启动并测试

​

1. 启动网关

openclaw gateway

​

1. 发送测试消息

在飞书中找到您创建的机器人，发送一条消息。
​

1. 配对授权

默认情况下，机器人会回复一个 配对码。您需要批准此代码：

openclaw pairing approve feishu <配对码>

批准后即可正常对话。