：gateway.cmd闪退的排查与修复)
1. openclaw 安装卡在 Health check failed: gateway closed(1006) 到底发生了什么如果你正在 Windows 上装 openclaw命令行里突然蹦出Health check failed: gateway closed(1006)同时一个gateway.cmd黑框一闪就没了那这篇就是写给你的。openclaw 是一个把本地能力文件、命令、浏览器等通过网关暴露给 AI 客户端的工具安装时它会拉起一个本地 gateway 进程再由主程序做健康检查。所谓 1006是 WebSocket 异常关闭的状态码翻译成人话就是gateway 进程根本没起来或者起来后立刻死了健康检查连不上它。而gateway.cmd闪退正是这个进程启动失败的直观表现。这个报错适合谁适合所有在 Windows 上第一次装 openclaw、被这个黑框闪退卡住的人尤其是用户名或安装路径里带中文、空格、特殊符号的同学。我实测下来90% 的 1006 都不是 openclaw 本身的 bug而是启动环境的问题Node/npm 路径编码、gateway 配置项、端口占用、环境变量缺失。下面我按「先定位、再修配置、最后验证」的顺序把每一步都写成可以直接复制的命令你跟着做基本能恢复安装流程。2. 先别急着重装用日志把 gateway 闪退原因抓出来gateway.cmd闪退最坑的地方是窗口关得太快你根本看不到报错。所以第一步不是改配置而是让错误留下来。2.1 用 status 命令看网关真实状态打开 PowerShell先执行openclaw gateway status如果 gateway 没起来你大概率会看到类似gateway closed (1006)或connection refused的输出。这一步只是确认「确实没起来」真正的线索在日志里。2.2 手动运行 gateway.cmd别让它闪退找到 openclaw 安装目录下的gateway.cmd一般在%USERPROFILE%\.openclaw\或 npm 全局目录里不要双击而是在 PowerShell 里手动跑这样窗口不会关cd $env:USERPROFILE\.openclaw .\gateway.cmd这时候报错会停在屏幕上。常见的几类Error: Cannot find module xxx依赖没装全npm 全局路径有问题。EADDRINUSE端口被占用。路径里出现乱码或??用户名含中文导致 Node/npm 路径编码崩溃这是最高频的元凶。直接无输出退出环境变量缺失比如NODE_PATH没配。2.3 把输出重定向到文件方便反复看如果手动跑还是看不清用重定向把 stdout 和 stderr 都存下来.\gateway.cmd * gateway-error.log Get-Content .\gateway-error.log拿到具体报错后再对照下面章节修。记住不要跳过这一步直接改配置否则你只是在猜。3. 用 TaoToken 统一 Key 与 API 通道先把网关连通性核对清楚在修 gateway 之前有个容易被忽略的点openclaw 的 gateway 启动时可能会去校验上游 API 通道。如果你的 Key 或 API 地址配得不对gateway 也可能启动即退出。这时候用 TaoToken 把 Key 和 API 通道统一管理能帮你快速排除「是不是通道问题」。TaoToken 是一个统一管理模型 Key 和 API 通道的平台适合需要同时接多个模型、又不想在每台机器上散落配置的人。你可以先到官网了解整体能力https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 然后在控制台创建 Key控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API Keyshttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content拿到 Key 后openclaw 的 gateway 配置里把 API 基址指向 TaoToken 的 API 入口注意 API 地址不带 UTMhttps://taotoken.net/api这样做的价值是网关启动时校验的是同一条通道如果 gateway 还是闪退你就能确定问题在本地环境而不是 Key。想先验证模型通道是否通可以直接用模型对话页发一条测试消息模型对话https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content如果对话页能正常返回说明 Key 和通道没问题问题就锁定在 gateway 本地启动环节继续往下修。4. 可复制的 gateway 启动配置与修复步骤这一节是核心按顺序做每步都有验证。4.1 修复中文用户名导致的路径编码崩溃这是 1006 最常见的根因。Windows 用户名含中文时npm 全局路径会带中文Node 在解析时编码出错gateway 直接崩。解决办法是把 npm 全局路径和缓存路径改到纯英文目录npm config set prefix C:\nodejs\npm-global npm config set cache C:\nodejs\npm-cache然后把这个路径加进环境变量PATH[Environment]::SetEnvironmentVariable( Path, $env:Path ;C:\nodejs\npm-global, User )改完关掉所有终端重新开一个再确认npm config get prefix where.exe openclawwhere.exe输出的路径必须是纯英文。如果还指向中文目录说明旧路径没清干净手动去「系统属性 → 环境变量」里删掉带中文的那条。4.2 补全 gateway 启动配置在%USERPROFILE%\.openclaw\下找到或新建gateway.json写入下面这份可复制配置把 Key 换成你自己的{ gateway: { host: 127.0.0.1, port: 8787, logLevel: debug, autoRestart: true }, api: { baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, timeout: 30000 } }几个关键点host用127.0.0.1而不是localhost避免 IPv6 解析问题port选一个不常用的比如 8787logLevel设成debug方便下次排错autoRestart打开gateway 崩了会自动拉起。4.3 检查端口占用如果报EADDRINUSE先看 8787 被谁占了netstat -ano | findstr :8787拿到 PID 后tasklist | findstr PID如果是无关进程换端口即可如果是残留的 gateway 进程直接结束taskkill /PID PID /F4.4 重装依赖并重启 gateway路径修好后重装一次全局依赖确保模块完整npm install -g openclaw --force openclaw gateway restart--force是为了覆盖之前编码损坏的安装。重启后观察gateway.cmd是否还闪退。5. 验证请求确认 gateway 真的活了修完必须验证别只看窗口没闪退就以为好了。5.1 用 status 确认健康检查通过openclaw gateway status正常应该输出running或healthy不再有 1006。5.2 直接打健康检查接口gateway 起来后用 curl 打它的健康端点curl http://127.0.0.1:8787/health返回{status:ok}就说明网关本身通了。5.3 核对上游通道再确认 gateway 能连上 TaoToken 通道用一条最小请求curl https://taotoken.net/api/v1/models -H Authorization: Bearer sk-你的TaoToken密钥能返回模型列表说明 Key 和通道都正常。如果这一步失败回到第 3 节检查 Key 和 baseUrl。想更直观地验证用模型对话页发一条消息最快https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content5.4 完整跑一次安装流程最后重新执行 openclaw 的安装命令确认不再出现Health check failed: gateway closed(1006)。如果安装脚本还会拉起 gateway观察日志里是否还有异常退出。6. 本篇常见错排查清单把上面踩过的坑整理成对照表下次直接查现象根因修复gateway.cmd 闪退无输出用户名含中文npm 路径编码崩溃改 npm prefix/cache 到纯英文目录报 EADDRINUSE端口被占用netstat 找 PID换端口或 killCannot find module依赖装到中文路径或装不全npm install -g openclaw --forcestatus 一直 1006gateway.json 缺失或 host 写 localhost用 127.0.0.1补全配置通道校验失败Key 或 baseUrl 错用 TaoToken 统一 KeybaseUrl 指向 /api几个额外提醒改完环境变量一定要重开终端否则读的还是旧值gateway.json里的 Key 不要提交到 Git如果公司网络有限制确认 8787 端口没被安全软件拦。7. 长期跑 openclaw 编码与 Agent建议用 Coding Plan 统一管理如果你不只是装一次而是打算长期用 openclaw 做编码、跑 Agent 任务那 Key 和通道的管理会越来越重要。散落在各处的 Key 一旦过期或额度用完gateway 又会以各种奇怪的方式退出。这时候用 TaoToken 的 Coding Plan 把长期编码和 Agent 场景的额度、通道统一起来能省掉很多「明明配置没改却突然 1006」的排查时间Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content接入细节和参数说明看官方文档里面有完整的配置示例接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content如果你用的是 Claude Code 这类客户端Anthropic 兼容接入的说明也在这里ClaudeCodeAnthropichttps://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content最后说个我自己的习惯每次改完 gateway 配置先跑openclaw gateway status再跑一次 curl 健康检查两个都过了再动别的。这样即使后面出问题你也能确定是「新改动引入的」而不是在一堆变量里瞎猜。
