1. Windows 上 OpenClaw 接入飞书到底难在哪如果你在 Windows 上折腾过 OpenClaw 接入飞书大概率会遇到这么几个卡点飞书开放平台的应用权限配了一堆事件订阅选了长连接却收不到消息OpenClaw 侧 channel 配置写进去了gateway 重启后日志里报local proxy failed或者干脆没反应最烦的是每接一个新工具就要重新配一套 Key飞书一套、模型一套、其他 channel 又一套散落在各个配置文件里改一个忘一个。这篇就是来解决这些问题的。OpenClaw 是一个支持多渠道接入的 AI 助手网关飞书是它常用的消息通道之一适合想把 AI 助手接进企业协作工具、又不想自己从零写消息中间件的开发者。Windows 环境下它的坑比 Linux 多一些主要是路径、服务重启方式和终端命令的差异。核心思路是飞书侧负责应用创建、权限、事件订阅OpenClaw 侧负责 channel 配置和 gateway 运行而模型调用这一层用 TaoToken 统一 Key 来打通。这样你飞书机器人背后调用的模型通道只有一个入口不用在 OpenClaw 里为每个模型单独维护一堆 API Key。我试过把飞书 channel 和模型 Key 分开管理结果就是每次换模型都要翻好几个配置文件。后来统一走 TaoToken 的 KeyOpenClaw 里只认一个 base URL 和一个 Key清爽很多。下面按飞书应用准备、TaoToken 前置、OpenClaw 配置、验证、排障的顺序走一遍你可以直接跟着操作。2. 飞书应用创建与权限配置清单这一步在飞书开放平台完成地址是https://open.feishu.cn/app。登录后点「创建企业自建应用」填应用名称比如「智能助手」、描述、图标创建完成。2.1 添加机器人能力进入应用管理页左侧导航栏找「添加应用能力」在列表里选「机器人」点添加。没有这一步后面消息事件订阅了也没法以机器人身份收发消息。2.2 拿 App ID 和 App Secret左侧「凭据与基础信息」栏目页面里能看到 App ID 和 App Secret分别复制保存。App ID 一般是cli_开头App Secret 只显示一次丢了要重置。这两个值后面填进 OpenClaw 的 channel 配置。2.3 事件订阅选长连接左侧「事件与回调」订阅方式选「长连接」保存。长连接的好处是不需要你暴露公网回调地址Windows 本地跑 OpenClaw 也能收到飞书推送这对没有公网 IP 的开发机很关键。然后点「添加事件」在「消息与群组」分类下勾选「接收消息」确定。这样机器人才能收到用户发的消息。2.4 批量导入权限左侧「权限管理」点「批量/导入权限」把下面这段 JSON 贴进去{ scopes: { tenant: [ contact:user.base:readonly, im:chat, im:chat:read, im:chat:update, im:message, im:message.group_at_msg:readonly, im:message.p2p_msg:readonly, im:message:send_as_bot, im:resource, contact:contact.base:readonly ], user: [] } }点确定开通。这几个权限覆盖了读取用户基础信息、收发单聊和群聊消息、以机器人身份发送消息、读取消息资源。少一个都可能导致消息发出去但收不到回复。2.5 发布应用左侧「版本管理与发布」点「创建版本」填版本号和描述保存并发布。企业自建应用发布后需要管理员在飞书管理后台审核通过如果是你自己的测试企业通常自己就能通过。发布这一步不做机器人在工作台里看不到也没法正常收发。注意权限和事件配置改完后一定要重新发布版本否则改动不生效。这是很多人配完发现没反应的第一大原因。3. TaoToken 统一 Key 与 OpenClaw 配置模板飞书侧准备好后回到 OpenClaw。先装飞书插件openclaw plugins install openclaw/feishu3.1 为什么用 TaoToken 统一 KeyOpenClaw 背后要调大模型来生成回复。如果你直接填各家模型的原始 Key换模型就得改配置、重启 gateway。TaoToken 提供统一的 API 入口一个 Key 走所有模型通道OpenClaw 里只需要配一个 base URL 和一个 Key。TaoToken 的 API 地址是https://taotoken.net/apiKey 在控制台的 API Keys 页面创建。创建后复制保存格式通常是一串sk-开头的字符串。3.2 OpenClaw 的模型通道配置OpenClaw 的模型配置一般在它的主配置文件里Windows 下通常在用户目录的.openclaw文件夹。你需要把模型 provider 的 base URL 指向 TaoTokenKey 填 TaoToken 的 KeyModel ID 填你要用的模型标识。三件套缺一不可Base URLhttps://taotoken.net/apiAPI Key你在 TaoToken 控制台创建的 KeyModel ID比如claude-sonnet-4-5或你账号下可用的模型标识一个典型的配置片段JSON 形式具体字段名以你 OpenClaw 版本为准{ models: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, model: claude-sonnet-4-5 } }3.3 飞书 channel 配置OpenClaw 提供两种配置飞书的方式。方式一是通过 OpenClaw Manager 图形界面进入配置项找到飞书配置页填 App ID、App Secret 等信息{ channels: { feishu: { enabled: true, appId: cli_你的AppID, appSecret: 你的AppSecret, domain: feishu, groupPolicy: open, dmPolicy: open, allowFrom: [*], streaming: true, blockStreaming: true } } }填完点 save再点 update 重启 OpenClaw gateway 服务生效。方式二是终端命令。安装插件后执行openclaw channels add选择 Yes 以及「飞书」按 Enter 确认输入 App ID 和 App Secret选择「Feishu (feishu.cn) - China」群内响应按需选择点 Finished 完成。其他可选项先选 No后续按需再配。然后重启网关openclaw gateway restart提示groupPolicy和dmPolicy控制群聊和单聊的响应策略测试阶段设成 open 方便验证上线前按实际需求收紧。allowFrom里的*表示允许所有来源生产环境建议改成具体用户或群 ID。4. 启动网关并验证飞书消息收发配置写完后重启网关让所有改动生效。Windows 下建议用 stop 再 start 的方式比单纯 restart 更干净openclaw gateway stop openclaw gateway start启动后看日志确认飞书 channel 加载成功、模型通道连接正常。如果日志里出现飞书 channel 已启用、长连接已建立之类的信息说明基础链路通了。4.1 首次配对打开飞书 App进入工作台找到你发布的应用给机器人发一条消息。首次发消息时机器人会返回一个配对码类似Pairing code: XXXXX这是 OpenClaw 的安全机制防止未授权的用户直接使用机器人。你需要在服务器终端执行配对命令openclaw pairing approve:feishu XXXXX把 XXXXX 换成实际收到的配对码。配对成功后机器人就能正常接收和回复消息了。4.2 验证消息链路再给机器人发一条消息比如「你好」。如果配置正确机器人会调用 TaoToken 通道背后的模型生成回复并返回给你。收到回复就说明整条链路通了飞书 → OpenClaw 飞书 channel → 模型通道TaoToken→ 回复 → 飞书。你可以多发几条不同类型的消息测试比如在群里 机器人、发图片等验证权限是否覆盖完整。如果单聊正常但群聊没反应多半是群聊权限或 groupPolicy 的问题。5. 常见报错排查对照配的过程中最容易撞上这几类报错逐个对照排查。401 Unauthorized模型通道鉴权失败。检查 TaoToken 的 Key 是否复制完整、有没有多余空格base URL 是否是https://taotoken.net/api。如果 Key 刚创建确认账号状态正常。飞书侧如果报 401检查 App ID 和 App Secret 是否填反或填错。local proxy failedOpenClaw 本地代理启动失败通常是端口被占用或 gateway 没正常退出。先openclaw gateway stop确认进程退干净再openclaw gateway start。Windows 下可以用任务管理器看有没有残留的 node 进程。reading choices 相关报错模型返回格式不符合预期多半是 Model ID 填错或者 TaoToken 通道下该模型不可用。换一个确认可用的 Model ID 再试同时确认 base URL 没有多写路径。OAuth 相关报错飞书应用授权问题。检查应用是否已发布并通过审核权限是否批量导入成功事件订阅是否选了长连接。OAuth 报错经常是因为应用版本没重新发布改动没生效。收不到消息按顺序查——事件订阅是否加了「接收消息」、订阅方式是否长连接、权限是否包含im:message系列、应用是否发布、gateway 是否重启。这五步任何一步漏了都会导致收不到。能收不能回检查im:message:send_as_bot权限是否开通机器人能力是否添加。发送消息需要单独的发送权限很多人只配了接收权限。6. 把 Key 收拢到一处后续扩展更省心飞书通道跑通之后你会发现 OpenClaw 里真正需要维护的凭证就两类飞书的 App ID/App Secret和模型通道的 TaoToken Key。前者是通道身份后者是模型入口。把模型入口统一到 TaoToken 之后以后再加别的 channel比如其他协作工具模型这层不用动只配通道本身就行。如果你后面要长期跑编码类或 Agent 类任务可以考虑 TaoToken 的 Coding Plan把模型调用额度集中管理。需要新建 Key 或查看用量去控制台 API Keys 页面操作接入细节和参数说明看接入文档想先验证模型回复效果可以直接在模型对话页面试。飞书通道这边建议把allowFrom从*收紧到具体用户或群避免机器人被无关人员触发。最后留一个实用习惯每次改完飞书权限或事件配置先重新发布版本再重启 OpenClaw gateway然后发一条测试消息确认。这三步固定下来能省掉大部分「配了没反应」的排查时间。