Windows 用 WSL2 跑 OpenClaw：安装步骤与开机自启

Windows 上三种装法各适合谁

• Windows Hub：官方标的推荐项，一个带托盘图标的桌面端，支持 Windows 10 20H2 及以上和 Windows 11，安装不需要管理员权限。首次启动选 Set up locally，它会新建一个应用自管的 WSL 发行版 OpenClawGateway，把 Gateway 装在里面，不动你已有的 Ubuntu。安装包从哪拿见 OpenClaw 手机版和桌面版在哪下载。
• PowerShell 安装器：一条 iwr -useb https://openclaw.ai/install.ps1 | iex，直接在 Windows 上装命令行和 Gateway，后台常驻靠计划任务。习惯终端、用不到 Linux 环境的人选它。
• WSL2：在自己的发行版里手动装，得到一个完整的 Linux 环境，后台服务走 systemd 用户服务，装法就是 Linux 那条一键脚本。下面讲的就是这一条。

装 WSL2：一条 wsl --install

以管理员身份打开 PowerShell，一条命令装好（现在的 Windows 这条会自动装好 WSL2 内核加一个 Ubuntu）：

wsl --install

装完重启电脑。重启后会自动弹出 Ubuntu 的初始化，让你设一个用户名和密码——这是 Linux 里的账号，记牢，后面 sudo 要用。设完你就进到了一个 Ubuntu 终端。

想确认装的是 WSL2（不是老的 WSL1），回 PowerShell 查一下：

wsl -l -v

VERSION 那列是 2 就对了。是 1 的话用 wsl --set-version Ubuntu 2 升上去。

在 Ubuntu 里把 systemd 打开

从这里开始，所有命令都在 WSL 的 Ubuntu 终端里敲，跟在真 Linux 上一模一样。WSL 里的 Ubuntu 默认没开 systemd，而龙虾的后台服务靠它拉起，所以先把它打开——这一步是 WSL 特有的，真 Linux 上不用：

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

然后回 PowerShell 把 WSL 关一次再重新进 Ubuntu，配置才生效：

wsl --shutdown

顺手更新一下系统。Node 不用自己装，下一步的官方脚本会把它装好：

sudo apt update && sudo apt upgrade -y

在 WSL 里装 OpenClaw 并跑第一条任务

回到 Ubuntu 终端，一条命令装好，脚本装完会接着进引导向导：

curl -fsSL https://openclaw.ai/install.sh | bash

向导里要你动手的主要是接模型这一段：它列出在这个 Ubuntu 里检测到的 AI 接入，你挑一个，或者选一家服务商、填它的 API key；它发一次真实请求，通了才保存，接着把工作区和 Gateway 设置写好。最后一步是开控制台：WSL 里装了 wslview 的，它直接把控制台在浏览器里打开；没装的，终端里会打出一条控制台地址，复制到浏览器里开。

走 Quick start 的话，Gateway 是在向导这个终端的前台启动的，按 Ctrl+C 它就停，配置会留着。要它在后台常驻，另开一个 Ubuntu 终端，把它装成 systemd 用户服务，再看状态：

openclaw gateway install
openclaw gateway status

龙虾的配置和工作区都在 WSL 自己的家目录 ~/.openclaw/ 下，是 Linux 那边的家目录，不是 C 盘的 C:\Users\你。密钥在 ~/.openclaw/.env，按服务商命名（例如 ANTHROPIC_API_KEY=sk-ant-你的密钥，没有通用的 API_KEY）；模型名在同目录的 openclaw.json 里，写 agents.defaults.model.primary: "anthropic/claude-opus-5-5" 这种“服务商/模型名”格式，换模型时改这一行。

然后打开控制台，跑一条最小任务验证：

openclaw dashboard
# 浏览器里开出控制台后，给它一句：在工作区建 hello.txt 写一行字再读回来

它回话以后，到工作区里看一眼（默认是 WSL 里的 ~/.openclaw/workspace）：hello.txt 在、内容也对，就说明模型连接和工具调用都通了。

WSL 和 Windows 互访文件：路径怎么写、文件放哪边

WSL 和 Windows 的文件可以互访：

• WSL 访问 Windows 文件：你的 C 盘、D 盘在 WSL 里挂在 /mnt/c、/mnt/d。想让龙虾处理桌面上某个文件夹，路径就写成 /mnt/c/Users/你的名字/Desktop/...。
• Windows 访问 WSL 文件：在 Windows 文件资源管理器地址栏输入 \\wsl$ 就能进到 WSL 的文件系统，把里面的文件拖出来。
• 文件放哪：微软的 WSL 文档不建议跨系统操作文件，在 Linux 命令行里干活就把文件放 WSL 自己的文件系统，速度更快。所以代码和经常读写的数据放 WSL 家目录，只有要处理的 Windows 文件才走 /mnt。

没登录 Windows 也要它跑着：开机自启怎么配

想让龙虾在没人登录 Windows 时也跑着（比如挂定时任务），照官方 Windows 文档「Gateway auto-start before Windows login」一节做。先在 WSL 里：

sudo apt-get install -y dbus-x11
sudo loginctl enable-linger "$(whoami)"
openclaw gateway install

再以管理员身份打开 PowerShell，建一个开机启动 WSL 的计划任务。Ubuntu 换成 wsl --list --verbose 里显示的发行版名：

schtasks /create /tn "WSL Boot" /tr "wsl.exe -d Ubuntu --exec dbus-launch true" /sc onstart /ru "$env:USERNAME"

之前建过这个计划任务的，检查两处。一处是 /bin/true，要换成 dbus-launch true：WSL 2.6.1.0 及以上版本会在最后一个客户端退出 15–20 秒后回收发行版，开了 linger 也一样。另一处是 /ru SYSTEM，要换成自己的账号：默认装法的发行版是按用户装的，SYSTEM 账号看不到它，任务显示在跑，发行版却没起来。用自己的账号建任务时，Windows 会要你输一次密码。重启后回 WSL 确认：

systemctl --user is-enabled openclaw-gateway.service
systemctl --user status openclaw-gateway.service --no-pager

常见问题

Windows 上装龙虾，Hub、PowerShell、WSL2 选哪个？

官方 Windows 文档把 Windows Hub 标为推荐：它是桌面端，首次启动选 Set up locally 会替你建一个应用自管的 WSL Gateway。习惯终端、用不到 Linux 环境的选 PowerShell 安装器，后台常驻靠计划任务。要一个完整的 Linux 环境、想照 Linux 的步骤装，选 WSL2，也就是本页的装法。

WSL 里跑的龙虾能访问我 Windows 上的文件吗？

能。Windows 盘挂在 /mnt/c、/mnt/d 下，按这个路径就能读写。微软的 WSL 文档不建议跨系统操作文件：在 Linux 命令行里干活，文件放 WSL 自己的文件系统更快。所以代码放 WSL 内部，只有要处理的 Windows 文件才走 /mnt。