来源基于官方教程优化✨更新2026-03-10目标30 分钟内完成飞书机器人配置 飞书的优势优势说明现代化办公文档协作、多维表格、视频会议高效沟通消息卡片、互动组件、流式输出开发友好API 设计优秀、文档详细、WebSocket 长连接免费使用功能强大、稳定可靠 快速开始2 种方式方式一安装向导推荐新手openclaw setup向导会自动引导你完成✅ 创建飞书应用并获取凭证✅ 配置应用凭证✅ 启动网关方式二命令行添加推荐老手openclaw channelsadd然后根据提示选择Feishu输入 App ID 和 App Secret。低版本的在这里选择Download fron npm高版本已经内置了选择Use local plugin path 即可根据提示输入飞书获取的信息即可。 详细配置步骤步骤 1创建飞书应用1.1 访问飞书开放平台国内版https://open.feishu.cn/app国际版https://open.larksuite.com/app配置时需设置domain: lark1.2 创建应用点击创建企业自建应用填写应用名称如 “OpenClaw 助手”选择应用图1.3 获取应用凭证在凭证与基础信息页面复制App ID格式如cli_xxxApp 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]}}必需权限说明权限标识用途是否必需im:message接收和发送消息✅ 必需im:message:send_as_bot以机器人身份回复✅ 必需contact:contact.base:readonly识别用户身份✅ 必需为什么需要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配置 OpenClaw2.1 打开配置界面访问 OpenClaw Control UIhttp://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 websocketApp ID和App Secret换成你们自己的就可以。如果文章开头已经创建但是想要更换可以如下操作进行进入设置→渠道→飞书(需要已经添加了飞书渠道如果没有可以直接执行命令添加相应数据即可)填入信息App ID步骤 1.3 获取的 App IDApp Secret步骤 1.3 获取的 App SecretEncrypt Key可选加密验证Verification Token用于验证回调保存配置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 start3.2 查看日志openclaw logs--follow寻找类似这样的成功信息feishu ws connected feishu provider ready3.3 测试连接在飞书中找到你的机器人发送一条消息你好确认收到回复第一次需要配对所以返回的消息是带有Pairing code的需要去授权配对openclaw pairing approve feishu XXX把XXX替换成你的code即可。 高级配置获取群组/用户 ID方法一通过日志获取在日志中查找消息记录feishu sendMessage ok chatou_xxx message123方法二通过 API 获取# 获取用户 IDcurl-XGEThttps://open.feishu.cn/open-apis/contact/v3/users/me\-HAuthorization: Bearer$(openclaw feishu token)# 获取群组 IDcurl-XGEThttps://open.feishu.cn/open-apis/im/v1/chats\-HAuthorization: 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 channelsadd# 2. 启动网关openclaw gateway start# 3. 再配置事件订阅# 在飞书开放平台操作问题 3访问控制不生效检查配置{channels:{feishu:{allowFrom:[feishu:ou_xxx// 确保格式正确],groupPolicy:allowlist// 或 open}}} 安全配置配置项建议App Secret妥善保管不要提交到 GitHTTPS生产环境建议使用 HTTPSVerification Token定期更换权限范围遵循最小权限原则访问控制配置 allowFrom 白名单 配置检查清单在开始测试前请确认已创建飞书应用已获取 App ID 和 App Secret已添加必需权限已启用机器人能力已配置事件订阅长连接已在 OpenClaw 配置飞书渠道网关已启动已配置访问控制日志显示feishu provider ready 下一步配置完成后你可以私聊机器人- 一对一对话拉入群组- 团队协作用配置多 Agent- 不同场景用不同助手集成 Ontology- 结构化知识管理