为什么 Windows 不直接用 PowerShell 装，要绕 WSL？

PowerShell 也能装，官方有一条 PowerShell 一键命令，还有带托盘图标的 Windows Hub 桌面端。但 Windows 原生环境容易卡在两个地方：一是后台服务靠计划任务拉起，出问题不如 Linux 的 systemd 好排，网上资料也少；二是路径分隔符和权限规则跟 Linux 不一样，很多技能脚本默认是 Linux 写法。WSL2 给你一个真 Linux 环境，所有 Linux 教程原样照抄，踩坑概率大幅下降，官方也把它列为 Windows 上最贴近 Linux 的运行环境。

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

能。Windows 的盘在 WSL 里挂在 /mnt/c、/mnt/d 这些路径下，龙虾按这个路径就能读写你 Windows 的文件。但要注意性能：跨系统访问（/mnt 下的文件）比访问 WSL 自己的目录慢很多，所以项目代码本身建议放在 WSL 的 Linux 目录里，只有需要处理的数据文件才走 /mnt。

WSL 会不会很占内存、拖慢电脑？

WSL2 是个轻量虚拟机，平时不占多少，按需分配内存，不用时基本休眠。只跑龙虾走云端 API 的话占用很小。真正吃内存的是你在 WSL 里本地跑大模型——那是模型的事，跟 WSL 本身无关。日常使用基本感觉不到它在后台。

教程 · 部署

Windows 用 WSL 跑 OpenClaw 的干净装法

钳叔 · 龙虾AI 编辑部 · 2026-08-23 · 约 11 分钟

同一套龙虾装法，在 macOS 和 Linux 上往往一路绿灯，到了 Windows 原生环境就容易卡：PATH 找不到命令、后台服务怎么开机自启、路径反斜杠对不上。与其在 PowerShell 里硬刚这些坑，不如换条路——开 WSL2，在 Windows 里直接跑一个真正的 Ubuntu，网上所有 Linux 教程原样照抄即可。官方也把 WSL2 列为 Windows 上“最贴近 Linux 的 Gateway 运行环境”。这篇按装 WSL2、配 Ubuntu 环境、装龙虾、两边文件互通的顺序走。

为什么走 WSL，而不是硬装 PowerShell

先说清楚：Windows 原生也能装。官方给了一条 PowerShell 一键命令（iwr -useb https://openclaw.ai/install.ps1 | iex），还有一个带托盘图标的 Windows Hub 桌面端——不想碰终端的人可以直接用它。那为什么还推荐 WSL？因为原生环境有两个老大难：

后台常驻：Windows 上靠计划任务拉起 Gateway，调试起来不如 Linux 的 systemd 直观；出了问题，网上能搜到的排错资料也是 Linux 的多。
路径和权限：反斜杠、权限模型跟 Linux 不一样，很多技能脚本默认按 Linux 写，搬到 Windows 就水土不服。

WSL2 直接给你一个完整 Linux，这两个问题都不存在。你只要会照抄 Linux 命令就行。它本质上是 Windows 里跑的一个轻量虚拟机，但用起来不像虚拟机那么笨重——没有单独的窗口、不用来回切系统，一个终端就进去了，文件还能和 Windows 互通。对装龙虾这种“一堆 Linux 风格脚本和依赖”的活儿来说，这是目前 Windows 上最省心的环境。

第一步：装 WSL2

以管理员身份打开 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

顺手更新一下系统。不用再 apt 装 Python 了——OpenClaw 是 Node.js 项目，下一步的官方脚本会自己把 Node 装好：

sudo apt update && sudo apt upgrade -y

第三步：在 WSL 里装龙虾

回到 Ubuntu 终端，一条命令。它会检测系统、缺 Node 就装 Node、装好 OpenClaw，然后直接拉起引导向导——向导里选模型服务商、粘 API key、同意装后台服务，照着答完就能用：

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

装完确认 Gateway 在跑：

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" 这种“服务商/模型名”格式。向导已经替你填好了，换模型时再来改。

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

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

它真的建了文件、写了字、又读回来念给你听，就说明模型连通、工具调用、循环执行三件事都通了，剩下就是堆更复杂的任务。到这一步，你在 Windows 上其实已经拥有了一个跟 Linux 上一模一样的龙虾环境，后面所有 Linux 教程都能直接照抄，不用再为系统差异操心。

想让龙虾在你没登录 Windows 时也跑着（比如挂定时任务），还要多做两步：在 WSL 里给自己开 sudo loginctl enable-linger "$(whoami)"，再在 Windows 里建一个开机启动 WSL 的计划任务。这属于进阶需求，官方 Windows 文档里有完整配方，新手先把日常用法跑顺。

第四步：和 Windows 文件互通的坑

WSL 和 Windows 不是两台隔离的电脑，文件可以互访，但有讲究：

WSL 访问 Windows 文件：你的 C 盘、D 盘在 WSL 里挂在 /mnt/c、/mnt/d。想让龙虾处理桌面上某个文件夹，路径就写成 /mnt/c/Users/你的名字/Desktop/...。
Windows 访问 WSL 文件：在 Windows 文件资源管理器地址栏输入 \\wsl$ 就能进到 WSL 的文件系统，把里面的文件拖出来。
性能提醒：跨系统读写（走 /mnt）明显慢，所以代码放 WSL 内部、只有要处理的数据才走 /mnt。

避坑提示 wsl --install 中间会重启一次，进 Ubuntu 后先开 systemd、再跑官方一键脚本装 Node 和龙虾，时间大头都在下载上，耐心等就好。漏了开 systemd 这步的话，后台服务装不上、openclaw gateway status 会报服务不在——回头补上 /etc/wsl.conf 再 wsl --shutdown 一次就好。这里还有一条很值得记的坑：代码和经常读写的数据，尽量放在 WSL 自己的家目录里，别放 Windows 盘（/mnt/c 下）。跨 /mnt/c 访问要走一层文件系统转换，处理大文件时会慢不少；同一份数据放 WSL 家目录里处理，往往能快出一大截。

常见问题

为什么 Windows 不直接用 PowerShell 装，要绕 WSL？: PowerShell 也能装（官方有一键命令和 Windows Hub 桌面端），但原生环境的后台服务靠计划任务、路径/权限规则也和 Linux 不同，很多技能脚本是 Linux 写法。WSL2 给你一个真 Linux 环境，Linux 教程原样照抄，踩坑概率大幅下降。
WSL 里跑的龙虾能访问我 Windows 上的文件吗？: 能。Windows 盘挂在 /mnt/c、/mnt/d 下，按这个路径就能读写。但跨系统访问比 WSL 自己的目录慢，所以代码放 WSL 内部，只有要处理的数据才走 /mnt。
WSL 会不会很占内存、拖慢电脑？: WSL2 是轻量虚拟机，按需分配、不用时基本休眠。只跑龙虾走 API 占用很小。真正吃内存的是在 WSL 里本地跑大模型，那是模型的事，跟 WSL 本身无关。