OpenClaw接入飞书步骤方法：完整教程+常见问题一次讲清（2026新版）

OpenClaw如何接入飞书？本文将详细讲解OpenClaw接入飞书的完整步骤，包括获取凭证、配置方法及常见问题解决，并提供快速部署方案，适合新手快速上手。

一、在飞书开放平台创建应用并获取凭证

1、访问【飞书开放平台】，使用企业账号登录；
2、点击【创建企业自建应用】，填写应用名称（如：AI助手），点击确认。

3、进入应用后，在左侧菜单【凭证与基础信息】中，记录App ID和App Secret（这两个值稍后要在OpenClaw中配置）

4、在左侧菜单点击【添加应用能力】，找到【机器人】，点击【添加】；

二、在飞书开放平台配置权限和事件

1、配置权限

①、点击左侧菜单【权限管理】；
②、点击【添加权限】，搜索并添加以下权限：
im:message
im:message.p2p_msg:readonly
im:message.group_at_msg:readonly
im:message:send_as_bot
contact:user.base:readonly

2、配置事件订阅

①、点击左侧菜单【事件与回调】；
②、在【订阅方式】中，选择 使用长连接接收事件，点击保存；

③、点击【添加事件】，搜索并勾选 im.message.receive_v1，确认添加。

3、发布应用

①、点击左侧菜单【版本管理与发布】；

②、点击【创建版本】，填写版本号（如 1.0.0），提交审核发布；
企业内部应用通常很快通过审核，请等待发布完成后再继续下一步。

三、在OpenClaw中安装飞书插件并配置凭证

1、安装插件

OpenClaw部署助手（官方版）

一键本地部署OpenClaw，真正能干活的AI Agent

立即下载

好评率97%

下载次数：3137117

连接到安装OpenClaw的服务器，执行：
npx -y @larksuite/openclaw-lark install

2、配置 App ID 和 App Secret

方法一：使用命令行配置（推荐）

openclaw config set channels.feishu.appId "你的App ID"
openclaw config set channels.feishu.appSecret "你的App Secret"
openclaw config set channels.feishu.enabled true
openclaw config set channels.feishu.connectionMode websocket

方法二：直接编辑配置文件

编辑 ~/.openclaw/openclaw.json，在 channels 中添加：
"channels": {
  "feishu": {
    "enabled": true,
    "appId": "你的App ID",
    "appSecret": "你的App Secret",
    "connectionMode": "websocket"
  }
}

3、重启OpenClaw服务

openclaw gateway restart

四、触发配对码

1、打开飞书客户端（桌面端或移动端）
2、搜索你创建的机器人名称（如：AI助手）
3、进入聊天窗口，发送任意消息，例如：Hello

4、机器人会自动回复一条消息，其中包含一个 配对码（例如：123456）

五、在OpenClaw中完成配对

回到OpenClaw服务器终端，执行：
openclaw pairing approve feishu 123456
（将123456替换为机器人实际回复的配对码）
看到“✔”配对成功 提示后，配对完成。

六、验证

再次向飞书机器人发送消息，例如：你好，机器人应能正常回复。如果回复正常，说明绑定成功。

常用命令参考：

常见问题

Q1：机器人收不到我发的消息？

A：请检查：
①、飞书应用是否已成功发布；
②、事件订阅是否选择了“长连接”；
③、是否已添加 im.message.receive_v1 事件；
④、权限中是否包含 im:message 相关权限。

Q2：配对时提示“没有待处理的配对请求”？

A：先执行openclaw pairing list feishu查看列表。如果为空，请重新向机器人发送一条消息触发新的配对码。

Q3：配置修改后不生效？

A：每次修改配置后都必须执行openclaw gateway restart重启服务。

Q4：App Secret 填错了怎么办？

A：重新执行openclaw config set channels.feishu.appSecret "正确的App Secret"，然后重启服务。