1. 装完 OpenClaw 中文版之后，为什么 npm、cmd、飞书三处总有一个不通
OpenClaw 中文版在 Windows 上装完，真正让人抓狂的往往不是安装本身，而是装完之后那几处「看起来都对、跑起来就报错」的环节。我自己在 Windows 上把 OpenClaw 中文版从零装到能跟飞书机器人对话，中间踩的坑基本集中在三个地方：npm 全局路径冲突导致openclaw-cn命令找不到、cmd 环境变量没生效导致网关起不来、飞书机器人回调失败导致手机端发消息没反应。这三个问题表面上是三件事，底层其实是同一条链路——命令能不能被找到、网关能不能被访问、外部平台能不能回调进来。
这篇就聚焦「装完之后」的排障，不重复安装步骤。核心思路是：把 OpenClaw 中文版里所有需要填 Base URL 和 Key 的地方，统一指向 TaoToken 的 API 地址，用同一个 Key 打通 npm 侧的命令行、cmd 里的网关进程、以及飞书机器人的回调配置。这样你只需要维护一份凭证，出问题时排查范围也小很多。
适合谁看：已经在 Windows 上装完 OpenClaw 中文版、openclaw-cn命令能跑但网关或飞书不通的人；或者装完后发现 npm 全局包路径和系统 Path 对不上、cmd 里openclaw-cn gateway报「不是内部或外部命令」的人。下面按「先修命令、再修配置、最后联调飞书」的顺序来，每一步都有可复制的命令和配置片段。
先说清楚一个概念，避免后面混淆。OpenClaw 中文版在 Windows 上跑起来，涉及三个独立进程或入口：一个是 npm 全局安装的 CLI（openclaw-cn），一个是网关进程（openclaw-cn gateway），一个是飞书侧的长连接回调。CLI 负责孵化机器人和管理配置，网关负责实际收发消息，飞书负责把手机端的消息推给网关。三者任何一个断了，表现都是「发消息没反应」，但原因完全不同。所以排障第一步永远是确认你现在卡在哪一层。
我实测下来，最常见的误判是：以为飞书回调失败是飞书配置问题，结果查半天发现是本地网关根本没起来。所以下面会先给一套「逐层验证」的命令，让你能快速定位到底断在哪一层，再针对性修。
2. 把 Base URL 和 Key 统一到 TaoToken 的前置准备
在动配置之前，先把凭证准备好。OpenClaw 中文版默认可能接的是某个内置模型服务，但如果你想统一管理、并且让 npm 侧、cmd 侧、飞书侧用同一套凭证，建议把 Base URL 改到 TaoToken。TaoToken 是一个模型 API 聚合入口，你可以在它的控制台里创建 API Key，然后所有需要填 Base URL 的地方都填同一个地址。
具体操作：打开 TaoToken 官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite ，注册后在控制台里创建一个 API Key。控制台地址是 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite ，API Key 管理页在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 。创建好之后把 Key 复制出来，后面配置里会反复用到。
这里要强调一点：TaoToken 的 API 地址是 https://taotoken.net/api ，注意这个地址不带任何查询参数，配置里填的就是这个。很多人会把官网地址和 API 地址搞混，填成官网首页，结果请求 404。记住：官网是给人看的，API 是给程序调的，两者不是一回事。
准备好 Key 之后，先别急着改 OpenClaw 的配置。先用一条最简单的 curl 命令验证这个 Key 能不能通。打开 cmd，执行：
curl -X POST https://taotoken.net/api/v1/chat/completions ^ -H "Authorization: Bearer 你的Key" ^ -H "Content-Type: application/json" ^ -d "{\"model\":\"gpt-4o-mini\",\"messages\":[{\"role\":\"user\",\"content\":\"ping\"}]}"如果返回里有choices字段，说明 Key 和网络都通。如果返回 401，说明 Key 错了或者没带上；如果返回连接超时，说明网络层有问题，先解决网络再往下走。这一步是整个链路的地基，地基不通，后面配什么都没用。
为什么要先做这一步？因为 OpenClaw 中文版的报错信息经常很模糊，网关起不来可能报的是「连接失败」，但到底是 Key 错还是网络错，它不告诉你。先用 curl 把变量隔离出来，后面排查就能少走弯路。我试过直接改配置然后启动网关，结果报错信息指向飞书，查了半天才发现是 Key 里多了一个空格。这种低级错误用 curl 一步就能避免。
另外提醒一下，TaoToken 的模型对话入口在 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=chat&utm_campaign=rewrite ，你可以在网页上先试试模型能不能正常回复，确认账号状态没问题。如果你后面要长期跑编码类 Agent 任务，可以了解下 Coding Plan：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite ，不过这篇先聚焦排障，不展开。
3. 可复制配置：settings.json 与 Base URL 改到 TaoToken
OpenClaw 中文版在 Windows 上的配置文件主要在用户目录下的.openclaw文件夹里。默认路径是C:\Users\你的用户名\.openclaw\。这里面有几个关键文件，其中settings.json是主配置，模型相关的 Base URL 和 Key 就在这里改。
先找到配置文件。打开 cmd，执行：
dir %USERPROFILE%\.openclaw你会看到类似settings.json、agents、sessions等条目。用记事本或 VS Code 打开settings.json。如果文件不存在，说明安装时没生成，可以手动创建一个。下面是一份可复制的最小配置片段，把 Base URL 指向 TaoToken，Key 换成你自己的：
{ "model": { "provider": "openai-compatible", "baseUrl": "https://taotoken.net/api", "apiKey": "你的TaoToken Key", "modelId": "gpt-4o-mini" }, "gateway": { "port": 18789, "host": "127.0.0.1" }, "feishu": { "enabled": true, "appId": "你的飞书AppID", "appSecret": "你的飞书AppSecret" } }这里有几个点要特别注意。第一，baseUrl填的是https://taotoken.net/api，不要在后面加/v1，OpenClaw 内部会自己拼路径。如果你填成https://taotoken.net/api/v1，请求会变成/api/v1/v1/chat/completions，直接 404。第二，modelId要填 TaoToken 支持的模型 ID，比如gpt-4o-mini、claude-3-5-sonnet等，填错了会报模型不存在。第三，gateway.port默认是 18789，如果你本地这个端口被占用，改成别的，但后面飞书回调地址也要跟着改。
改完settings.json之后，还有一处容易漏：npm 全局包的路径。OpenClaw 中文版是通过 npm 全局安装的，npm 的全局 prefix 如果没加到系统 Path 里，cmd 里就找不到openclaw-cn命令。先查一下 npm 的全局路径：
npm config get prefix假设返回的是C:\Users\你的用户名\AppData\Roaming\npm，把这个路径加到系统环境变量 Path 里。操作步骤：Win 键搜索「环境变量」→ 打开「编辑系统环境变量」→ 点「环境变量」→ 在「用户变量」里找到 Path → 双击 → 新建 → 粘贴刚才的路径 → 确定。加完之后一定要开一个新的 cmd 窗口，旧窗口不会自动刷新环境变量。
验证是否生效：
where openclaw-cn如果返回了路径，说明命令能被找到了。如果返回「信息: 用提供的模式无法找到文件」，说明 Path 还没生效，检查是不是加到了「系统变量」而不是「用户变量」，或者是不是没开新窗口。
还有一处配置在agents目录下。如果你用了多个 Agent，每个 Agent 可能有自己的模型配置。路径是C:\Users\你的用户名\.openclaw\agents\main\，里面的配置文件也要检查一遍，确保 Base URL 和 Key 跟主配置一致。不一致的话，会出现「主配置能通、某个 Agent 不通」的诡异现象。
如果你用的是 Claude Code 类的接入方式，配置在~/.claude/settings.json或项目级的.claude/settings.json，格式类似，Base URL 同样填https://taotoken.net/api。Claude Code 的接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，里面有更详细的字段说明。ClaudeCodeAnthropic 的专用入口在 https://taotoken.net/claudecode-anthropic?utm_source=taotoken_aicg_blog_end&utm_content=claudecode-anthropic&utm_campaign=rewrite ，需要的话可以对照看。
配置改完，先别急着启动网关。用一条命令验证配置文件是不是合法 JSON：
type %USERPROFILE%\.openclaw\settings.json | findstr /C:"baseUrl"如果能看到baseUrl那一行，说明文件读得到。JSON 语法错误的话，OpenClaw 启动时会直接报解析失败，所以改完最好用在线 JSON 校验工具过一遍，或者用 VS Code 打开看有没有红色波浪线。
4. 逐条验证：cmd 启动网关并确认通道连通
配置改好之后，进入验证阶段。这一步的目标是：确认网关能起来、确认网关能连上 TaoToken、确认飞书能回调进来。三条命令，逐条执行，每条都有明确的成功标志。
第一条，启动网关。打开一个新的 cmd 窗口，执行：
openclaw-cn gateway成功的话，你会看到类似Gateway listening on 127.0.0.1:18789的输出，并且窗口会保持运行状态，不退出。如果报「不是内部或外部命令」，回到上一节检查 Path。如果报端口被占用，改settings.json里的gateway.port，或者用netstat -ano | findstr 18789找到占用进程并结束它。
第二条，验证网关到 TaoToken 的连通性。再开一个新的 cmd 窗口（网关那个窗口不要关），执行：
curl -X POST http://127.0.0.1:18789/v1/chat/completions ^ -H "Content-Type: application/json" ^ -d "{\"model\":\"gpt-4o-mini\",\"messages\":[{\"role\":\"user\",\"content\":\"你好\"}]}"注意这里请求的是本地网关的端口，不是直接请求 TaoToken。如果返回里有choices字段，说明网关已经成功把请求转发到 TaoToken 并拿到了回复。如果返回 502 或连接失败，说明网关到 TaoToken 这一段有问题，回到settings.json检查baseUrl和apiKey。如果返回 401，说明 Key 无效，重新去 TaoToken 控制台确认。
第三条，验证飞书回调。这一步需要飞书侧配合。先在飞书开放平台找到你的应用，确认「事件订阅」里的请求地址填的是你的网关地址。本地开发时，飞书无法直接回调127.0.0.1，所以你需要一个公网可达的地址。常见做法是用内网穿透工具把本地 18789 端口暴露出去，然后把飞书的事件订阅地址填成穿透后的地址。注意：这里不展开穿透工具的具体品牌和配置，你按自己习惯的方式把本地端口暴露即可。
飞书侧配置检查清单：
| 检查项 | 正确状态 | 常见错误 |
|---|---|---|
| 事件订阅地址 | 指向网关公网地址 + 回调路径 | 填了 127.0.0.1，飞书访问不到 |
| 权限开通 | 消息收发、事件订阅权限全开 | 只开了部分，发消息提示权限不足 |
| 应用发布 | 已发布版本 | 停在草稿状态，手机端搜不到 |
| 机器人启用 | 机器人功能已开启 | 没开机器人，无法对话 |
| 加密密钥 | 与 OpenClaw 配置一致 | 两边不一致，回调验签失败 |
飞书侧配好之后，在手机飞书里给机器人发一条「你好」。如果网关窗口里能看到请求日志，说明回调通了。如果手机端提示「权限未开放」，回到飞书开放平台把权限全部开通，然后重新发布版本。如果手机端一直转圈没反应，检查网关窗口有没有收到请求，没收到就是回调地址不对，收到了但没回复就是网关到 TaoToken 这一段有问题。
这里有个细节：飞书的事件订阅有验签机制，OpenClaw 中文版会处理验签，但前提是settings.json里的appSecret和飞书开放平台里的一致。如果验签失败，飞书会认为你的服务不可信，直接拒绝回调。所以改配置时，appId和appSecret一定要从飞书开放平台复制准确，不要手打。
三条验证都通过之后，整个链路就通了：手机飞书 → 飞书服务器 → 你的网关 → TaoToken → 模型 → 原路返回。任何一环断了，表现都是「发消息没反应」，但通过上面三条命令，你能快速定位断在哪一环。
5. 本篇常见报错排查：401、local proxy failed、reading choices、OAuth
排障的核心是看懂报错。下面列几个高频报错，以及对应的原因和修法。这些报错我在不同机器上反复遇到过，基本覆盖了 90% 的「装完不通」场景。
报错一：401 Unauthorized
完整报错通常长这样：{"error":{"message":"Invalid API key","type":"invalid_request_error"}}。原因就一个：Key 不对。可能是 Key 复制时多了空格、Key 过期了、或者 Key 根本没填对地方。修法：回到settings.json，检查apiKey字段，确保没有前后空格。然后用第 2 节的 curl 命令直接测 TaoToken，确认 Key 本身有效。如果 curl 能通但网关报 401，说明网关读的配置不是你改的那个文件，检查是不是有多个settings.json，或者 Agent 级配置覆盖了主配置。
报错二：local proxy failed
这个报错在 Windows 上特别常见，完整信息类似local proxy failed: dial tcp 127.0.0.1:18789: connectex: No connection could be made。原因是网关没起来，或者端口不对。修法：确认openclaw-cn gateway那个窗口还在运行，没被关掉。确认settings.json里的gateway.port和你在 curl 里请求的端口一致。如果网关窗口报端口被占用，换一个端口，比如 18790，然后所有地方同步改。
报错三：reading choices
完整报错类似failed to parse response: reading choices: unexpected end of JSON input。这个报错的意思是：网关收到了响应，但响应不是合法的 JSON，解析choices字段时失败了。常见原因有两个：一是 Base URL 填错了，请求打到了某个返回 HTML 的地址，比如填成了官网首页；二是模型 ID 填错了，TaoToken 返回了一个错误信息，但格式不是标准的choices结构。修法：确认baseUrl是https://taotoken.net/api，确认modelId是 TaoToken 支持的模型。用第 2 节的 curl 直接测 TaoToken，看返回结构是不是标准的choices。
报错四：OAuth 相关错误
如果你在配置飞书时看到 OAuth 报错，比如OAuth token exchange failed或invalid app credentials，原因是飞书的appId或appSecret不对，或者应用没发布。修法：回到飞书开放平台，重新复制appId和appSecret，确保和settings.json里一致。确认应用已经发布，草稿状态的应用无法完成 OAuth。如果飞书侧改了权限，需要重新发布版本才能生效。
报错五：npm 命令找不到
'openclaw-cn' 不是内部或外部命令，也不是可运行的程序。原因是 npm 全局路径没加到 Path，或者加了但没开新窗口。修法：npm config get prefix拿到路径，加到用户变量 Path，开新 cmd 窗口，用where openclaw-cn验证。
报错六：飞书回调验签失败
飞书侧提示「回调地址校验失败」或「签名不匹配」。原因是appSecret不一致，或者网关没正确处理验签。修法：确认settings.json里的appSecret和飞书开放平台一致。确认网关窗口在运行，飞书发起的验签请求能被网关收到。如果网关收到了但验签失败，检查系统时间是否准确，时间偏差过大会导致签名计算错误。
排查时有个通用技巧：把网关窗口的日志级别调高。OpenClaw 中文版支持通过环境变量控制日志，在启动网关前执行set OPENCLAW_LOG=debug，然后再openclaw-cn gateway，这样能看到更详细的请求和响应日志，定位问题快很多。
另外，如果你在配置过程中遇到 Claude Code 相关的 OAuth 问题，可以参考 ClaudeCodeAnthropic 的接入文档：https://taotoken.net/claudecode-anthropic?utm_source=taotoken_aicg_blog_end&utm_content=claudecode-anthropic&utm_campaign=rewrite ，里面有专门的 OAuth 配置说明。通用的接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，遇到字段不确定时对照看。
6. 通道打通之后：把 Key 和配置固定下来
三条验证都通过、飞书能正常对话之后，还有几件事值得做，能让你后面少返工。
第一，把settings.json备份一份。Windows 上.openclaw目录容易被误删，或者重装时被覆盖。复制一份到别的目录，改名为settings.json.bak。下次出问题可以直接对比。
第二，把 npm 全局路径和网关端口记下来。这两个值在排障时反复用到。npm 全局路径用npm config get prefix查，网关端口在settings.json里。建议写在一个文本文件里，放在桌面。
第三，飞书侧的权限和版本管理。飞书应用每次改权限都要重新发布，发布后手机端才能生效。如果你后面要加新功能，记得走一遍「改权限 → 重新发布 → 手机端验证」的流程。
第四，Key 的轮换。TaoToken 的 API Key 如果泄露了，去控制台重新生成一个，然后更新settings.json里的apiKey，重启网关即可。不需要改其他地方，因为所有地方用的都是同一个 Key。
如果你后面要长期跑编码类任务，可以了解下 Coding Plan：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite ，它适合需要持续调用模型的 Agent 场景。日常验证模型是否正常，可以用模型对话入口：https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=chat&utm_campaign=rewrite 。API Key 管理在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite ，接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。
最后说一个我踩过的坑：有次网关跑得好好的，第二天开机发现飞书又不通了。查了半天，发现是 Windows 更新后把环境变量 Path 重置了，npm 全局路径没了。所以如果你遇到「昨天还好好的，今天突然不通」，第一件事就是where openclaw-cn看命令还在不在。这种系统级变动在 Windows 上不算罕见，养成「先查命令、再查配置、最后查网络」的习惯，能省很多时间。
