整体来说比较顺利,按网上主流教程基本可以正常完成,但是还是有几个小坑值得记录一下。
1、先确保已安装git和nodejs,这两个的版本尽量不要太低了;
2、考虑到安装过程中会依赖安装很多包,建议开全局代理,比如clash就开TUN MODE,如果没有条件,也可以打开clash的窗口,确保在命令行窗口中可以ping通Google;
3、最大的坑在于中文用户名导致路径不是全英文,会导致安装正常后gateway无法正常启动,现象是启动gateway时窗口一闪而过,从日志看不出明确的原因,最后发现一个细节:在PowerShell中使用openclaw gateway start可以正常启动,但在cmd命令行窗口中就报错,再进一步定位知道命令会调用.openclaw/gateway.cmd,而这个cmd中定义了包含中文用户名的诸多路径,直接运行这个cmd,就有明确的报错信息了,原因是中文路径导致的编码问题,cmd命令后里面识别成乱码了。
找到原因后,解决方案就简单了,主要是修改gateway.cmd,增加了一行chcp 65001将编码指定为unicode:
@echo off
rem OpenClaw Gateway (v2026.3.2)
chcp 65001
set "TMPDIR=C:\Users\...
...