🚀 快速开始（2 种方式）
方式一：安装向导（推荐新手）
openclaw setup
向导会自动引导你完成：
✅ 创建飞书应用并获取凭证
✅ 配置应用凭证
✅ 启动网关
方式二：命令行添加（推荐老手）
openclaw channelsadd
然后根据提示选择Feishu，输入 App ID 和 App Secret。
低版本的在这里选择Download fron npm，高版本已经内置了，选择Use local plugin path 即可：
根据提示输入飞书获取的信息即可。
📋 详细配置步骤
步骤 1：创建飞书应用
1.1 访问飞书开放平台
国际版：https://open.larksuite.com/app（配置时需设置domain: "lark"）
1.2 创建应用点击创建企业自建应用
点击创建企业自建应用
填写应用名称（如 “OpenClaw 助手”）
选择应用图
1.3 获取应用凭证
在凭证与基础信息页面，复制：
App ID（格式如cli_xxx）
App Secret⚠️
重要：请妥善保管 App Secret，不要分享给他人！
1.4 配置应用权限在权限管理页面，点击批量导入，粘贴以下 JSON：
{
"scopes": {
"tenant": [
"im:message",
"im:message:send_as_bot",
"im:message.p2p_msg:readonly",
"im:message.group_msg",
"im:chat",
"contact:contact.base:readonly",
"contact:user.employee_id:readonly"
],
"user": [
"im:chat.access_event.bot_p2p_chat:read"
]
}
}
必需权限说明：
💡 为什么需要 contact:contact.base:readonly？ 这个权限用于获取用户基本信息，OpenClaw 需要它来： ✅ 识别消息发送者 ✅ 实现访问控制 ✅ 提供个性化服务
同样也可以点击【开通权限】按钮手动操作，在这儿我就不在多加演示。
1.5 启用机器人能力
在应用能力 > 机器人页面：
开启机器人能力
配置机器人名称和头像
1.6 提交发布申请
在版本管理与发布页面：
选择创建版本
填写版本号等信息后发布
1.7 配置事件订阅
⚠️前提条件：
已运行openclaw channels add添加飞书渠道
网关处于启动状态（openclaw gateway status检查）
在事件订阅页面：
选择使用长连接接收事件（WebSocket 模式）
添加事件：im.message.receive_v1
点击添加事件按钮：
然后再搜索框搜索：im.message.receive_v1
选中接受消息权限，点击右下角添加按钮：
步骤 2：配置 OpenClaw
2.1 打开配置界面
访问 OpenClaw Control UI：
http://127.0.0.1:18789/ # 或你的公网地址：https://XXX.XXX.XXX.XXX:XXXX/
2.2 添加飞书渠道
在文章开头如果已经设置好了，这儿可以直接跳过，下面讲的是在可视化界面上的一个操作，如果文章开头部分没有操作，也可以根据命令进行添加相关操作：
openclaw config set channels.feishu.appId "XXXXXX" openclaw config set channels.feishu.appSecret "XXXXXX" openclaw config set channels.feishu.enabled true openclaw config set channels.feishu.connectionMode websocket
App ID和App Secret换成你们自己的就可以。
如果文章开头已经创建，但是想要更换，可以如下操作进行：
1、进入设置→渠道→飞书(需要已经添加了飞书渠道，如果没有可以直接执行命令添加相应数据即可)
2、填入信息：
App ID：步骤 1.3 获取的 App ID
App Secret：步骤 1.3 获取的 App Secret
Encrypt Key：可选（加密验证）
Verification Token：用于验证回调
3、保存配置
2.3 配置访问控制
在openclaw.json中添加允许的用户/群组：
{
"channels": {
"feishu": {
"enabled": true,
"appId": "cli_xxx",
"appSecret": "xxx",
"allowFrom": [
"feishu:ou_xxx" // 你的用户 ID
],
"groupPolicy": "allowlist",
"groupAllowFrom": [
"feishu:oc_xxx" // 群组 ID
]
}
}
}步骤 3：启动并测试
3.1 启动网关
openclaw gateway start
3.2 查看日志
openclaw logs --follow
寻找类似这样的成功信息：
feishu ws connected feishu provider ready
3.3 测试连接在
飞书中找到你的机器人
发送一条消息：你好
确认收到回复
第一次需要配对，所以返回的消息是带有Pairing code的，需要去授权配对：
openclaw pairing approve feishu XXX
把XXX替换成你的code即可。
🔧 高级配置
获取群组/用户 ID
方法一：通过日志获取
在日志中查找消息记录：
feishu sendMessage ok chat=ou_xxx message=123
方法二：通过 API 获取
# 获取用户 ID curl-X GET "https://open.feishu.cn/open-apis/contact/v3/users/me"\ -H"Authorization: Bearer $(openclaw feishu token)" # 获取群组 ID curl-X GET "https://open.feishu.cn/open-apis/im/v1/chats"\ -H"Authorization: Bearer $(openclaw feishu token)"
多账号配置
在openclaw.json中配置多个飞书账号：
{
"channels": {
"feishu_main": {
"enabled": true,
"appId": "cli_xxx1",
"appSecret": "xxx1",
"accountId": "main"
},
"feishu_test": {
"enabled": true,
"appId": "cli_xxx2",
"appSecret": "xxx2",
"accountId": "test"
}
}
}多 Agent
配置配合飞书使用多 Agent（小墨、小文、小 C）：
{
"agents": {
"main": {
"id": "main",
"bindings": ["feishu_main"]
},
"writer": {
"id": "writer",
"bindings": ["feishu_writer"]
},
"tech": {
"id": "tech",
"bindings": ["feishu_tech"]
}
}
}❓ 常见问题
问题 1：机器人无法响应
排查步骤：
✅ 检查 App ID 和 App Secret 是否正确
✅ 确认权限是否已添加（特别是 contact:contact.base:readonly）
✅ 验证网关是否启动（openclaw gateway status）
✅ 查看日志中的错误信息
问题 2：长连接配置失败
原因：网关未启动或渠道未添加
解决方法：
# 1. 先添加渠道 openclaw channels add # 2. 启动网关 openclaw gateway start # 3. 再配置事件订阅 # （在飞书开放平台操作）
问题 3：访问控制不生效
检查配置：
{
"channels": {
"feishu": {
"allowFrom": [
"feishu:ou_xxx" // 确保格式正确
],
"groupPolicy": "allowlist" // 或 "open"
}
}
}
📊 配置检查清单
在开始测试前，请确认：
已创建飞书应用
已获取 App ID 和 App Secret
已添加必需权限
已启用机器人能力
已配置事件订阅（长连接）
已在 OpenClaw 配置飞书渠道
网关已启动
已配置访问控制
日志显示feishu provider ready
🎯 下一步
配置完成后，你可以：
私聊机器人- 一对一对话
拉入群组- 团队协作用
配置多 Agent- 不同场景用不同助手
集成 Ontology- 结构化知识管理
还没有评论，来说两句吧...