Windows 系统 WSL2 部署 OpenClaw 实战指南

使用官方脚本进行安装：

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

安装过程中会弹出配置向导：

1. 权限确认：选择 Yes 表示同意风险。
2. Onboarding 模式：新手建议选择 QuickStart，跳过非必要配置项快速完成。
3. 模型配置：国内用户若使用 Moonshot 等模型，接口地址可能与默认不同，建议先选 Skip for now，后续单独配置。
4. 通道选择：如飞书集成可按需填写，也可暂选 Skip。
5. 技能状态：根据提示安装常用工具，或选 Skip。

安装完成后，若提示 command not found，需手动配置环境变量：

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

此时执行 openclaw 指令应能正常运行，网关默认监听在 http://127.0.0.1:18789。

第六步：本地模型 Ollama 配置

Ollama 默认只监听 localhost，需修改配置允许外部访问。

1. Windows 端设置环境变量 以管理员身份打开 PowerShell：

setx OLLAMA_HOST "0.0.0.0" /M

重启 Ollama 服务（任务栏小羊驼图标右键 Quit 后重新从开始菜单启动）。验证端口是否监听所有接口：

netstat -an | findstr 11434

若看到 0.0.0.0:11434 或 :::11434 处于 LISTENING 状态即成功。

2. WSL2 端获取宿主机 IP 在 Ubuntu 中执行以下命令获取 Windows 在 WSL 网络中的真实网关 IP：

ip route show | grep default | awk '{print $3}'

通常结果为 172.x.x.x 格式。使用该 IP 测试连通性：

curl http://<你的网关IP>:11434/api/tags

第七步：修改配置文件

编辑配置文件以绑定正确的模型地址和 Token。

cd ~/.openclaw
mv openclaw.json openclaw.json.bak
nano openclaw.json

主要修改以下几点：

1. Token：替换为你安装时保存的 Token。
2. Workspace：路径中的用户名需改为当前实际用户名。
3. BaseUrl：将 Ollama 的地址改为上述获取的网关 IP。

云端 API 配置示例（如 DeepSeek）：

{
  "models": {
    "providers": {
      "deepseek": {
        "baseUrl": "https://api.deepseek.com/v1",
        "apiKey": "填入你的 API KEY",
        "api": "openai-completions"
      }
    }
  }
}

第八步：设置开机自动启动

为了让 Ubuntu 随系统启动，可使用任务计划程序：

1. 查找 Ubuntu 应用的 AUMID：

   Get-StartApps | Where-Object { $_.Name -like "*Ubuntu*" }
   

2. 创建基本任务，触发器设为'计算机启动时'。
3. 操作类型选'启动程序'，程序填 explorer.exe。
4. 参数填：shell:AppsFolder\CanonicalGroupLimited.Ubuntu24.04LTS_79rhkp1fndgsc!ubuntu2404（请替换为你实际的 AUMID）。

完成上述步骤后，重启电脑即可自动进入环境。