脚本之家 服务器常用软件
快捷导航
您的位置：主页 > AI > openclaw > OpenClaw连接飞书

OpenClaw连接飞书插件安装、配置与踩坑记录完整指南

  发布时间：2026-03-10 11:28:08   作者：小黎1475778985364   我要评论
2026年OpenClaw(前身为Moltbot)凭借轻量化部署、强大的AI任务执行能力与灵活的生态集成特性,成为企业智能化办公的核心工具，这篇文章主要介绍了OpenClaw连接飞书插件安装、配置与踩坑记录完整指南的相关资料,需要的朋友可以参考下

前言

最近在使用 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 包，文档中提到的飞书插件需要单独安装。

解决方案

使用第三方开源插件：

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

原因分析

  1. 域名错误：飞书（Feishu）和 Lark 是字节跳动不同版本的产品

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

  2. 配置结构错误：插件需要 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）需要开启以下权限：

  1. 机器人权限

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

  2. 即时消息权限

    • ✅ 即时消息: 发送消息

  3. 群组权限

    • ✅ 群组: 获取群组信息

配置步骤

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

最终完整配置

{
  "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

从飞书群链接中提取：

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

群 ID 为：f7ftd1a0-50db-46b7-8e86-40a7b731a10a

发送消息命令

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"
消息发送失败权限未开启在飞书开放平台申请必要权限
配置不生效未重启 gatewayopenclaw gateway restart

总结

连接飞书的关键点：

  1. ✅ 使用正确的插件来源（GitHub 第三方插件）
  2. ✅ 配置正确的数据结构（accounts 数组格式）
  3. ✅ 区分飞书和 Lark 的域名配置
  4. ✅ 确保飞书应用有足够权限
  5. ✅ 每次配置修改后重启 gateway

希望这篇文章能帮助你少走弯路！如果有问题欢迎在评论区交流。

参考链接

到此这篇关于OpenClaw连接飞书插件安装、配置与踩坑记录的文章就介绍到这了,更多相关OpenClaw连接飞书内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多支持脚本之家！

相关文章

最新评论

关注微信公众号

扫一扫