如果你是中国用户，飞书通常是最值得先跑通的第一个平台。
飞书这条路的优势很明显：官方文档相对完整、团队协作场景很常见、第一次跑通的成功率也通常比钉钉和微信系更高。你只要按顺序走完这篇，通常就能让机器人在私聊和群聊里真正回话。
开始前先记住 2 个关键点
很多旧教程的问题，不是命令错了，而是这两个前提没讲清楚。
飞书接入整条线就是这 6 步
你可以先扫一遍，再往下按步骤做。
第 1 步：在飞书开放平台创建应用
先打开 飞书应用管理入口，然后按顺序做：
- 点击“创建企业应用”。
- 填写应用名称、描述和图标。
- 创建完成后，在“凭证与基础信息”里复制：
- App ID
- App Secret
- 在“应用能力”里启用 机器人。
如果你用的是国际版 Lark，对应入口通常是 open.larksuite.com，后面配置时 domain 一般要填 lark。
先把这几组链接存好
飞书接入时，最常来回跳的其实不是命令，而是平台入口、模型入口和案例参考。为了减少你中途反复找链接，这里先集中放好。
飞书官方入口
火山引擎与豆包模型入口
站内案例与延伸阅读
第 2 步：导入权限并发布应用
飞书官方文档当前推荐通过“批量导入”一次性加权限。进入“权限管理”，点击“批量导入”，粘贴官方示例 JSON：
{
"scopes": {
"tenant": [
"aily:file:read",
"aily:file:write",
"application:application.app_message_stats.overview:readonly",
"application:application:self_manage",
"application:bot.menu:write",
"contact:user.employee_id:readonly",
"corehr:file:download",
"event:ip_list",
"im:chat.access_event.bot_p2p_chat:read",
"im:chat.members:bot_access",
"im:message",
"im:message.group_at_msg:readonly",
"im:message.p2p_msg:readonly",
"im:message:readonly",
"im:message:send_as_bot",
"im:resource"
],
"user": [
"aily:file:read",
"aily:file:write",
"im:chat.access_event.bot_p2p_chat:read"
]
}
}导入完权限以后，别忘了继续做这一步：
- 进入“版本管理与发布”。
- 创建新版本。
- 提交并发布。
如果你是企业环境，可能还要等管理员审批；明明都配好了却完全没反应时，优先先回来看应用是不是真的已经发布成功。
第 3 步：在 OpenClaw 里添加 Feishu 渠道
这一步建议直接用 CLI，而不是手写配置项。当前官方推荐命令是：
openclaw channels add运行后选择 Feishu，然后依次填写：
- App ID
- App Secret
- domain
国内飞书一般保持默认即可；如果你用的是国际版 Lark，再填lark。
根据当前官方文档，最新版安装里通常已经带上 Feishu 插件；如果你是旧版本或自定义安装，才需要手动装：
openclaw plugins install @openclaw/feishu第 4 步：确认 Gateway 在运行
飞书长连接要保存成功，Gateway 必须先处于正常运行状态。先执行：
openclaw gateway status
openclaw logs --follow如果渠道刚添加完、配置有改动，最稳的做法是再执行一次：
openclaw gateway restart不要再用一些旧教程里的 openclaw restart 说法，这在当前官方 CLI 里不是最清楚、也不是最稳定的写法。
第 5 步：回到飞书开启事件订阅
这一步要放在 OpenClaw 渠道配置之后。进入飞书应用的“事件与回调”，按下面设置：
- 选择 使用长连接接收事件（WebSocket）。
- 添加事件
im.message.receive_v1。 - 保存。
这里是整篇里最关键的顺序点之一：先跑 openclaw channels add，确认 Gateway 正常，再保存长连接事件订阅。如果先在飞书里乱点，后面很容易遇到“保存了但就是不通”的假成功状态。
第 6 步：做第一次配对
现在去飞书里找到你的机器人，给它发一条私聊消息，例如“你好”。默认情况下，机器人不会直接回复完整答案，而是回一个 8 位短配对码。
这时在终端里执行：
openclaw pairing list feishu
openclaw pairing approve feishu <CODE>把 <CODE> 替换成刚才飞书私聊里看到的配对码。批准后，这个用户的私聊就放开了。
这里也要纠正一个常见误区：不是把机器人发来的一整段内容原样复制到终端执行，而是查看待处理配对请求，然后用 pairing approve 批准对应的 code。
第 7 步：测试私聊和群聊
私聊测试
私聊里发一条最简单的消息，例如“你好，我是测试消息”。如果模型和渠道都正常，机器人就应该开始回复。
群聊测试
把机器人加进群后，在群里 @它 发送消息。当前默认组策略里，Feishu 群聊通常是：
groupPolicy: "open"：允许群消息requireMention: true：默认要求 @ 提及
所以“机器人在线但群里不回话”不一定是坏了，也可能只是你没有 @ 它。
如果向导之外你更想看配置长什么样
当前官方文档里的配置文件结构大致是这样：
{
channels: {
feishu: {
enabled: true,
dmPolicy: "pairing",
accounts: {
main: {
appId: "cli_xxx",
appSecret: "xxx",
botName: "My AI assistant"
}
}
}
}
}也就是说，当前结构更接近 channels.feishu.accounts.main.appId 这种写法，而不是很多旧稿里那种简单的 channels.feishu.appId / channels.feishu.appSecret 两行配置。
怎样才算接入成功
不要只看“平台保存成功”或者“状态显示 connected”，真正的成功标准是下面这些现象都能出现：
- Gateway 状态正常
- 飞书事件订阅已保存且应用已发布
- 私聊能先拿到配对码并顺利批准
- 批准后私聊能正常回复
- 群聊里 @ 机器人时也能收到回复
常见问题排查
机器人完全不回复
- 先看应用是否已经发布。
- 再看 App ID / App Secret 有没有粘贴错。
- 确认飞书事件订阅选的是长连接，不是随手点成了 HTTP 回调。
- 执行
openclaw gateway status看网关是否正常。
私聊里只有配对码，没有正常聊天
这通常不是故障，而是默认安全策略。执行：
openclaw pairing list feishu
openclaw pairing approve feishu <CODE>群里不回复
先确认你有没有 @ 机器人。Feishu 默认群聊通常要求 mention；没有 @ 时，看起来就像“机器人没工作”。
看起来连上了，但行为不对
官方故障排查页给出的命令顺序很实用，建议直接按这个梯子跑：
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe下一步怎么走
- 如果飞书已经跑通，继续看 多渠道并行配置技巧，把第二个平台也接上。
- 如果你想先看另一种国内办公路线，继续读 钉钉机器人接入。
- 如果你更想看一篇社区整理版实战案例，直接看 案例：飞书官方插件安装与更新。
- 如果你准备把飞书和国产模型一起配顺，继续看 中国主流模型接入，重点关注火山引擎和豆包路线。