1. 为什么我要在 Windows 上折腾 OpenClaw 和飞书OpenClaw 是一个可以跑在自己电脑上的 AI 助手网关它能把你常用的聊天工具比如飞书和背后的大模型 API 连起来让你在飞书里直接跟 AI 对话、让它帮你处理消息。适合谁适合想拥有一个「私人 AI 助理」但又不想买服务器、不想写太多代码的普通用户尤其是 Windows 用户。我这次的目标很明确在 Windows 上把 OpenClaw 本地部署跑起来然后接入飞书机器人最后用 TaoToken 的统一 Key 把模型通道配好实现飞书里发消息、AI 正常回复。整个过程我踩了不少坑最典型的就是「之前装过旧版结果新版装不上」还有「飞书长连接没配对好消息发出去石沉大海」。所以这篇记录会按真实操作顺序来先清理旧环境再装 Node.js/npm然后装 OpenClaw接着配飞书机器人最后把 TaoToken 的 Key 填进 settings.json 并验证连通性。每一步我都会给出可复制的命令和配置片段你照着做基本能一次跑通。需要提前说明的是OpenClaw 的安装脚本和飞书后台的页面会来回跳第一次操作容易晕。我的建议是先把飞书机器人建好但先别急着设订阅方式等 OpenClaw 这边通道配好了再回去设这样能少走弯路。下面正式开始。2. 前置准备TaoToken 统一 Key 与 API 通道在配 OpenClaw 之前先把模型通道准备好。我用的是 TaoToken 的统一 Key好处是一个 Key 可以走多个模型不用在 OpenClaw 里来回换配置。你需要先拿到两样东西API Key 和 API 地址。API 地址是https://taotoken.net/api这个地址在 OpenClaw 的 settings.json 里会用到。API Key 的获取入口在控制台的 API Keys 页面登录后新建一个 Key 复制出来就行。如果你还没注册可以从官网进https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。注册完进控制台找到 API Keys 菜单点新建把生成的 Key 存到记事本里后面配置要用。这里有个细节TaoToken 的 Key 是统一通道也就是说你不需要为每个模型单独申请 Key。OpenClaw 里配置模型时只要把 base_url 指向 TaoToken 的 API 地址把 api_key 填成你刚复制的 Key模型名按 TaoToken 支持的写就行。这样后面你想换模型只改模型名不用动 Key。如果你更想先验证模型能不能通可以先用模型对话页面发一条测试消息确认 Key 有效再往下走。入口在模型对话登录后直接选模型发消息即可。确认没问题后我们再进 OpenClaw 的配置环节。3. 可复制配置Windows 环境、OpenClaw 安装与 settings.json3.1 清理旧版 OpenClaw 和 Node.js如果你之前装过 OpenClaw一定要先卸干净否则二次安装会直接复用旧配置跳过重新配置流程。我当时的报错就是装完发现还是老配置根本没让我重新填。先在管理员模式的 PowerShell 里执行卸载命令如果还记得安装方式npm uninstall -g openclaw然后手动删掉残留目录。打开文件资源管理器进入你的用户目录找到.openclaw文件夹整个删除。再去 npm 的全局目录里找openclaw和openclaw.cmd两个文件删掉。npm 全局目录可以用下面命令查npm root -g把输出的路径复制到资源管理器地址栏进去后删掉 openclaw 相关文件。Node.js 和 npm 如果也要重装去控制面板卸载 Node.js然后手动删掉C:\Program Files\nodejs和用户目录下的.npmrc、node_modules残留。3.2 安装 Node.js 与 npmNode.js 是 JavaScript 的运行环境npm 是包管理工具OpenClaw 依赖它们。去 Node.js 官网下载 Windows 的 LTS 版本安装包双击一路下一步即可安装时勾选「Add to PATH」。装完后 npm 会自动带上。验证安装node -v npm -v两条命令都能输出版本号就说明环境 OK。如果node -v报「不是内部或外部命令」说明 PATH 没配好重新装一遍并确认勾选 Add to PATH。3.3 安装 OpenClaw用管理员模式打开 PowerShell执行官方安装脚本iwr -useb https://openclaw.ai/install.ps1 | iex安装完成后OpenClaw 会引导你进入配置流程。这里先配一个能跑通的模型我建议直接用 TaoToken 的统一 Key。配置时它会问你 API 地址和 Key分别填base_url: https://taotoken.net/api api_key: 你的 TaoToken Key model: 按 TaoToken 支持的模型名填写配置完成后重启网关openclaw gateway restart3.4 settings.json 配置片段OpenClaw 的配置文件在用户目录下的.openclaw文件夹里文件名是settings.json。你可以直接用记事本打开编辑重点是模型通道和飞书通道两块。模型部分参考下面这段{ models: { default: { baseUrl: https://taotoken.net/api, apiKey: 你的 TaoToken Key, model: 你的模型名 } } }飞书通道部分需要填 App ID 和 App Secret这两个值来自飞书开放平台下一节会讲怎么拿。先留好位置{ channels: { feishu: { appId: cli_xxxxxxxx, appSecret: xxxxxxxxxxxxxxxx } } }改完 settings.json 后一定要重启网关让配置生效openclaw gateway restart4. 飞书机器人接入与连通性验证4.1 创建飞书机器人并拿凭证去飞书开放平台创建一个企业自建应用进入应用后找到「凭证与基础信息」里面就有 App ID 和 App Secret。把这两个值复制到上面 settings.json 的 feishu 通道里。同时在这个页面把能配的基础信息先配好比如应用名称、图标然后先发布一个测试版本。注意先不要急着设订阅方式等 OpenClaw 这边通道配好再回来设否则长连接容易对不上。4.2 添加飞书插件并检查通道在 PowerShell 里执行下面三条命令重启网关、刷新飞书通道、查看通道列表openclaw gateway start openclaw channels restart feishu openclaw channels list看最后一条命令的输出里有没有feishu。如果有说明通道已经加载成功可以继续。如果没有检查 settings.json 里的 appId 和 appSecret 是否填对以及有没有重启网关。4.3 设置长连接与事件订阅这一步是重中之重我前几次失败都卡在这里。回到飞书开放平台进入「事件订阅」页面选择「使用长连接接收事件」。然后把「消息与群组」相关的事件都勾上为了方便我全选了。确认添加后再次申请发布应用。长连接的作用是让飞书主动把消息推给本地 OpenClaw不需要公网地址。如果你这里选的是 Webhook 而不是长连接本地服务收不到消息就会一直没反应。4.4 配对码匹配与消息验证发布通过后在飞书 App 里搜索你刚发布的机器人进入对话随便发一条消息。首次发送时机器人会返回一个配对码。把这个配对码复制到 PowerShell 里执行配对命令按 OpenClaw 提示操作即可。配对成功后再发消息机器人就能正常回复了。验证连通性时你可以发一句「你好」看是否返回 AI 回复。如果返回的是模型错误说明 TaoToken 的 Key 或模型名有问题如果完全没反应说明长连接或事件订阅没配好。5. 本篇常见错排查问题一二次安装跳过配置流程。原因是旧版 OpenClaw 没卸干净.openclaw文件夹或 npm 全局目录里的 openclaw 文件还在。解决方法是按 3.1 节彻底删除再重新安装。问题二openclaw channels list里没有 feishu。检查 settings.json 里 feishu 通道的 appId 和 appSecret 是否填对以及有没有执行openclaw gateway restart。如果配置文件名或路径不对OpenClaw 读不到也不会报错。问题三飞书发消息没反应。九成是长连接没设。回飞书开放平台确认事件订阅选的是「长连接接收事件」并且消息与群组事件已勾选、应用已重新发布。另外确认配对码已经完成匹配。问题四模型返回鉴权失败。检查 TaoToken 的 Key 是否复制完整base_url 是否是https://taotoken.net/api。如果 Key 没问题去模型对话页面发一条消息确认 Key 本身有效。问题五node -v或npm -v报错。Node.js 没装好或 PATH 没配。重装 Node.js 并勾选 Add to PATH装完重启 PowerShell。问题六想重新配置 OpenClaw。直接执行openclaw onboard可以重新进入配置流程。想打开网页控制台用openclaw dashboard。6. 配好之后怎么继续用整套跑通后你其实已经拥有了一个本地 AI 网关飞书负责收发消息OpenClaw 负责调度TaoToken 负责模型通道。后面想换模型只改 settings.json 里的模型名Key 和地址不用动。想加别的聊天通道也是同样的思路在 channels 里加配置再重启网关。如果你打算长期在本地跑编码或 Agent 类任务可以考虑用 Coding Plan 把额度固定下来比每次单独申请更省事。配置过程中如果遇到通道或 Key 的问题直接去 API Keys 页面重新生成一个 Key 替换再对照接入文档检查参数格式。模型本身的行为想快速验证用模型对话页面最直接不用每次都走飞书绕一圈。
