OpenClaw故障自动诊断及修复工具

>> 自动诊断并修复 OpenClaw 网关无法启动、网页无法访问的问题，专治中文 Windows 用户名路径乱码导致的静默启动失败，并支持一键配置开机自启。 ----------------------------- ### 完整介绍 # 🔧 OpenClaw Gateway Fixer **让 OpenClaw 网页永远打得开。** ------------------------------------------ ## 你遇到过这些问题吗？ - OpenClaw 网页突然打不开，一片空白或连接超时？ - 双点 `gateway.cmd`，什么都没发生，没有任何错误提示？ - 系统更新或重装后，OpenClaw 彻底无法启动？ - 浏览器提示「网关令牌缺失 (gateway token missing)」，但 token 明明是对的？ **`openclaw-gateway-fixer` 一键帮你搞定。** ------------------------------------------- ## ✅ 核心功能 | 功能 | 说明 | |------|------| | 🔍 一键全面诊断 | 6 项自动检查：进程状态、端口监听、gateway.cmd 编码、Node.js 路径、openclaw.json 配置、HTTP 响应 | | 🛠️ 自动修复中文乱码 | 识别并修复 Windows 中文用户名（如 `吴清能`）在 `gateway.cmd` 中被错误编码为乱码（`鍚存竻鑳絓`）的问题 | | 🚀 绕过故障脚本直接启动 | 当 `gateway.cmd` 彻底损坏时，直接调用 Node.js 启动网关，无需手动修改任何文件 | | 🔇 生成静默启动脚本 | 生成 `.vbs` 启动脚本，运行时不弹黑色 CMD 窗口，体验丝滑 | | 🔄 配置开机自动启动 | 一键创建 Windows 任务计划，登录后自动延迟 15 秒启动网关，重启电脑无需任何手动操作 | -------------------------------- ## 🎯 适用人群 - 使用 **中文 Windows 用户名** 的 OpenClaw 用户（问题高发群体） - 经常遇到 OpenClaw 网页打不开的 AI 开发者 - 希望 OpenClaw 开机**零维护自动运行**的用户 --- ## 🚀 安装使用 **安装技能（WorkBuddy）：** ``` /skills # 上传 openclaw-gateway-fixer.zip ``` **或直接让 AI 使用：** > "我的 OpenClaw 网页打不开，帮我诊断一下" AI 会自动加载本技能并完整执行诊断修复流程。 **手动运行脚本：** ```powershell # 全面诊断 powershell -ExecutionPolicy Bypass -File diagnose.ps1 # 修复中文乱码 powershell -ExecutionPolicy Bypass -File fix-gateway-cmd.ps1 # 直接启动网关 powershell -ExecutionPolicy Bypass -File start-gateway.ps1 # 配置开机自启 powershell -ExecutionPolicy Bypass -File setup-autostart.ps1 ``` --- ## 🔬 技术原理（给好奇的你） OpenClaw 在生成 `gateway.cmd` 启动脚本时，会将用户名写入文件。对于**中文 Windows 用户**，用户名包含多字节 UTF-8 字符，但 `gateway.cmd` 以 GBK（Windows 默认 ANSI 编码）保存，导致 UTF-8 字节被错误解释为 GBK，产生乱码（如 `鍚存竻鑳絓`），进而脚本执行路径错误，网关**静默启动失败**。 本技能自动检测该编码错误，并以正确编码重写 `gateway.cmd`，同时对网关进程、端口占用、Node.js 路径等进行全面诊断。 --- ## 📋 系统要求 - Windows 10 / 11 - OpenClaw 已安装（npm 全局安装） - Node.js 已安装 - PowerShell 5.1+ ## 🏷️ 标签 `OpenClaw` `Gateway` `Windows` `中文乱码` `开机自启` `端口18789` `故障诊断` `自动化