AI小龙虾OPENCLAW WSL2部署指南

系统要求

Windows系统要求

• Windows 10版本：1903或更高（内部版本18362+）
• Windows 11：所有版本均支持
• 硬件虚拟化：BIOS/UEFI中需启用虚拟化支持（Intel VT-x/AMD-V）

部署步骤

启用WSL功能

# 以管理员身份打开PowerShell
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

重启计算机

安装WSL2内核更新

下载并安装：WSL2 Linux内核更新包

设置WSL2为默认版本

wsl --set-default-version 2

安装Linux发行版

# 查看可用发行版
wsl --list --online
# 安装Ubuntu 22.04（推荐）
wsl --install -d Ubuntu-22.04
# 或通过Microsoft Store安装

配置WSL2

# 进入WSL终端
wsl
# 更新系统
sudo apt update && sudo apt upgrade -y
# 安装基础工具
sudo apt install -y git curl wget build-essential python3-pip python3-venv

部署OPENCLAW

从源码部署

# 克隆项目
git clone https://github.com/openclaw/ai-lobster.git
cd ai-lobster
# 创建虚拟环境
python3 -m venv venv
source venv/bin/activate
# 安装依赖
pip install --upgrade pip
pip install -r requirements.txt
# 安装PyTorch（根据CUDA版本选择）
# CPU版本
pip install torch torchvision torchaudio
# CUDA 11.8版本
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118

使用Docker（推荐）

# 安装Docker in WSL2
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo usermod -aG docker $USER
# 拉取OPENCLAW镜像
docker pull openclaw/ai-lobster:latest
# 运行容器
docker run -it \
  --gpus all \
  -p 7860:7860 \
  -v /mnt/c/Users/YourName/OpenClawData:/data \
  openclaw/ai-lobster:latest

GPU支持配置（可选）

# 1. Windows端安装NVIDIA驱动
# 从官网下载最新Game Ready驱动
# 2. WSL2内安装CUDA工具包
wget https://developer.download.nvidia.com/compute/cuda/repos/wsl-ubuntu/x86_64/cuda-keyring_1.0-1_all.deb
sudo dpkg -i cuda-keyring_1.0-1_all.deb
sudo apt update
sudo apt install -y cuda-toolkit-12-2
# 3. 验证安装
nvidia-smi

环境配置

创建配置文件：

# 创建配置目录
mkdir -p ~/.openclaw/config
# 编辑配置文件
cat > ~/.openclaw/config/settings.yaml << EOF
model:
  name: "openclaw-v1.0"
  device: "cuda"  # 或 "cpu"
  precision: "fp16"
data:
  input_path: "/mnt/c/Users/YourName/inputs"
  output_path: "/mnt/c/Users/YourName/outputs"
  cache_dir: "~/.cache/openclaw"
server:
  host: "0.0.0.0"
  port: 7860
  workers: 2
EOF

启动服务

# 进入项目目录
cd ai-lobster
# 启动Web服务
python webui.py \
  --config ~/.openclaw/config/settings.yaml \
  --share  # 生成公网链接（可选）
# 或使用Gradio启动
python -c "from openclaw import webui; webui.launch()"

常用命令

WSL管理命令

# 查看已安装的发行版
wsl -l -v
# 停止WSL
wsl --shutdown
# 导出/导入备份
wsl --export Ubuntu-22.04 backup.tar
wsl --import Ubuntu-22.04 C:\WSL\NewUbuntu backup.tar
# 设置默认用户
<distro>.exe config --default-user username

OPENCLAW服务管理

# 后台运行
nohup python webui.py > openclaw.log 2>&1 &
# 查看日志
tail -f openclaw.log
# 停止服务
pkill -f "webui.py"

性能优化建议

1. 内存配置：编辑 .wslconfig

   [wsl2]
   memory=8GB    # 限制内存使用
   processors=4  # 分配CPU核心
   swap=4GB      # 交换空间
   localhostForwarding=true

2. 存储位置优化

   # 将WSL迁移到非系统盘
   wsl --shutdown
   wsl --export Ubuntu-22.04 D:\WSL\ubuntu.tar
   wsl --import Ubuntu-22.04 D:\WSL\Instances\Ubuntu D:\WSL\ubuntu.tar

3. 跨平台文件访问

   # Windows文件在 /mnt/c/ 下
   # 建议将频繁访问的数据放在Linux文件系统中以提高性能

故障排除

常见问题解决

1. WSL启动失败

   # 重置WSL
   wsl --unregister Ubuntu-22.04
   wsl --install -d Ubuntu-22.04

2. GPU不可用

   # 检查驱动
   nvidia-smi

重新安装CUDA

sudo apt purge nvidia- cuda- sudo apt autoremove sudo apt install cuda-toolkit-12-2

3. **内存不足**
```bash
# 清理内存
sudo sync && echo 3 | sudo tee /proc/sys/vm/drop_caches

获取帮助

• 项目文档：https://docs.openclaw.ai
• GitHub Issues：https://github.com/openclaw/ai-lobster/issues
• WSL官方文档：https://docs.microsoft.com/windows/wsl/

更新维护

# 更新OPENCLAW
cd ai-lobster
git pull origin main
pip install -r requirements.txt --upgrade
# 更新系统
sudo apt update && sudo apt upgrade -y
# 清理缓存
docker system prune -a
pip cache purge

---

注意：确保Windows和WSL2都已安装最新更新以获得最佳性能和兼容性。

标签： OPENCLAW WSL2