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

下面是详细的安装步骤。

第一步：准备WSL2 Linux环境

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

1. 启用WSL功能：以管理员身份打开PowerShell或命令提示符，输入以下命令并回车。这个命令会启用必要的Windows功能，并默认安装Ubuntu发行版。

   wsl --install
   

   安装完成后，请重启你的电脑。

2. 设置Ubuntu：电脑重启后，启动刚安装的Ubuntu（可以在开始菜单中找到）。首次启动会要求你设置一个新的用户名和密码，这个密码在后续执行sudo命令时会用到。

3. 验证WSL版本：为了确保最佳性能，建议使用WSL2。在PowerShell中运行以下命令，确认Ubuntu的版本是2。

   wsl -l -v
   

   如果版本是1，可以通过以下命令设置为WSL2：wsl --set-version <你的发行版名称> 2（将<你的发行版名称>替换为Ubuntu或上一步查询到的确切名称）。

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

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

1. 更新软件包列表：

   sudo apt update && sudo apt upgrade -y
   

2. 安装基础工具：

   sudo apt install -y git curl wget build-essential
   

3. 安装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的代码，这种方式会更适合。

1. 克隆代码仓库：

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

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

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

3. 安装项目依赖：

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

4. 初始化配置：

   openclaw onboard
   

第四步：配置并启动OpenClaw

1. 配置API密钥：OpenClaw本身不包含AI模型，需要连接外部的大语言模型服务。在onboard向导中，你会被要求选择一个模型提供商（如OpenRouter, 阿里云百炼等）并输入你的API Key。如果没有API Key，可以先在一些平台（如OpenRouter）注册获取。

   • 小提示：如果你希望完全本地且免费地运行，可以尝试集成Ollama来调用本地模型，但这需要更高的电脑配置。

2. 启动服务：配置完成后，启动OpenClaw的核心服务——Gateway。

   openclaw gateway start
   

3. 验证服务状态：

   openclaw status
   # 或者
   openclaw gateway status
   

   如果显示服务正在运行，就说明安装成功了。

4. 访问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中。

如果在安装过程中遇到其他问题，随时可以再问我。配置好API Key了吗？还是卡在了某一步？