Windows上搭建OpenClaw开发环境真的是一路踩坑，整理一下给后来人参考。
环境要求
- Windows 10/11
- Python 3.11+
- Node.js 18+
- Git
踩坑记录
坑1：Python版本问题
OpenClaw某些依赖要求Python 3.11+，但很多人装的是3.9或3.10。
解决：用pyenv-win管理多版本
pyenv install 3.11.7
pyenv global 3.11.7
坑2：pip安装超时
国内网络环境下，pip安装经常超时失败。
解决：换清华源
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
坑3：Node.js版本冲突
如果之前装了低版本的Node.js，可能会有兼容问题。
解决：用nvm-windows管理
nvm install 18.19.0
nvm use 18.19.0
坑4：路径太长
Windows默认最长路径260字符，node_modules经常超过。
解决：启用长路径支持
# 管理员PowerShell
New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force
坑5：SSL证书问题
pip install时出现SSL证书错误。
解决：
pip install --trusted-host pypi.org --trusted-host pypi.tuna.tsinghua.edu.cn <package>
坑6：端口被占用
OpenClaw默认端口3000经常被其他服务占用。
解决：修改配置文件或启动时指定端口。
建议
说实话，如果你的主力是Windows，强烈建议用WSL2。在WSL2的Ubuntu环境下安装体验和Linux一样顺畅，省去90%的坑。
wsl --install -d Ubuntu-22.04
希望能帮到在Windows上挣扎的同学。