一、飞书开发平台配置

1. 新建应用

打开浏览器，访问飞书开放平台官网：open.feishu.cn，点击 “开发者后台”
使用飞书账号完成登录；

点击"创建企业自建应用"

填写“应用名称”、“应用描述“、”应用图标”，点击 创建 按钮

2. 添加应用能力—能力添加和权限配置

应用创建成功后，点击添加机器人。

选择右侧“权限管理”菜单栏，点击“开通权限”

给予机器人权限，输入im（应用身份权限和用户身份权限都搜一遍），出来的所有结果都勾选上，进行授予，然后点击“确认开通权限”。

3. 创建版本与发布版本

4. 复制出【App ID】与【App Secret】

5. 获取【chat_id】

接下来点https://open.feishu.cn/api-explorer，
指定机器人为群管理员，保存并复制【chat_id】。

如果出现“我管理的群组”列表为空，就需要去创建一个群组

官方教学链接 https://www.feishu.cn/hc/zh-CN/articles/360025113754-创建群组
访问飞书网页版 https://icn1t8b8ylvr.feishu.cn/next/messenger

再返回 “指定群管理员” 页面，选择刚刚创建的群组

把这个里面的 chat_id 的值 给复制出来

二、OpenClaw 安装飞书插件

1. 执行安装命令

openclaw plugins install @openclaw/feishu

安装完成后，系统会显示安装成功的信息，并提示重启网关以加载插件。

2. 配置文件修改-添加飞书配置

OpenClaw的配置文件位于：

~/.openclaw/openclaw.json

在配置文件中添加channels部分，包含飞书的详细配置：

"channels": {
  "feishu": {
    "enabled": true,
    "domain": "feishu",
    "connectionMode": "websocket",
    "appId": "复制上面的应用appId",
    "appSecret": "复制上面的应用appSecret",
    "dmPolicy": "pairing",
    "groupPolicy": "allowlist",
    "groupAllowFrom": ["复制上面的chat_id"]
  }
}

配置说明

配置项	说明
enabled	是否启用飞书插件
domain	渠道域名
connectionMode	连接模式
appId	飞书应用ID
appSecret	飞书应用密钥
dmPolicy	私聊策略
groupPolicy	群聊策略
groupAllowFrom	允许的群聊ID列表

3. 重启OpenClaw服务

配置完成后，需要重启OpenClaw服务以应用更改：

openclaw gateway restart

三、飞书开发平台配置

回到开发者后台open.feishu.cn，点击应用

1. 事件与回调—配置订阅方式

左侧设置“事件与回调”。在“事件配置”中，添加订阅方式，选择“长连接”，点击保存。

2. 事件与回调—添加事件

保存后，在最右侧点击“添加事件”，搜索“接收消息”并保存，再去创建一个新版本并发布。

3. 创建版本与发布版本

四、飞书客户端 获取 配对代码

现在可以回到飞书，https://icn1t8b8ylvr.feishu.cn/next/messenger
点击“开发者小助手”，点击“打开应用”（这一步必须要求在客户端使用所以说你得下载客户端）



在保证目前你本地 OpenClaw 是 启动的状态下，才能向打开的小龙虾发送 “配对”，拿到配对代码

五、OpenClaw 批准飞书用户配对

当飞书用户首次尝试连接时，系统会生成配对代码，需要使用以下命令批准：

openclaw pairing approve feishu <配对代码>

例如：

openclaw pairing approve feishu X49L7PFG

配对码的存储机制

• 配对码 ：是临时生成的一次性代码，用于验证用户身份，配对成功后不会被存储
• 配对关系 ：配对成功后，系统会将用户的飞书ID与OpenClaw的关联关系持久化存储
• 存储位置 ：配对关系通常存储在 ~/.openclaw/credentials/ 目录下的相关文件中

六、飞书发送消息以及本地记录查看

发送任意消息，比如“你好”，你会发现你的“龙虾”通过飞书回答你了

然后在本地的龙虾控制面板里面也能看见和飞书的聊天记录

恭喜你，成功对接飞书成功