OpenClaw(小龙虾)最近火得不行,我也下场试了一下,已经安装在两台电脑:笔记本,家里台式机。为了跑它,我还专门买了 minimaxi 的 49元包月的token 套餐。
在 Windows 上直接装小龙虾容易遇到各种奇怪问题,官方推荐安装在 Linux 虚拟机里,因为小龙虾一开始是从Linux里诞生的。
为了写这篇文章,我在台式机上又完整跑了一遍流程。
一、安装 WSL2
WSL2(Windows Subsystem for Linux)是微软的新Linux虚拟机架构,以前老版本称为WSL1(已弃用),WSL2对 Linux 程序的兼容性最好。
如果你之前用过 VirtualBox 或 VMware等虚拟机,会发现 WSL2 更省空间,性能也更好——它和 Windows 共享内核,没有传统虚拟机那种额外开销。
1.1 安装命令
在 Windows 命令行或 PowerShell 中运行以下命令:
wsl --install
我机器上的输出是:
正在下载: 适用于 Linux 的 Windows 子系统 2.6.3
正在安装: 适用于 Linux 的 Windows 子系统 2.6.3
已安装 适用于 Linux 的 Windows 子系统 2.6.3。
正在安装 Windows 可选组件: VirtualMachinePlatform
部署映像服务和管理工具
版本: 10.0.26100.5074
映像版本: 10.0.26200.7840
启用一个或多个功能
[===========100.0%=============]
操作成功完成。
请求的操作成功。直到重新启动系统前更改将不会生效。
请求的操作成功。直到重新启动系统前更改将不会生效。
按提示,最好重启Windows。
1.2 验证 WSL 安装
重启后,在 PowerShell 中运行以下命令查看 WSL 版本:
wsl -v
我的输出:
WSL 版本: 2.6.3.0
内核版本: 6.6.87.2-1
WSLg 版本: 1.0.71
MSRDC 版本: 1.2.6353
Direct3D 版本: 1.611.1-81528511
DXCore 版本: 10.0.26100.1-240331-1435.ge-release
Windows: 10.0.26200.7840
Windows里有一个应用“WSL Settings”,可以对WSL里的内存、网卡等进行高级设置,一般来说,默认的就行。
二、安装 Ubuntu 24.04
Linux系统 选Ubuntu 24.04,这是 OpenClaw 官方推荐的长期稳定支持(LTS)的版本,兼容性最好。
2.1 安装 Ubuntu
在 PowerShell 中运行:
wsl --install Ubuntu-24.04
安装基本完成之后,会提示创建新用户账号,尽量不要用root,例如 openclaw。
我的输出为:
正在下载: Ubuntu 24.04 LTS
正在安装: Ubuntu 24.04 LTS
已成功安装分发。可以通过 "wsl.exe -d Ubuntu-24.04" 启动它
正在启动 Ubuntu-24.04...
Create a default Unix user account: openclaw
New password:
Retype new password:
设置密码后,即可进入 Ubuntu 系统,认准末尾的$提示符(Windows里默认是>):
openclaw@slbhome:~$
你的提示符信息可能会更长,因为它把Windows里的当前文件夹名称也带了过来。
强烈建议这时先更新一下系统,再进行后续操作:
sudo apt update
sudo apt upgrade
2.2 退出 WSL
用exit回到你的windows命令行环境:
exit
三、将 Ubuntu 迁移到 D 盘(强烈推荐)
一般人的 C 盘空间都比较紧张,而 WSL 默认安装在C盘,随后会增加到几十GB。如果等到 C 盘满了再迁移,导出的 tar 文件会很大,迁移更麻烦。建议在安装好 Ubuntu 后立即迁移到 D 盘,释放你的C盘压力。
3.1 查看当前 WSL 状态
wsl -l -v
我的输出为:
NAME STATE VERSION
* Ubuntu Running 2
这里的version 2是指WSL2。
3.2 关闭 WSL
wsl --shutdown
3.3 导出 Ubuntu 到 tar 文件
wsl --export Ubuntu-24.04 D:\slb-ubuntu.tar
注意:这里要使用
Ubuntu-24.04而不是Ubuntu。
3.4 移除 C 盘的虚拟文件
wsl --unregister Ubuntu-24.04
3.5 导入 tar 文件到 D 盘
mkdir d:\wsl
wsl --import Ubuntu D:\wsl\ubuntu D:\slb-ubuntu.tar --version 2
3.6 启动 WSL
wsl -d Ubuntu
# 或直接
wsl
此时在 D:\wsl\ubuntu 目录下可以看到 ext4.vhdx 文件(约 1.4GB),这就是整个 Ubuntu 系统的文件,后面会持续增大。
3.7 Windows里访问Linux的文件
在 Windows 资源管理器中输入以下地址可以直接访问 WSL 内的文件,非常方便:
\\wsl$\Ubuntu
四、安装 OpenClaw
4.1 安装命令
官方推荐的安装步骤,在 WSL 的 Ubuntu 终端中运行:
curl -fsSL https://openclaw.ai/install.sh | bash
安装程序会自动:
- 检测系统环境
- 安装 Node.js(如未安装)
- 安装 Linux 构建工具(make/g++/cmake/python3)
- 安装 OpenClaw
如果你运气足够好,一条命令就可以安装好。
🦞 OpenClaw Installer
Less clicking, more shipping, fewer "where did that file go" moments.
✓ Detected: linux
Install plan
OS: linux
Install method: npm
Requested version: latest
[1/3] Preparing environment
· Node.js not found, installing it now
· Installing Node.js via NodeSource
· Administrator privileges required; enter your password
[sudo] password for openclaw:
· Installing Linux build tools (make/g++/cmake/python3)
✓ Build tools installed
✓ Node.js v22 installed
· Active Node.js: v22.22.1 (/usr/bin/node)
· Active npm: 10.9.4 (/usr/bin/npm)
[2/3] Installing OpenClaw
✓ Git already installed
· Configuring npm for user-local installs
✓ npm configured for user installs
· Installing OpenClaw v2026.3.13
4.2 手动安装依赖
有时会安装失败,可能需要手动安装某些依赖,比如我的机器上就缺少了libvips-dev:
提示这个错误:
! npm install failed for openclaw@latest
Command: env SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm --loglevel error --silent --no-fund --no-audit install -g openclaw@latest
Installer log: /tmp/tmp.gSatdHZk8o
! npm install failed; showing last log lines
! npm install failed; retrying
sudo apt install -y libvips-dev
然后重新再来一遍安装命令。
五、配置 OpenClaw
5.1 首次配置
安装完成后,会让你配置一些信息:
| 配置项 | 推荐配置 |
|---|---|
| I understand this is powerful and inherently risky | Yes |
| Onboarding mode | QuickStart |
| Model/auth provider | Skip for now |
| Filter models by provider | All providers |
| Default model | 使用默认配置 |
| Select channel | Skip for now |
| Configure skills | No |
| Enable hooks | Skip for now |
| How do you want to hatch your bot? | Hatch in TUI |
5.2 配置大模型
运行 OpenClaw 配置命令:
openclaw configure
由于我购买了Minimax的月度套餐,openclaw里直接提供了minimax的配置项:
model→minimax(CN)→ 粘贴 API Key
一个小插曲:国内用户要选带CN的服务,域名其实是 minimaxi.com,末尾多一个字母
i!我因为这一个字母在 Claude Code 里一直配不通大模型,耽误了几个小时。
5.3 启动 Dashboard
openclaw dashboard
会显示一个链接,例如:
http://localhost:18789/#token=4b975b***5b9c91
按住 Ctrl 键点击链接即可在浏览器中打开小龙虾的图形界面。
恭喜你,可以与小龙虾对话让它开始干活了!
尽情燃烧你的token吧!