Windows (WSL2)

这页说明书是专门给 Windows 电脑准备的。OpenClaw 最喜欢在 Linux 系统里玩，但你的电脑是 Windows。别担心，我们可以用一个叫 WSL2 的“魔法小盒子”，它能在 Windows 里面变出一个 Linux 游乐场。这样 OpenClaw 就能在里面开心地运行了，所有工具（比如 Node、Bun）也都能一起玩。这比直接在 Windows 上安装要简单得多哦。

第一步：安装 WSL2 和 Ubuntu 首先，我们要在 Windows 里安装这个“魔法小盒子”和它自带的“Ubuntu 游乐场”。

1. 打开“PowerShell”程序，记得要用“管理员”身份打开哦（就像拿到了一把万能钥匙）。
2. 在打开的窗口里，输入这个魔法咒语并按回车：wsl --install。
3. 电脑可能会让你重启，就像给游乐场铺好地板一样，重启后就能继续了。

第二步：打开“系统守护者”（systemd） 为了让 OpenClaw 的一些功能（比如网关服务）能正常工作，我们需要打开 WSL2 里的“系统守护者”。你可以把它想成是游乐场里的自动管理员。

1. 打开你的 WSL2（也就是 Ubuntu 终端）。
2. 输入下面的命令，这就像告诉管理员：“请开始工作吧！”。

   sudo tee /etc/wsl.conf >/dev/null <<'EOF'
   [boot]
   systemd=true
   EOF
   

3. 然后，回到 Windows 的 PowerShell（管理员），输入 wsl --shutdown 来关闭小盒子。
4. 再重新打开 Ubuntu 终端，输入 systemctl --user status 检查一下，如果看到一些文字而不是错误，就说明管理员开始工作啦！

第三步：在 WSL2 里安装 OpenClaw 现在，我们进入“Ubuntu 游乐场”里面，安装 OpenClaw。

1. 在 WSL2 的终端里，跟着 Getting Started 这个指南做就行。
2. 简单来说，你需要用 git clone 命令把 OpenClaw 的“玩具箱”搬过来，然后用 pnpm install 和 pnpm build 把玩具组装好，最后用 openclaw onboard 命令启动它。

让 OpenClaw 在电脑开机时就自己启动（无头模式） 如果你希望 OpenClaw 在电脑一开机（甚至还没登录）时就运行，就像让电视定时开机一样，需要多做几步：

1. 允许用户服务一直运行：在 WSL 终端里，输入 sudo loginctl enable-linger “$(whoami)“。
2. 安装网关服务：在 WSL 终端里，输入 openclaw gateway install。当它问你要安装什么时，记得选择 Gateway service。
3. 让 WSL 在 Windows 启动时自动运行：在 Windows 的 PowerShell（管理员）里，创建一个计划任务。输入： schtasks /create /tn “WSL Boot” /tr “wsl.exe -d Ubuntu –exec /bin/true” /sc onstart /ru SYSTEM 小心：这里的 Ubuntu 要换成你的 WSL 发行版名字，你可以用 wsl –list –verbose 命令查看。

高级技巧：让其他电脑也能访问 WSL 里的服务 WSL2 有自己的小网络，和 Windows 主网络是分开的。如果你想让其他电脑（比如你房间的平板）访问 WSL 里运行的服务（比如网关），就需要在 Windows 上“开一扇窗”，把网络请求转进去。这叫做“端口转发”。

1. 你需要以管理员身份打开 PowerShell。
2. 运行页面里那个长长的例子命令（从 $Distro = “Ubuntu-24.04” 开始）。它会找到 WSL 的当前地址，并设置转发。
3. 还要运行 New-NetFirewallRule 那个命令，告诉 Windows 防火墙允许这扇“窗”通行。 重要提醒：WSL 的地址每次重启可能会变，所以重启后可能需要重新运行设置转发的部分命令。你可以把刷新命令做成计划任务，这样就更省心了。

最后的小提醒

• 目前还没有专门的 Windows 桌面伴侣应用哦。
• 如果你在安装或运行中遇到问题，可以试试在 WSL 里运行 openclaw doctor 命令，它像个小医生，会帮你检查哪里不对劲。
• 所有具体的操作，比如网关配置，都可以在 Gateway runbook 和 Configuration 页面找到更多细节。