1. OpenClaw 在 Windows 上接飞书卡住你的往往不是飞书OpenClaw 是一个可以跑在 Windows 上的开源智能体网关它能把你常用的聊天工具变成 AI 的入口飞书机器人就是其中最典型的一种玩法。很多人搜「OpenClaw Windows 飞书接入」真正想解决的问题其实是让飞书里那个机器人真的能回消息而不是装完插件、填完 App ID 之后发消息石沉大海。我实测下来绝大多数失败案例都不是飞书那边配错了而是 OpenClaw 本身还没有一个可用的大模型通道——机器人收到了消息却不知道该把消息发给谁去生成回复。所以这篇的视角很明确先把 OpenClaw 的模型通道打通再走飞书 channel 的完整配置。模型这一步我落到 TaoToken 上打开 https://taotoken.net/ 创建一个 Key回填到 OpenClaw 的模型配置里后面飞书的消息来回就由这个通道调用模型生成回复消耗的 Token 也在这里结算。适合谁看已经在 Windows 上装好 OpenClaw、飞书账号也有但机器人不回话或者正准备从零把这条链路一次配通的人。下面按「先模型、后飞书」的顺序走每一步都给到可复制的命令和配置。2. 先给 OpenClaw 一个能用的模型通道TaoToken 前置OpenClaw 的定位是「网关」它自己不生产模型能力只负责把消息路由到模型、再把结果送回聊天工具。所以飞书机器人能不能回消息第一前提是 OpenClaw 的模型配置指向一个真实可用的接口。TaoToken 在这里扮演的就是这个模型通道你在官网创建 API Key把它填进 OpenClaw 的模型配置OpenClaw 每次收到飞书消息就通过这个 Key 去请求模型拿到回复再发回飞书。这一步的关键动作只有两个拿 Key、回填。拿 Key 的入口在 https://taotoken.net/api 登录后进控制台创建具体页面是 https://taotoken.net/console Key 的管理在 https://taotoken.net/api-keys 。创建完先复制保存后面配置里要用。这里提醒一句Key 只在创建时完整显示一次页面刷新后就看不全了所以复制到记事本这一步别省。回填的位置取决于你用哪种方式管理 OpenClaw。如果你用 OpenClaw Manager 图形界面就在模型配置页填 Base URL 和 API Key如果你习惯改配置文件就找到模型 provider 那一段。下面给一份可直接对照的配置结构字段名以你本地版本为准重点是 baseUrl 指向 TaoToken 的 API 地址、apiKey 填你刚创建的 Key{ models: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, model: claude-sonnet-4-5, maxTokens: 4096 } }填完之后不要急着去配飞书先单独验证模型通道通不通。OpenClaw 一般提供命令行对话或健康检查你可以先用它发一句测试确认能拿到模型回复再去接飞书。这样出问题时你能立刻判断是模型层还是飞书层省掉大量来回排查的时间。模型通道确认可用后再进入飞书部分。3. 飞书侧创建应用、拿凭证、装插件、配 channel飞书这一侧的动作比较多但顺序是固定的建应用 → 加机器人能力 → 拿 App ID/App Secret → 装 OpenClaw 飞书插件 → 配 channels.feishu → 配事件和权限 → 发版本。任何一步漏了最后都会表现为「机器人不回消息」。3.1 创建企业自建应用并添加机器人能力打开飞书开放平台 https://open.feishu.cn/app 登录后点「创建企业自建应用」填应用名称、描述、图标创建完成。进入应用管理页左侧导航找到「添加应用能力」在列表里选「机器人」点添加。这一步是让这个应用具备收发消息的身份没有它后面的事件订阅无从谈起。3.2 获取 App ID 和 App Secret在应用管理页左侧找到「凭据与基础信息」页面里的 App ID 和 App Secret 就是 OpenClaw 要用的两个凭证。分别复制保存。App Secret 属于敏感信息别贴到公开仓库或截图里。3.3 安装飞书插件并配置 channels.feishu在 Windows 终端执行插件安装openclaw plugins install openclaw/feishu安装完成后配置 channel。OpenClaw 提供两种方式图形界面和终端命令选一种即可。方式一OpenClaw Manager进入配置项找到飞书配置页填入 App ID、App Secret保存后点 update 重启 gateway 生效。对应的配置结构大致如下{ channels: { feishu: { enabled: true, appId: cli_你的AppID, appSecret: 你的AppSecret, domain: feishu, groupPolicy: open, dmPolicy: open, allowFrom: [*], streaming: true, blockStreaming: true } } }方式二终端命令执行openclaw channels add选择 Yes 和「飞书」按提示输入 App ID 和 App Secret域名选国内飞书Feishu (feishu.cn) - China群内响应按需选择其余可选项先选 No后续再调。完成后重启网关openclaw gateway restart3.4 事件订阅、权限导入与版本发布回到飞书应用管理页左侧「事件与回调」订阅方式选「长连接」并保存。然后点「添加事件」在「消息与群组」分类里勾选「接收消息」确定。长连接方式不需要你暴露公网回调地址对 Windows 本地环境很友好。接着进「权限管理」点「批量/导入权限」粘贴下面这段 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: [] } }最后进「版本管理与发布」创建版本、填版本号和描述保存并发布。应用没发布机器人对普通成员不可见测试时会找不到入口。4. 验证在飞书里发一条消息看它是否回配置全部完成后重启一次网关确保加载最新配置openclaw gateway stop openclaw gateway start打开飞书 App进工作台找到刚发布的应用给机器人发一条消息。首次对话通常会收到一个配对码形如Pairing code:XXXXX这是 OpenClaw 的安全机制需要在终端执行配对命令openclaw pairing approve:feishu XXXXX配对通过后再发消息如果收到模型生成的回复说明整条链路通了飞书把消息推给 OpenClawOpenClaw 通过 TaoToken 的模型通道生成回复再发回飞书。消息来回消耗的 Token 由 TaoToken 结算你可以在控制台看到用量。如果没回复先看终端日志有没有报错再对照下一节的排查项。5. 本篇常见错排查机器人完全没反应终端也没日志。大概率是事件订阅没配好或者订阅方式没选长连接。回飞书「事件与回调」确认「接收消息」已添加、订阅方式为长连接然后重启网关。收到配对码但配对后仍不回。检查配对命令里的 ID 是否和收到的配对码完全一致包括前缀。另外确认应用已发布未发布的应用在部分场景下消息推送会被限制。报模型相关错误比如鉴权失败或找不到模型。这是模型通道的问题不是飞书的问题。回到第 2 节确认 baseUrl 指向 https://taotoken.net/api 、apiKey 是有效 Key、model 名称拼写正确。可以先用命令行单独测模型排除飞书干扰。群里 机器人不回私聊正常。看 channels.feishu 里的 groupPolicy 和 allowFrom 配置。群内响应策略如果设成了不响应或者 allowFrom 没放开群消息就不会被处理。按需调整后重启网关。改了配置不生效。OpenClaw 的 channel 配置改动后需要重启 gateway图形界面里是点 update终端里是openclaw gateway restart。只保存不重启旧配置还在内存里跑。6. 把模型通道和飞书 channel 一次配通整条链路其实就两段模型段和飞书段。模型段的核心是拿到一个可用的 Key 并回填入口在 https://taotoken.net/api 创建 Key 在 https://taotoken.net/api-keys 配置文档在 https://taotoken.net/doc 。飞书段的核心是应用凭证、插件、channel 配置、事件权限、发布这五件事缺一不可。两段都通了飞书机器人回消息就是水到渠成的事。如果你后面要长期跑编码类或 Agent 类任务消息量大、调用频繁可以了解下 Coding Plan入口在 https://taotoken.net/coding-plan 适合把模型通道固定下来长期用。想先验证模型回复效果、不急着接飞书的可以直接在模型对话页试地址是 https://taotoken.net/chat 。配置过程中遇到接入或排障问题优先看接入文档 https://taotoken.net/doc 大部分报错在里面都有对应说明。