🚀 一、 优势
想在 Windows 上运行 OpenClaw，WSL2 是目前最稳定、兼容性最好的方案。相比 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 24
OpenClaw 基于 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-components=1 表示去掉最外层目录，直接将内容放入 /usr/localsudotar-xJfnode-v24.15.0-linux-x64.tar.xz-C/usr/local --strip-components=1# 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. 将全局目录写入环境变量 PATHecho'export 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]systemd=truesystemctl--userstatus- 修改文件权限（可选，但推荐，可忽略，默认就是此权限）：
sudochmod644/etc/wsl.conf重启 WSL：
- 先在 WSL 终端输入
exit退出，在 Windows PowerShell (管理员) 中执行以下命令，重新打开 WSL 终端：wsl --shutdown
- 先在 WSL 终端输入
验证 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 stop
4. 设备连接授权
当有外部设备（如手机、其他电脑）首次尝试连接你的网关时，需要手动审批。
# 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 | 编辑配置开启 systemd |
wsl --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 进阶玩法。
