windows wsl openclaw安装教程

本文详细介绍了在Windows系统上通过WSL（Windows Subsystem for Linux）安装OpenClaw AI助手的完整流程。主要内容包括：1）准备WSL2 Linux环境并配置Ubuntu；2）安装核心依赖如Node.js 22+；3）通过两种方式（一键脚本或源码）部署OpenClaw；4）配置API密钥并启动服务。文章还提供了常见问题解决方案，如文件访问、网络代理设置等，帮

diygwcom

819人浏览 · 2026-03-08 10:50:23

diygwcom · 2026-03-08 10:50:23 发布

在Windows上通过WSL安装OpenClaw，本质上是借助WSL提供的Linux环境来运行这个主要为类Unix系统设计的AI助手。整个过程可以分为四步：准备WSL环境、安装核心依赖、部署OpenClaw、启动并验证。

下面是详细的安装步骤。

第一步：准备WSL2 Linux环境

首先，我们需要在Windows上安装并配置好WSL2。

启用WSL功能：以管理员身份打开PowerShell或命令提示符，输入以下命令并回车。这个命令会启用必要的Windows功能，并默认安装Ubuntu发行版。
```
wsl --install
```
安装完成后，请重启你的电脑。
设置Ubuntu：电脑重启后，启动刚安装的Ubuntu（可以在开始菜单中找到）。首次启动会要求你设置一个新的用户名和密码，这个密码在后续执行sudo命令时会用到。
验证WSL版本：为了确保最佳性能，建议使用WSL2。在PowerShell中运行以下命令，确认Ubuntu的版本是2。
```
wsl -l -v
```
如果版本是1，可以通过以下命令设置为WSL2：wsl --set-version <你的发行版名称> 2（将<你的发行版名称>替换为Ubuntu或上一步查询到的确切名称）。

第二步：在WSL中安装核心依赖

接下来，所有操作都将在你刚才打开的 Ubuntu终端 中进行。

更新软件包列表：
```
sudo apt update && sudo apt upgrade -y
```

安装基础工具：

sudo apt install -y git curl wget build-essential

安装Node.js：OpenClaw需要Node.js 22或更高版本。推荐使用nvm（Node版本管理器）进行安装，这样可以方便地切换版本。

# 下载并安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# 重新加载shell配置，使 nvm 命令生效
source ~/.bashrc

# 安装 Node.js 22 LTS 版本
nvm install 22

# 验证安装
node --version  # 应该输出 v22.x.x 或更高
npm --version

第三步：部署OpenClaw

依赖安装完毕后，就可以开始安装OpenClaw本身了。这里有两种方式，你可以根据自己的需求选择。

方式一：快速安装（推荐新手）

官方提供了一键安装脚本，它会自动处理大部分配置。

在Ubuntu终端中运行：

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

安装脚本完成后，通常会自动启动配置向导。如果中途退出或想重新配置，可以随时运行openclaw onboard --install-daemon。

方式二：源码安装（适合开发和定制）

如果你希望深入学习和修改OpenClaw的代码，这种方式会更适合。

克隆代码仓库：

git clone https://github.com/openclaw/openclaw.git
cd openclaw

创建并激活Python虚拟环境（推荐，避免依赖冲突）：

sudo apt install -y python3-pip python3-venv  # 确保安装了Python3和venv
python3 -m venv venv
source venv/bin/activate

安装项目依赖：

# 以开发模式安装Python依赖
pip install -e .

# 安装Node.js依赖
npm install

初始化配置：
```
openclaw onboard
```

第四步：配置并启动OpenClaw

配置API密钥：OpenClaw本身不包含AI模型，需要连接外部的大语言模型服务。在onboard向导中，你会被要求选择一个模型提供商（如OpenRouter, 阿里云百炼等）并输入你的API Key。如果没有API Key，可以先在一些平台（如OpenRouter）注册获取。
- 小提示：如果你希望完全本地且免费地运行，可以尝试集成Ollama来调用本地模型，但这需要更高的电脑配置。
启动服务：配置完成后，启动OpenClaw的核心服务——Gateway。
```
openclaw gateway start
```
验证服务状态：
```
openclaw status
# 或者
openclaw gateway status
```
如果显示服务正在运行，就说明安装成功了。
访问Web控制台：在浏览器中访问http://localhost:18789，你应该能看到OpenClaw的Web操作界面，可以在这里开始与你的AI助手对话。

注意事项与故障排查

文件访问：WSL内的Linux系统可以通过/mnt/c/路径来访问你的Windows C盘文件（例如cd /mnt/c/Users/你的用户名/Desktop）。
网络代理：如果你在安装依赖时遇到网络问题，可以在WSL中配置代理。在~/.bashrc文件中添加以下内容（将1080替换为你的本地代理端口）：
```
export http_proxy=http://host.docker.internal:1080
export https_proxy=http://host.docker.internal:1080
```
然后执行source ~/.bashrc使其生效。
command not found错误：如果安装后提示找不到openclaw命令，通常是因为npm的全局安装目录没有添加到PATH环境变量中。可以运行npm prefix -g找到npm全局路径，然后将该路径下的bin文件夹（例如/home/你的用户名/.npm-global/bin）添加到~/.bashrc文件的PATH中。