OpenClaw（三）| 飞书对接

OpenClaw（三）| 飞书对接

• 一、飞书开发平台配置
• • [1. 新建应用](#1. 新建应用)
  • [2. 添加应用能力---能力添加和权限配置](#2. 添加应用能力—能力添加和权限配置)
  • [3. 创建版本与发布版本](#3. 创建版本与发布版本)
  • [4. 复制出【App ID】与【App Secret】](#4. 复制出【App ID】与【App Secret】)
  • [5. 获取【chat_id】](#5. 获取【chat_id】)
• [二、OpenClaw 安装飞书插件](#二、OpenClaw 安装飞书插件)
• • [1. 执行安装命令](#1. 执行安装命令)
  • [2. 配置文件修改-添加飞书配置](#2. 配置文件修改-添加飞书配置)
  • [3. 重启OpenClaw服务](#3. 重启OpenClaw服务)
• 三、飞书开发平台配置
• • [1. 事件与回调---配置订阅方式](#1. 事件与回调—配置订阅方式)
  • [2. 事件与回调---添加事件](#2. 事件与回调—添加事件)
  • [3. 创建版本与发布版本](#3. 创建版本与发布版本)
• [四、飞书客户端 获取 配对代码](#四、飞书客户端 获取 配对代码)
• [五、OpenClaw 批准飞书用户配对](#五、OpenClaw 批准飞书用户配对)
• 六、飞书发送消息以及本地记录查看

一、飞书开发平台配置

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/ 目录下的相关文件中

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

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

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

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