如果你以为OpenClaw是什么高不可攀的黑科技，那可就错了。它就是一个能在你自己电脑上运行的AI助手，能干实活的那种。很多人在Windows上装它装到崩溃，其实就是没找对路子。
为啥Windows必须走WSL2这条路
Windows系统和OpenClaw的底层环境天生不太对付。OpenClaw需要和Linux二进制文件、Node工具以及各种技能包打交道，这些在原生Windows上跑起来经常报错。官方文档直接说了，推荐用WSL2来装。
如果你的需求只是使用最新模型，而不是自己折腾部署环境，也可以直接使用 api.
WSL2相当于在你的Windows里开了一个小巧的Linux系统，两者能同时运行。2026年的今天，这个技术已经非常成熟，微软自己也在大力推。你在Windows商店里就能找到Ubuntu，安装过程基本都是下一步。
具体操作上，你需要先以管理员身份打开PowerShell。按下开始菜单，搜索PowerShell，右键选“以管理员身份运行”。然后输入wsl --install这行命令，系统就会自动安装WSL2并拉取Ubuntu系统。整个过程大概需要5到10分钟。
装完Ubuntu后，首次启动会让你创建用户名和密码。这里要注意，输入密码时屏幕不会显示任何字符，连星号都没有，这是Linux的正常安全机制。你只管盲打然后回车就行，别以为自己键盘坏了。
一键安装脚本最省事
进入Ubuntu系统后，第一件事是更新系统软件源。输入sudo apt update && sudo apt upgrade -y，这会让你的Ubuntu保持在最新状态。对于云服务器和本地WSL，这都是标准操作，能避免很多依赖冲突。
官方给Linux和WSL2用户准备了一键安装脚本。在Ubuntu终端里粘贴官方的那行安装命令，脚本会自动检测你的系统有没有装Node.js，如果没有就帮你装上。它还会把OpenClaw的命令行工具全局安装好。
安装脚本跑完后，紧接着就会自动启动onboarding向导。这个向导会一步步问你配置信息，比如要用哪个AI模型、API密钥填什么、要不要开启网关服务等。你不需要懂太多技术术语，跟着提示选择就行。
整个过程是全自动的，你只需要回答几个问题。相比手动配置各种环境变量和依赖包，这种方式能把几十步操作压缩到几分钟内完成。新手走这条路基本不会卡住。
手动安装适合老手
如果你已经有一定Linux基础，想自己控制每个软件的版本，那可以选择手动安装。首先需要确认你的Python版本在3.10以上，可以用python3 --version查看。Git也是必备工具，部分技能包要靠它来拉取代码。
Node.js的版本要求是22或更高。你可以通过NodeSource提供的二进制包来安装，这样版本比较新。安装完Node后，用npm install -g openclaw@latest这条命令来全局安装OpenClaw。
手动安装的好处是你清楚每个组件装在哪里。比如Node模块装在/usr/local/lib/node_modules，配置文件藏在用户目录的.openclaw文件夹里。以后想升级某个组件或者排错，路径都门清。
装完以后一定要跑一下openclaw doctor这个命令。它会自动检查你的环境配置有没有问题，比如PATH路径对不对、Node版本够不够、API密钥有没有设置。任何红色警告都要先修好再继续。
网关服务要开机自启
OpenClaw的核心是一个叫Gateway的网关服务，它负责监听来自浏览器、聊天软件或者其他渠道的请求。如果你希望电脑重启后OpenClaw还能自动跑起来，就需要把这个服务配置成开机自启。
在WSL2 Ubuntu里，官方推荐启用systemd。你需要编辑/etc/wsl.conf文件，加上systemd=true这行配置。然后完全退出WSL，在PowerShell里执行wsl --shutdown，再重新启动Ubuntu，systemd就生效了。
启用systemd后，你可以用openclaw --install-daemon命令把Gateway安装成系统服务。之后用sudo systemctl enable openclaw-gateway让它开机启动，用sudo systemctl start openclaw-gateway立即启动。查看运行状态用sudo systemctl status openclaw-gateway。
对于Windows用户，还可以在PowerShell管理员模式下创建计划任务。让WSL在系统登录时自动拉起Ubuntu并启动OpenClaw服务。两种方法选一种就行，不用都做。
Ubuntu服务器装法更纯粹
如果你有一台云主机或者VPS，系统是Ubuntu 20.04及以上版本，那安装起来更简单。直接用官方的一键安装脚本，因为服务器通常没有图形界面，onboarding向导会自动切换到命令行交互模式。
服务器上安装时，注意要开放网关的端口。默认端口号可以在配置文件里修改，记得在云服务商的控制台安全组里放行这个端口。不然外面访问不到你的OpenClaw服务。
对于生产环境，不建议用root用户直接跑OpenClaw。可以单独创建一个普通用户，比如openclaw，把服务跑在这个用户下。这样即使服务出了安全问题，也不会影响整个系统。
日志文件默认存放在~/.openclaw/logs目录下。出问题时要学会看日志，比如认证失败就检查.env文件里的API_KEY变量名是不是写对了。常见错误都有明确的日志输出。
几个容易卡人的坑
安装完在终端输入openclaw，提示命令找不到。这通常是全局npm路径没加到PATH环境变量里。解决方法是在~/.bashrc文件末尾加上export PATH="$PATH:/usr/local/bin"，然后执行source ~/.bashrc。
Windows Defender有时会拦截npm的安装过程，报一些安全警告。这不是OpenClaw有问题，而是杀毒软件太敏感。可以暂时关闭实时保护，或者把npm的全局安装目录加入排除列表。
在WSL里装完但无法访问Windows上的文件系统。其实WSL自动挂载了Windows的磁盘，路径是/mnt/c/、/mnt/d/等。你可以直接在Ubuntu里操作Windows文件，不需要复制来复制去。
API密钥填错了怎么改？配置文件在~/.openclaw/.env，用nano或者vim打开编辑就行。改完不需要重启整个服务，gateway会自动重新加载配置。
如果你的需求只是使用最新模型，而不是自己折腾部署环境，也可以直接使用 yukuiku：
如果你也在Windows上折腾过AI工具安装，是不是遇到过各种报错让你想砸电脑？评论区分享一下你最崩溃的一次安装经历吧，点赞让更多人看到正确姿势。
