一、 优势想在 Windows 上运行 OpenClawWSL2 是目前最稳定、兼容性最好的方案。相比 Docker 或原生虚拟机它具备以下优势官方推荐使用Ubuntu24.04版本原生级性能直接调用 Linux 内核文件 I/O 和进程调度效率极高。Systemd 支持OpenClaw 的网关服务依赖 systemd 管理WSL2 完美支持。无缝交互Windows 与 Linux 文件系统互通方便调试和文件传输。️ 二、 环境前置准备在开始之前请确保你的 Windows 10/11 已经开启了 WSL2 功能并安装了 Ubuntu推荐 24.04。1. 安装 Git虽然 WSL 内部可以安装 Git但为了保证 Windows 与 Linux 之间的文件交互顺畅建议先在 Windows 上安装 Git。此步骤无需多说在windows上安装git后亲测在wsl2的Ubuntu上可以直接使用。2. WSL 内安装 Node.js 24OpenClaw 基于 Node.js 开发且对版本有要求推荐 v24。为了避免 apt 源版本过低我们采用官方二进制包安装。如果安装openclaw此步骤也可以忽略因为在安装openclaw时使用命令行安装他会自动检测我们是否已安装git和node还有npm如果没有安装他会自动帮我们安装。操作步骤可以在Windows上安装node然后在Ubuntu里能识别npm但识别不了node打开你的 WSL 终端依次执行以下命令# 1. 下载 Node.js 24 安装包 (使用国内镜像加速)wgethttps://cdn.npmmirror.com/binaries/node/v24.15.0/node-v24.15.0-linux-x64.tar.xz# 2. 解压并部署到系统目录 (需要 sudo 权限)# --strip-components1 表示去掉最外层目录直接将内容放入 /usr/localsudotar-xJfnode-v24.15.0-linux-x64.tar.xz-C/usr/local --strip-components1# 3. 清理安装包rmnode-v24.15.0-linux-x64.tar.xz验证安装node-vnpm-v预期结果终端应分别输出v24.15.0和 npm 的版本号。 三、 NPM 镜像源配置可忽略能科学上网的话可以用科学上网国内访问外网镜像源易超时。# 1. 淘宝镜像源npmconfigsetregistry https://registry.npmmirror.com# 2. 设置全局安装目录到用户主目录避免使用 sudonpmconfigsetprefix$HOME/.npm-global# 3. 将全局目录写入环境变量 PATHechoexport PATH$HOME/.npm-global/bin:$PATH~/.bashrc# 4. 立即生效环境变量source~/.bashrc 四、 安装 OpenClaw环境配置完毕后开始安装核心程序npminstall-gopenclaw注意安装过程可能需要几分钟请耐心等待直到终端不再滚动日志。注释懒人前面的步骤都可以省略可以使用如下命令一键安装这个命令会自动检测环境如果没有git和node、npm他会会自动给你安装好curl-fsSLhttps://openclaw.ai/install.sh|bash-s-- --no-onboard注后面的-s -- --no-onboard是默认只安装不启动如果要安装并启动可以把这个参数去掉直接安装及启动openclaw。⚙️ 五、 开启 WSL2 的 systemd 服务在这版本Ubuntu24.04中已默认开好此步骤可以忽略这是最容易出错的一步OpenClaw 的网关服务依赖 systemd 运行而 WSL 默认可能未开启。(如果不熟悉 vim可用*sudo nano /etc/wsl.conf*代替)(如果不熟悉 vim可用*sudo nano /etc/wsl.conf*代替)写入以下内容[boot]systemdtruesystemctl--userstatus修改文件权限可选但推荐可忽略默认就是此权限sudochmod644/etc/wsl.conf重启 WSL先在 WSL 终端输入exit退出在 Windows PowerShell (管理员) 中执行以下命令重新打开 WSL 终端wsl --shutdown验证 systemd 是否启动systemctl--userstatus预期结果看到active (running)字样即为成功。 六、 网关注册、启动与授权必要步骤1. 注册系统服务并设置开机自启# 注册服务openclaw gatewayinstall# 启动服务systemctl--userstart openclaw-gateway.service# 设置开机自启systemctl--userenableopenclaw-gateway.service2. 查看本地密钥凭证安装成功后系统会生成专属 Token用于后续平台绑定。cat~/.openclaw/openclaw.json操作提示复制文件中的 token 字段内容妥善保存登录页面时需要当作密码。3. 网关状态管理查看状态openclaw gateway status启动网关openclaw gateway start停止网关openclaw gateway stop4. 设备连接授权当有外部设备如手机、其他电脑首次尝试连接你的网关时需要手动审批。# xxxxx 替换为设备显示的标识符openclaw devices approve xxxxx 七、 常见报错与解决方案避坑必看场景端口冲突导致 Token 错误或启动失败如果你在执行上述步骤时报错或者发现服务起不来通常是因为28789 端口被占用。解决步骤找到port: 28789将其修改为未被占用的端口例如28790。找到port: 28789将其修改为未被占用的端口例如28790。强制刷新服务再次检查状态 八、 对接 AI 模型并验证1. 初始化模型接入执行初始化命令按照提示填入你的 大模型 API Key需提前在大模型 官网获取。openclaw onboard2. 交互测试发送一条测试消息验证 AI 是否能正常回复。openclaw agent--message你好--session-idtest预期结果终端应返回 DeepSeek 的回复内容。3. 进入命令行交互模式 (TUI)不推荐使用页面即可如果你想体验类似 ChatGPT 的连续对话模式openclaw tui 九、 命令汇总清单为了方便大家复制以下是全流程核心命令速查表步骤命令说明环境配置npm config set registry https://registry.npmmirror.com切换淘宝源安装核心npm install -g openclaw全局安装 OpenClaw开启服务sudo vim /etc/wsl.conf编辑配置开启 systemdwsl --shutdown(Windows侧) 重启 WSL服务管理openclaw gateway install注册网关服务systemctl --user start openclaw-gateway.service启动服务故障排查openclaw gateway install --force强制重装(解决端口冲突)功能验证openclaw agent --message 你好发送测试消息openclaw tui进入交互界面懒人方式curl -fsSL https://openclaw.ai/install.sh | bash一键安装启动懒人方式curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard一键安装不启动注官网安装方式https://docs.openclaw.ai/zh-CN/install原创不易如果本教程帮你解决了问题欢迎点赞、收藏、关注后续将持续更新 AI Agent 进阶玩法。
故障排除：常见问题与解决方案大全)
