1. 为什么要在 Windows 上折腾飞书远程控机飞书远程控机这件事本质上是把飞书当成一个遥控器把 Windows 电脑当成被遥控的家电。你在飞书聊天窗口里发一句打开记事本家里的电脑就真的把记事本打开了你发一句把 D 盘下载文件夹按类型整理一下它也能照做。OpenClaw 就是中间那个翻译官负责把飞书的自然语言消息翻译成 Windows 上的具体操作。这套方案适合谁我总结下来是三类人一是经常在外面跑、但需要临时操作家里或公司 Windows 主机的人二是手里有好几个 AI 工具、Key 散落在各个配置文件里、每次换工具都要重新找 Key 的人三是想拿飞书机器人做点自动化、又不想自己写一整套后端服务的人。它的核心检索词就是飞书 OpenClaw Windows 配置你搜到这篇说明你大概率已经卡在某一步了。真正让人头疼的其实不是飞书那边的配置飞书开放平台虽然步骤多但每一步都有明确指引。麻烦的是 OpenClaw 这边它要调用大模型来理解你的指令而大模型通道如果每个工具都单独配一套 Key你的config.toml和settings.json会变成一锅粥。今天用这个模型的 Key明天换那个模型的 Key改到后面自己都记不清哪个 Key 对应哪个工具。所以这篇的重点除了把飞书机器人跑通还要把 API 通道统一到 TaoToken 一个 Key 上让 OpenClaw 只认一个入口。下面我按先解决 Key 分散问题再打通飞书链路的顺序来写每一步都给可复制的配置和验证动作。你跟着做基本能一次跑通。2. 前置准备TaoToken 统一 Key 与 OpenClaw 环境在动飞书之前先把 OpenClaw 的模型通道理顺。OpenClaw 要理解你的自然语言指令必须调用大模型而调用大模型需要一个 API 入口。传统做法是每个模型厂商单独申请 Key然后在 OpenClaw 里配一堆 provider。问题是 OpenClaw 的配置文件对多 provider 的支持虽然能用但维护起来很累尤其是你同时用 Claude、GPT 这类模型做不同任务时。TaoToken 在这里的角色就是一个统一的 API 入口。你只需要在 TaoToken 上拿到一个 Key然后在 OpenClaw 里把这个 Key 填到对应位置OpenClaw 就能通过这一个通道调用后端支持的模型。这样你的config.toml里模型相关的配置就只有一份不用来回切换。具体操作先访问 TaoToken 官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册并登录然后进入控制台创建 API Key。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 在 API Keys 页面点创建复制生成的 Key形如sk-xxxxxxxx。这个 Key 就是你后面要填进 OpenClaw 的唯一凭证。注意Key 只在创建时完整显示一次复制后先存到记事本里别关页面就忘了。OpenClaw 本身需要先装好并保持 Gateway 在线。Windows 10 和 Windows 11 都可以安装过程这里不展开你确保装完后托盘图标是绿色、Gateway 状态显示在线即可。飞书账号个人版和企业版都行企业版需要你有应用开发权限个人版配置完立即生效企业版要等管理员审核。环境清单我列一下你对照检查项目要求说明操作系统Windows 10 / 11保持网络畅通OpenClaw已安装且 Gateway 在线配置期间不要关闭飞书账号个人版或企业版企业版需开发权限TaoToken Key已创建并复制统一模型通道用飞书开放平台可登录open.feishu.cn3. 可复制配置config.toml 与 settings.json 骨架OpenClaw 的配置分两块一块是模型通道通常写在config.toml里另一块是聊天渠道凭证飞书的 App ID 和 App Secret 会写进settings.json或通过界面保存。我先把两份骨架给你你按自己的路径替换。config.toml的核心是把模型 provider 指向 TaoToken 的 API 地址并把 Key 填进去。TaoToken 的 API 入口是 https://taotoken.net/api 注意这个地址不带任何查询参数直接作为 base_url 使用。# config.toml - OpenClaw 模型通道配置 [model] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoTokenKey model claude-3-5-sonnet [gateway] host 127.0.0.1 port 8765 enabled true [logging] level info这里provider用openai-compatible是因为 TaoToken 的 API 兼容 OpenAI 的调用格式OpenClaw 走这个协议最省事。model字段填你想用的模型名具体支持哪些模型可以在 TaoToken 的模型对话页面查看地址是 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 页面上会列出当前可用的模型标识。settings.json这块主要放飞书渠道的凭证。OpenClaw 的界面保存后其实也是写进这个文件你手动改也行但建议先用界面保存一次再对照着改避免格式错误。{ channels: { feishu: { enabled: true, app_id: cli_你的AppID, app_secret: 你的AppSecret, event_mode: long_connection, receive_event: im.message.receive_v1 } }, gateway: { auto_start: true } }event_mode填long_connection是关键飞书的长连接模式不需要公网域名对家用 Windows 主机特别友好。receive_event填im.message.receive_v1这是接收消息 v2.0 的事件标识必须和飞书后台订阅的事件一致否则消息进不来。提示两份配置改完后先别急着启动把 Key 和 App Secret 里的空格检查一遍粘贴时最容易带进首尾空格。4. 飞书开放平台配置与回调验证飞书这边的配置链路比较长我按顺序拆成几个动作你一步步来。第一步登录飞书开放平台 https://open.feishu.cn 用飞书账号扫码或密码登录开发者后台。然后创建企业自建应用应用类型选企业自建应用不用上架配置完就能用。应用名称建议带上 OpenClaw 字样比如OpenClaw 控制机器人方便后面在飞书里搜索。第二步添加机器人能力。进入应用配置页左侧点添加应用能力选机器人点添加。出现机器人配置项就说明加成功了。第三步导入权限。左侧点权限管理选批量导入/导出权限选应用身份权限把下面这段 JSON 粘进去点格式化 JSON再点下一步确认新增权限并申请开通。{ scopes: { tenant: [ im:message, im:message:send_as_bot, im:message:readonly, im:message:update, im:chat, im:chat:read, im:chat.members:read, contact:user.base:readonly, contact:user.id:readonly, docs:document.content:read, drive:file:readonly, drive:file:download ], user: [] } }这段权限比原版精简了很多只保留了远程控机真正需要的消息收发、用户信息读取和文件读取权限。原版那一大串 base、bitable、wiki 权限对控机场景基本用不上申请太多反而拖慢审核。个人账号申请后立即生效企业账号要等管理员审核。第四步配置事件订阅。左侧点事件与回调选事件配置订阅方式选使用长连接接收事件点保存。然后点添加事件搜索接收消息 v2.0勾选im.message.receive_v1完成添加。这一步是回调验证的核心长连接模式下飞书会主动和 OpenClaw 建立 WebSocket 连接不需要你配公网回调地址。第五步发布应用。左侧点版本管理与发布创建版本版本号填 1.0.0更新说明写首次配置飞书机器人功能移动端和桌面端默认能力都选机器人保存后点确认发布。个人未认证账号发布后立即生效企业账号等管理员审核。第六步拿凭证。左侧点凭证与基础信息复制 App ID 和 App Secret填进前面settings.json的对应位置或者打开 OpenClaw 设置里的聊天渠道找到 Feishu 选项粘贴进去保存后重启 OpenClaw。5. 验证请求与成功结果配置完别急着发复杂指令先用最小动作验证链路通不通。重启 OpenClaw确认 Gateway 在线。然后打开飞书 PC 端或手机端搜索你创建的机器人名称进入聊天窗口发送一句最简单的指令打开记事本如果机器人回复已执行或类似确认并且你的 Windows 屏幕上真的弹出了记事本说明整条链路通了。这一步验证的是飞书消息 → 长连接 → OpenClaw → 模型理解 → Windows 执行 → 结果回传飞书。如果没反应先别改配置用下面这个命令在 Windows PowerShell 里直接测 TaoToken 通道是否正常curl https://taotoken.net/api/v1/chat/completions ^ -H Content-Type: application/json ^ -H Authorization: Bearer sk-你的TaoTokenKey ^ -d {\model\:\claude-3-5-sonnet\,\messages\:[{\role\:\user\,\content\:\ping\}]}返回里有choices字段和内容说明 TaoToken 通道没问题问题在飞书或 OpenClaw 侧。如果返回 401说明 Key 错了返回 404说明模型名写错了去模型对话页面核对一下。再验证一个文件操作指令确认 OpenClaw 不只是能开程序在 D 盘创建一个 test 文件夹成功后去 D 盘看文件夹应该已经建好了。这两个动作都通过你的远程控机就算跑通了。6. 本篇常见错排查配置过程中最容易卡的就那么几个点我按出现频率排一下。机器人无响应先查应用是否已发布且审核通过企业账号尤其要确认管理员点了通过。再查权限是否全部开通有没有漏申请的。然后核对 App ID 和 App Secret粘贴时带空格是最常见的坑。最后重启 OpenClaw确认 Gateway 在线。收不到消息事件订阅方式必须是长连接接收事件改完要重新保存。检查im.message.receive_v1是否已添加没添加就补上。如果 OpenClaw 日志里能看到连接建立但收不到消息多半是事件没订阅对。模型调用报错config.toml里的base_url必须是https://taotoken.net/api不要多加/v1或斜杠。api_key确认是 TaoToken 控制台创建的 Key不是别的平台的。模型名去模型对话页面核对大小写和连字符都要一致。长连接频繁断开Windows 防火墙可能拦了 OpenClaw 的出站连接把 OpenClaw 加入防火墙白名单。另外确认网络没有做端口限制长连接走的是标准 WebSocket 端口。指令执行了但结果不对这通常是模型理解偏差不是配置问题。把指令写得更具体比如打开 D 盘的 report.xlsx比打开那个表格靠谱得多。如果长期需要复杂指令可以考虑在 TaoToken 上换一个理解能力更强的模型在模型对话页面切换后同步改config.toml里的model字段。7. 长期编码与 Agent 场景的通道选择如果你不只是拿飞书控机做简单操作而是想让 OpenClaw 长期跑编码任务、做 Agent 自动化那模型通道的稳定性和成本就变得很重要。这种情况下TaoToken 的 Coding Plan 会更合适它针对长时间、高频次的编码类调用做了优化地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。配置方式和你现在用的一样还是把config.toml里的base_url指向https://taotoken.net/apiKey 换成 Coding Plan 对应的 Key 即可。OpenClaw 侧不用改任何东西飞书链路也保持不变。这样你从远程控机平滑过渡到远程 Agent底层通道是同一套。如果你用的是 Claude Code 这类工具配合 OpenClaw接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面有不同工具的接入示例可以对照着调。API Keys 管理页面还是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 需要新建或轮换 Key 都在这里操作。整套跑下来我的经验是飞书那边的配置一次配好基本不用动真正需要维护的就是 TaoToken 这一个 Key。哪天想换模型改config.toml里一行model字段就行不用碰飞书后台也不用重新发布应用。这种一个 Key 管所有的结构才是远程控机长期用下去不折腾的关键。