openclaw gateway无法启动

1. 查看OpenClaw日志排查启动故障

当OpenClaw启动失败时，首要的排查步骤是查看其运行时日志。通过分析日志信息，我们可以快速定位错误根源。通常，只需执行一条简单的命令即可查看最近的日志记录。

# 日期改成今天
Get-Content "$env:TEMP\openclaw\openclaw-2026-03-04.log" -Tail 20

执行该命令后，系统将输出结构化的日志内容，示例如下：

{"0":"\u001b[38;2;139;127;119mRuntime:\u001b[39m \u001b[38;2;139;127;119munknown\u001b[39m","_meta":{"runtime":"node","runtimeVersion":"24.13.0","hostname":"DESKTOP-DN5UI5T","name":"openclaw","date":"2026-03-04T02:42:55.637Z","logLevelId":3,"logLevelName":"INFO","path":{...}},"time":"2026-03-04T10:42:55.637+08:00"}
{"0":"\u001b[38;2;139;127;119mRPC probe:\u001b[39m \u001b[38;2;226;61;45mfailed\u001b[39m","_meta":{..."logLevelName":"ERROR",...},"time":"2026-03-04T10:42:55.637+08:00"}
{"0":"\u001b[38;2;139;127;119mRPC target:\u001b[39m ws://127.0.0.1:18789","_meta":{..."logLevelName":"ERROR",...},"time":"2026-03-04T10:42:55.638+08:00"}
{"0":"\u001b[38;2;226;61;45mgateway closed (1006 abnormal closure (no close frame)): no close reason\u001b[39m","_meta":{..."logLevelName":"ERROR",...},"time":"2026-03-04T10:42:55.639+08:00"}
{"0":"\u001b[38;2;226;61;45mGateway target: ws://127.0.0.1:18789\u001b[39m","_meta":{..."logLevelName":"ERROR",...},"time":"2026-03-04T10:42:55.639+08:00"}
{"0":"\u001b[38;2;226;61;45mSource: cli --url\u001b[39m","_meta":{..."logLevelName":"ERROR",...},"time":"2026-03-04T10:42:55.640+08:00"}
{"0":"\u001b[38;2;226;61;45mConfig: C:\\Users\\鍙舵櫒\\.openclaw\\openclaw.json\u001b[39m","_meta":{..."logLevelName":"ERROR",...},"time":"2026-03-04T10:42:55.641+08:00"}
...
{"0":"Dashboard URL: http://127.0.0.1:18789/#token=8ed15c38058153803504ec7ca11203d349ecc3e956a1a61f","_meta":{..."logLevelName":"INFO",...},"time":"2026-03-04T10:43:23.693+08:00"}

仔细分析日志条目，问题的根本原因便逐渐明了。连续的“RPC probe failed”（RPC探测失败）与“gateway closed”（网关关闭）错误，最终都指向一个核心的配置文件路径： C:\\Users\\鍙舵櫒\\.openclaw\\openclaw.json。

这里的“鍙舵櫒”实际上是由于系统编码问题导致的中文字符显示为乱码。换言之，导致OpenClaw启动失败的核心问题在于——系统用户目录路径中包含了中文字符（例如中文用户名），在Node.js运行或路径解析过程中产生了编码错误，从而引发服务初始化失败。

解决方案

针对此类由中文路径引发的编码问题，通常有以下两种可行的解决思路：

1. 避免使用中文用户名
这是从源头彻底解决问题的方案。对于开发环境和编程相关应用，建议在操作系统层面使用纯英文用户名，这能够有效规避绝大多数因路径编码或字符集兼容性引发的故障。此方法可谓一劳永逸。

2. 通过独立命令行启动服务
如果暂时无法修改系统用户名，可以采用变通方式，即绕过包管理器（如npm）的启动脚本，直接使用Node.js执行OpenClaw的核心文件。这种方法能够更精确地控制程序的执行环境。

node "C:\Users\叶晨\AppData\Roaming\npm\node_modules\openclaw\dist\index.js" gateway --port 18789

该方法通过手动指定完整的、未发生乱码的绝对路径来直接启动网关服务，从而绕过了因路径解析过程中的编码错误而导致的启动失败问题。需要注意的是，这通常作为一种临时性的故障排除和解决方案。