Windows 10系统安装OpenClaw小龙虾软件全流程

系统信息

请注意，以下内容仅为基于个人环境的测试安装记录。由于个人系统环境、所选安装版本以及OpenClaw项目的官方更新，实际操作过程可能会有所不同。

下载安装Node.js与准备Ubuntu环境

首先，需要准备好两个基础工具：Node.js 和 Ubuntu 子系统。

1. 获取Node.js安装包

前往Node.js官方网站下载适用于Windows的安装程序。选择LTS（长期支持）版本通常是个稳妥的选择。

2. 安装并验证Node.js

下载完成后，直接运行安装程序，基本上一路“下一步”即可完成安装。安装完成后，务必打开命令提示符或PowerShell，检查一下Node.js和其包管理器npm的版本，确保它们已被正确添加到系统路径中。

3. 安装pnpm包管理器

接下来，我们需要安装pnpm。这是一个速度更快的包管理器，许多现代前端项目都在使用它。打开终端，执行以下命令：

npm install -g pnpm

4. 验证pnpm安装

安装完成后，输入简单的 pnpm 命令，如果显示出帮助信息，就说明安装成功了。

pnpm

5. 安装WSL2

这一步是关键，WSL2（Windows Subsystem for Linux 2）能让后续的Linux环境安装从“困难模式”切换到“简单模式”。首先，检查一下系统是否已经安装了WSL以及其版本。

wsl -l -v

如果从未安装过，就需要从头开始。这里有个前提：你的Windows 10版本号必须不低于2004（内部版本号≥19041），否则系统可能不包含简单的安装命令。

# 查看系统版本号
winver

理论上，我们可以使用 wsl --install 这个便捷命令。但有时会遇到提示说“WSL功能已启用”，命令本身被识别，但无法继续安装Linux发行版的情况，如下图：

这时候，就需要手动开启相关功能。以管理员身份打开PowerShell，依次执行以下两条命令：

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

6. 手动安装WSL2内核更新包

功能开启后，还需要手动安装WSL2的核心组件。去微软官网下载“WSL2 Linux内核更新包”，下载完成后直接双击运行，按照提示安装，然后重启电脑。

下载地址：https://aka.ms/wsl2kernel

7. 设置WSL2为默认版本并安装Ubuntu

电脑重启后，再次以管理员身份打开PowerShell，将WSL的默认版本设置为2。

wsl --set-default-version 2

现在，就可以正式安装Ubuntu了。注意，如果之前 wsl --install 没成功，这里就不要再用了，改用指定发行版的命令：

wsl --install -d Ubuntu

8. 完成Ubuntu初始化

执行完上述命令后，再次重启电脑（确保所有组件完全加载）。之后，在开始菜单搜索“Ubuntu”并点击启动。首次运行会进行文件系统初始化，稍等片刻，系统会提示你设置一个Unix用户名和密码，这个密码在后续使用sudo命令时会用到。

说个题外话，如果在安装过程中提示需要开启虚拟化，那就得进电脑的BIOS设置里，找到Virtualization Technology（VT）或类似选项，将其开启。

9. 最终验证

一切就绪后，最后做一次验收。在PowerShell中输入：

wsl -l -v

如果看到Ubuntu的名字，并且版本号是“2”，那么恭喜你，WSL2和Ubuntu都已安装成功。

安装OpenClaw

基础环境搭好了，现在进入正题——安装OpenClaw。首先，可以访问其官网了解详情。

安装过程其实就一行命令，但有个细节要特别注意：必须在WSL的Ubuntu终端里执行，并且最好先回到用户的家目录。

打开Ubuntu，确保你在家目录（~），然后执行官方提供的安装脚本：

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

命令执行后，脚本会自动开始工作，下载所需组件并进行配置。

安装过程需要一点时间，耐心等待即可。

安装完成后，脚本会引导你进入初始配置阶段。

配置模型与授权

首先，需要选择一个AI模型。这里根据个人需求选择即可，例如选择千问模型。

选择模型后，系统通常会提供一个授权链接，复制到浏览器中打开并完成授权操作。

在后续的一些配置选项中，例如遇到网络端口设置时，如果暂时不想改动，可以选择“keep current”或“跳过”。

其他高级配置项同样可以暂时跳过，待后续有需要时再回来调整。

安装成功与访问

当看到安装成功的提示，并显示一个本地访问链接时，就意味着核心部分已经完成了。把这个链接复制下来。

启动网关服务

为了让Web界面能够访问，需要先启动网关服务。在Ubuntu终端中运行：

nohup openclaw gateway > openclaw-gateway.log 2>&1 &

获取访问令牌

最后一步，获取登录仪表板的令牌：

openclaw dashboard --no-open

命令执行后，会输出一个带有token的本地链接。

将这个完整的链接复制到Windows的浏览器中打开，就能看到OpenClaw的管理界面了，这标志着整个安装部署工作圆满成功。

最后再次提醒，以上步骤基于特定时间点的个人测试环境。实际情况可能因您的系统配置、软件版本更新而略有不同，请灵活应对。