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、安装插件
好评率97% 
下载次数：3137072 连接到安装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替换为机器人实际回复的配对码）
看到“✔”配对成功 提示后，配对完成。
六、验证
再次向飞书机器人发送消息，例如：你好，机器人应能正常回复。如果回复正常，说明绑定成功。
常用命令参考：
| 操作 | 命令 |
| 安装插件 | npx -y @larksuite/openclaw-lark install |
| 配置 App ID | openclaw config set channels.feishu.appId "你的App ID" |
| 配置 App Secret | openclaw config set channels.feishu.appSecret "你的App Secret" |
| 启用飞书通道 | openclaw config set channels.feishu.enabled true |
| 重启服务 | openclaw gateway restart |
| 批准配对 | openclaw pairing approve feishu [配对码] |
| 查看待配对列表 | openclaw pairing list feishu |
| 查看日志 | openclaw logs --follow |
常见问题
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"，然后重启服务。
