前言

最近在折腾 OpenClaw 和飞书机器人的集成，整个过程比预想中曲折一些。

网上相关资料很少，我也踩了不少坑，才把整套流程跑通。

这篇文章把关键节点整理出来，希望能帮到正在做同样事情的朋友。

环境信息

• OpenClaw 版本: latest
• Node.js: v22.22.0
• 操作系统: Windows 11
• 飞书应用类型: 企业内部应用

问题一：官方飞书插件安装失败

现象

按照文档指引，先尝试安装飞书插件：

openclaw plugins install feishu

报错如下：

Error: Cannot find package '@openclaw/plugin-feishu'
npm ERR! 404 Not Found

原因分析

原因其实很直接。OpenClaw 官方 npm 仓库里并没有发布 @openclaw/plugin-feishu 这个包。

也就是说，文档里提到的飞书插件，不能直接通过官方包名安装。

解决方案

社区已经有可用的第三方开源插件，可以直接通过 GitHub 地址安装：

openclaw plugins install https://github.com/AlexAnys/openclaw-feishu

安装完成后建议立即验证：

openclaw plugins list

如果列表里出现了 feishu，就说明安装成功。

问题二：配置后机器人聊天口没有

这种情况通常需要把事件配置里的订阅方式长连接配置好，然后再发布一次才能生效。

现象

插件安装完成后，按文档配置了 App ID 和 App Secret。

但发送消息时会直接报错：

Feishu account 'default' not configured

同时，飞书机器人端没有任何反应。

错误配置示例

最初我的配置如下，后来发现问题都出在这里：

openclaw config set channels.feishu.app_id "cli_xxx"
openclaw config set channels.feishu.app_secret "xxx"
openclaw config set channels.feishu.domain "lark"  # 错误！应该是 feishu

原因分析

• 域名搞混了：飞书（Feishu）和 Lark 虽然都是字节跳动的产品，但一个是国内版，一个是国际版，配置时不能写错。

  • 飞书（中国版）：domain = "feishu"
  • Lark（国际版）：domain = "lark"

• 配置结构不对：插件要求使用 accounts 数组格式，而不是直接把配置写在顶层。

正确的配置方式

第一步：配置 accounts 数组

# 配置账号 ID
openclaw config set "accounts.feishu[0].id" "default"
# 配置 App ID
openclaw config set "accounts.feishu[0].app_id" "cli_xxx"
# 配置 App Secret
openclaw config set "accounts.feishu[0].app_secret" "xxx"

第二步：配置 channels 引用

# 配置域名（注意是 feishu，不是 lark）
openclaw config set "channels.feishu.accounts[0].domain" "feishu"
# 配置账号引用
openclaw config set "channels.feishu.account" "default"

第三步：重启 Gateway

openclaw gateway restart

这一步不要省略。 否则配置可能不会生效。

问题三：飞书应用权限配置

必要权限

在飞书开放平台（open.feishu.cn/app）需要把下面这些权限都打开：

• 机器人权限

  • 机器人: 获取以应用身份发送的消息
  • 机器人: 在群组内发送和接受消息

• 即时消息权限

  • 即时消息: 发送消息

• 群组权限

  • 群组: 获取群组信息

配置步骤

0. 进入飞书开放平台 → 我的应用
1. 点击 权限管理
2. 搜索并添加上述权限
3. 点击 申请权限 并提交
4. 等待审核通过（企业应用通常是自动过审的）

最终完整配置

{
  "accounts": {
    "feishu": [
      {
        "id": "default",
        "app_id": "cli_xxx",
        "app_secret": "xxx"
      }
    ]
  },
  "channels": {
    "feishu": {
      "account": "default",
      "accounts": [
        {
          "id": "default",
          "domain": "feishu",
          "app_id": "cli_xxx",
          "app_secret": "xxx"
        }
      ]
    }
  }
}

测试发送消息

获取群聊 ID

群聊 ID 可以直接从飞书群链接中提取：

https://applink.feishu.cn/client/chat/chatter/add_by_linklink_token=f7ftd1a0-50db-46b7-8e86-40a7b731a10a

这个链接里的 f7ftd1a0-50db-46b7-8e86-40a7b731a10a，就是群 ID。

发送消息命令

可以先在命令行中直接测试发送：

openclaw message send 
  --channel feishu 
  --target "chat:f7ftd1a0-50db-46b7-8e86-40a7b731a10a" 
  --message "大家好，这是测试消息！"

也可以在代码里调用：

await message.send({
  channel: 'feishu',
  target: 'chat:f7ftd1a0-50db-46b7-8e86-40a7b731a10a',
  message: '大家好'
});

常见问题汇总

问题	原因	解决方案
插件安装 404	官方包未发布	使用 GitHub 第三方插件
account not configured	配置结构错误	使用 accounts.feishu[0] 数组格式
Invalid App Access Token	域名错误	domain 设为 "feishu"，不是 "lark"
消息发送失败	权限未开启	在飞书开放平台申请必要权限
配置不生效	未重启 gateway	openclaw gateway restart

总结

连接飞书的核心点有五个：

0. 插件来源要对：用 GitHub 的第三方插件代替官方未发布的包
1. 配置结构要对：用 accounts 数组格式，别往顶层塞
2. 域名要对：飞书不是 Lark，别搞混
3. 权限要够：该开的权限一个不能少
4. 每次改完配置，记得重启 gateway

希望这篇文章能帮你少走一些弯路。

如果有问题，欢迎在评论区交流。

参考链接

• OpenClaw 官方文档
• 飞书开放平台
• openclaw-feishu 插件源码
• 飞书 API 文档