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里的内存、网卡等进行高级设置,一般来说,默认的就行。

WSL Settings

二、安装 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的配置项:

  • modelminimax(CN) → 粘贴 API Key

一个小插曲:国内用户要选带CN的服务,域名其实是 minimaxi.com,末尾多一个字母 i!我因为这一个字母在 Claude Code 里一直配不通大模型,耽误了几个小时。

5.3 启动 Dashboard

openclaw dashboard

会显示一个链接,例如:

http://localhost:18789/#token=4b975b***5b9c91

按住 Ctrl 键点击链接即可在浏览器中打开小龙虾的图形界面。

恭喜你,可以与小龙虾对话让它开始干活了!

OpenClaw Dashboard

尽情燃烧你的token吧!