openclaw 如何连接飞书机器人

发表于 |

前言

为了方便多个智能体协作，我们需要用到飞书的多智能体群聊。
OpenClaw 默认自带飞书通道，属于社区插件。
目前飞书已经开发了官方插件，功能更加强大，接下来跟大家分享一下如何快速将 OpenClaw 绑定到飞书机器人。

官方版飞书插件使用

如果你的OpenClaw 部署在本地电脑，那么可以直接使用扫码的方式：

第一步：安装官方飞书插件
在终端执行以下指令安装：

1
npx -y @larksuite/openclaw-lark install

第二步：扫码创建机器人
安装完后会在终端生成二维码，此时直接用飞书扫描该二维码即可自动创建飞书机器人并绑定会话。

如果你的 OpenClaw 部署在云端，无法获取二维码，那么需要手动配置：

  1. 前往飞书开发平台创建机器人，获取 App ID 和 App Secret。
    推荐进入 open.feishu.cn/page/openclaw?form=multiAgent 快速创建飞书机器人应用，获取 App ID 和密钥。
    图片

  2. 安装飞书插件，然后将机器人的 App ID 和 App Secret 告诉 OpenClaw，让其配置并启用飞书插件。
    图片

  3. 插件启用后，前往飞书机器人窗口发送任意消息获取配对码，如下：

1
2
3
4
5
OpenClaw: access not configured.
ou_4cfc4b4ed6334283a697bfe77a8cf2xx
Pairing code: Xxxx
Ask the bot owner to approve with:
openclaw pairing approve feishu Xxxx

图片
4. 将 openclaw pairing approve feishu Xxxx 这一行发给 OpenClaw 让其配对完即可正常聊天了。
图片
图片

关于社区版飞书插件的使用

由于 OpenClaw 自带飞书通道，无需另外安装插件，直接将机器人的 App ID 和 App Secret 发给 OpenClaw 让其自动配置即可使用。

不过社区版飞书插件功能有限，只能实现基础的聊天，无法操控飞书的文档、多维表格、日历等功能。

我们可以在飞书对话框输入 /feishu auth 如果能正常授权，则表示成功使用了官方飞书插件，社区插件是无法授权的。

社区版插件常用指令

1
2
3
4
5
6
7
8
# 1. 删除旧配置（清空凭证）
openclaw config unset channels.feishu

# 2. 重新触发登录向导
openclaw channels login --channel feishu

# 3. 重登后检查状态：
openclaw channels status --channel feishu

看到 Status: connected 即代表恢复成功。

官方插件没有重登指令，如果断线 → 先重启网关 → 无效则检查飞书后台凭证和权限 → 严禁使用 channels login 命令，如果你执行了该命令，它会尝试覆盖你的配置，导致官方插件失效。

常见问题

  1. 配置过程中断
    当我们执行npx @larksuite/openclaw-lark install 安装完插件后，紧接着就是配置飞书机器人，如果不小心中断，可以重新执行安装命令进入向导，不过这种方式会重新安装一遍比较，相对耗时，此时我们可以执行以下指令来手动配置APPID 和密钥 ：
    1
    2
    3
    4
    openclaw config set channels.feishu.appId "你的飞书机器人 APPID"
    openclaw config set channels.feishu.appSecret "你的飞书机器人密钥"
    openclaw config set channels.feishu.enabled true
    openclaw config set channels.feishu.connectionMode websocket

配置完后，如果机器人发消息没反应，通常是还未将飞书插件加入允许列表，如果不想手动设置， 可以执行以下命令来自动修复问题：

1
npx  @larksuite/openclaw-lark doctor --fix

修复完后给机器人发消息就可以接收到配对码了，最后执行配指令就可以正常对话了。

日常我们也可以手动检查 openclaw.json 配文件，只要该三处设置没问题就可以正常连接了：
图片

  • plugins.allow ：是否允许加载插件，未加入允许列表的插件，即便安装了也会被系统忽略
  • channels.feishu.enable 是否开启飞书通道

本文为作者原创 转载时请注明出处 谢谢

乱码三千 – 点滴积累 ,欢迎来到乱码三千技术博客站

0%