OpenClaw 飞书接入详细教程：从零开始配置全流程

前言

最近很多朋友问我OpenClaw怎么接入飞书，网上虽然有一些教程，但要么步骤不全，要么遇到权限问题就卡壳。今天我结合自己三次接入的经验，整理出这份超详细的教程，从创建飞书应用到OpenClaw配置，每一步都配了截图和注意事项，保证你看完就能成功接入。

一、接入前准备

• 已部署并可正常访问的OpenClaw服务（如果是本地部署，需要保证飞书能访问到你的回调地址）
• 飞书企业账号（个人账号也可以，但部分权限需要企业认证）
• 管理员权限（创建应用和配置权限需要）

二、飞书应用创建步骤

1. 登录飞书开放平台

打开飞书开放平台，用你的飞书账号登录，进入开发者后台。

2. 创建企业自建应用

点击首页的「创建应用」按钮，选择「企业自建应用」（内部使用，无需上架），填写应用名称（比如「AI助手」）、描述，上传图标（≥240×240px，≤2MB），然后点击创建。

3. 获取应用凭证

创建成功后，进入应用详情页，在「凭证与基础信息」页面复制App ID和App Secret，这两个凭证非常重要，后面配置OpenClaw会用到。

三、飞书应用权限配置（关键步骤）

很多朋友接入失败都是因为权限没配全，下面是必须配置的权限：

• im:message:send_as_bot：发送消息权限
• im:message:receive：接收消息权限
• im:chat:member：获取群成员权限
• im:chat:create：创建群聊权限
• contact:user.base:readonly：获取通讯录基本信息权限

配置方法：进入应用详情页的「权限管理」，点击「批量导入/导出权限」，粘贴上面的权限JSON，然后点击「格式化」→「下一步」→「申请开通」。个人账号即刻生效，企业账号需要管理员审核。

四、事件订阅配置

进入「事件与回调」→「事件配置」，订阅方式选择「使用长连接接收事件」，保存设置。然后点击「添加事件」，搜索并选择「接收消息 v2.0 (im.message.receive_v1)」，添加完成后保存。

五、发布应用

进入「版本管理与发布」→「创建版本」，填写版本号（比如1.0.0）、更新说明，移动端/桌面端默认能力均选择「机器人」，然后点击「确认发布」。个人账号发布后直接生效，企业账号需要完成审核。

六、OpenClaw 飞书配置

飞书应用创建完成后，现在配置OpenClaw：

1. 启用飞书插件

打开终端，执行以下命令启用飞书插件：

openclaw plugins enable feishu

然后执行openclaw plugins list查看插件状态，如果显示loaded说明启用成功。

2. 配置渠道

执行以下命令配置飞书渠道：

openclaw channels add

然后按照提示选择「Feishu/Lark (飞书) (needs app creds)」，输入之前复制的App ID和App Secret，连接模式选择国内域名，群聊策略选择「Open」（响应所有群聊），完成后重启OpenClaw服务使配置生效。

七、测试接入是否成功

打开飞书，找到你创建的机器人，发送一条消息，比如「你好」，如果机器人能正常回复，说明接入成功。

常见问题及解决方法

问题	解决方法
发送消息没反应	检查权限是否配全，事件订阅是否配置正确，OpenClaw服务是否正常运行
提示权限不足	检查应用是否有管理员权限，权限是否申请开通
配置完成后无法接收消息	检查事件订阅是否选择了长连接接收事件，是否添加了接收消息事件

总结

以上就是OpenClaw接入飞书的详细全流程，只要按照步骤一步步来，基本不会出问题。如果还有疑问，可以在评论区留言，我会一一解答。