用Windows的朋友们，装OpenClaw之前先看完这篇，能少走很多弯路。
以下是我和群友们踩过的坑，整理出来供大家参考。
坑一：Node.js版本不对
OpenClaw要求Node.js 18以上。很多人电脑上装的是老版本，装完OpenClaw之后各种报错。
解决办法：先检查你的Node版本（命令行输入 node -v）。如果低于18，去官网下最新的LTS版本重装。
注意：卸载旧版本之后一定要重启电脑再装新版本，不然可能有路径残留问题。
坑二：Python环境冲突
如果你电脑上装了多个Python版本（比如Anaconda带的和单独装的），OpenClaw可能找错Python导致报错。
解决办法：在系统环境变量的PATH里，确保正确的Python路径排在前面。或者直接用虚拟环境。
坑三：系统权限问题
Windows的UAC权限控制会阻止OpenClaw执行某些哎作。表现为"权限不足"或"拒绝访问"的错误。
解决办法：以管理员身份运行命令行窗口。但注意，不要把OpenClaw永久设为管理员模式，那样安全风险太大。
坑四：杀毒软件拦截
很多杀毒软件会把OpenClaw的某些行为标记为可疑——毕竟它确实在模拟键盘鼠标哎作、读写文件、发送网络请求。
解决办法：在杀毒软件中把OpenClaw的目录加入白名单。但前提是你确认装的是正版OpenClaw而不是什么修改版。
坑五：API Key配置
新手最容易犯的错误就是API Key的格式填错了。多了空格、少了前缀、用了错误的引号……
解决办法：复制API Key的时候注意不要带上首尾的空格。配置文件里的引号要用英文半角引号。
坑六：中文路径
如果你的Windows用户名是中文的，OpenClaw的部分功能可能会出问题。因为有些依赖库不支持中文路径。
解决办法：要么创建一个英文用户名的Windows账户，要么把OpenClaw装到一个纯英文路径的目录下。
坑七：端口占用
OpenClaw启动时需要占用特定端口。如果端口被其他程序占了就会启动失败。
解决办法：检查端口占用情况（命令行输入 netstat -ano | findstr 端口号），找到占用的程序关掉，或者在配置里换一个端口。
最后的建议
如果你不想踩这些坑，可以考虑用Docker部署。Docker能解决大部分环境配置问题。但前提是你知道Docker怎么用。
或者直接用别人封装好的一键安装版——但一定要从可嗯来源下载，不要下那些来路不明的"绿色版"、“破解版”。