Windows 系统 WSL2 Ubuntu 部署 OpenClaw | 极客日志

Shell / BashNode.jsAI

Windows 系统 WSL2 Ubuntu 部署 OpenClaw

Windows 系统通过 WSL2 安装 Ubuntu 环境，配置 Node.js 及 OpenClaw 智能体工具。步骤包括启用 WSL 功能、安装 Ubuntu 24.04 LTS、更新内核与系统、安装 Node.js 22+。使用一键脚本部署 OpenClaw，配置本地模型 Ollama 监听地址以支持 WSL2 访问。修改配置文件设置 Token 与 Workspace，并配置开机自动启动 Ubuntu 任务。最终实现本地 AI 助手部署与运行。

刀狂发布于 2026/3/15更新于 2026/5/1312 浏览

这是官方推荐的 Windows 部署方式，提供最完整的 Linux 环境支持。

准备：启用适用于 Linux 的 Windows 子系统和虚拟化平台，重启电脑。

文章配图

1. 启用 WSL2

以管理员身份打开 PowerShell，执行：

# 启用 WSL 功能
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

文章配图

# 设置 WSL 2 为默认版本，部分电脑此步可能报错，此处暂不理会，通过下文中的 WSL 内核更新解决
wsl --set-default-version 2

文章配图

2. 安装 Ubuntu

方法 1：Microsoft Store 安装（推荐）

打开 Microsoft Store
搜索「Ubuntu 24.04 LTS」
点击「获取」并安装

安装完成后会自动打开 Ubuntu 终端，按提示设置用户名和密码。

文章配图

方法 2：wsl 命令安装

wsl --install -d Ubuntu-24.04

部分电脑报错无法解析服务器的名称或地址

文章配图

解决方案

打开 /C:\Windows\System32\drivers\etc 文件，添加 IP domain 的对，如图：

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux

wsl --update

# 停止 Windows Update 服务
net stop wuauserv

# 重新启动服务
net start wuauserv

wsl --update --web-download

wsl --set-version Ubuntu-24.04 2

wsl -l -v

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

sudo apt install -y curl git wget build-essential

# 添加 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

# 安装 Node.js
sudo apt install -y nodejs

# 验证版本（必须 ≥ 22.x）
node -v
npm -v

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

mkdir ~/.npm-global

npm config set prefix '~/.npm-global'

echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc

source ~/.bashrc

setx OLLAMA_HOST "0.0.0.0" /M

netstat -an | findstr 11434

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

curl http://172.28.240.1:11434/api/tags # 把 IP 换成你上面查到的

{
  "wizard": {
    "lastRunAt": "2026-02-19T08:45:16.629Z",
    "lastRunVersion": "2026.2.17",
    "lastRunCommand": "onboard",
    "lastRunMode": "local"
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "ollama/qwen3:8b",
        "fallbacks": ["openai/gpt-5.1-codex"]
      },
      "models": {
        "ollama/qwen3:8b": {},
        "openai/gpt-5.1-codex": {"alias": "GPT"}
      },
      "workspace": "/home/rgzn/.openclaw/workspace",
      "compaction": {"mode": "safeguard"},
      "maxConcurrent": 4,
      "subagents": {"maxConcurrent": 8}
    }
  },
  "messages": {"ackReactionScope": "group-mentions"},
  "commands": {"native": "auto", "nativeSkills": "auto"},
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "d3f44d798d67a145cbcb0caa5aa9b02de9fdad623384039c"
    },
    "tailscale": {"mode": "off", "resetOnExit": false},
    "nodes": {
      "denyCommands": ["camera.snap", "camera.clip", "screen.record", "calendar.add", "contacts.add", "reminders.add"]
    }
  },
  "meta": {
    "lastTouchedVersion": "2026.2.17",
    "lastTouchedAt": "2026-02-19T08:45:16.638Z"
  },
  "models": {
    "providers": {
      "ollama": {
        "baseUrl": "http://172.28.240.1:11434/v1",
        "apiKey": "ollama-local",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3:8b",
            "name": "Qwen3 8B",
            "reasoning": false,
            "input": ["text"],
            "cost": {"input": 0, "output": 0},
            "contextWindow": 131072,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

cd ~/.openclaw

mv openclaw.json openclaw.json.bak

nano openclaw.json

nano ~/.openclaw/openclaw.json

{
  "meta": {
    "lastTouchedVersion": "2026.2.9",
    "lastTouchedAt": "2026-02-12T00:45:51.950Z"
  },
  "wizard": {
    "lastRunAt": "2026-02-12T00:45:51.943Z",
    "lastRunVersion": "2026.2.9",
    "lastRunCommand": "configure",
    "lastRunMode": "local"
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "deepseek/deepseek-chat",
        "fallbacks": ["openai/gpt-5.1-codex"]
      },
      "models": {
        "deepseek/deepseek-chat": {},
        "openai/gpt-5.1-codex": {"alias": "GPT"}
      },
      "workspace": "/home/syh/.openclaw/workspace",
      "compaction": {"mode": "safeguard"},
      "maxConcurrent": 4,
      "subagents": {"maxConcurrent": 8}
    }
  },
  "messages": {"ackReactionScope": "group-mentions"},
  "commands": {"native": "auto", "nativeSkills": "auto"},
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "66682db26fe6f1693570085e2009c52bf8a688901aa542fc"
    },
    "tailscale": {"mode": "off", "resetOnExit": false},
    "nodes": {
      "denyCommands": ["camera.snap", "camera.clip", "screen.record", "calendar.add", "contacts.add", "reminders.add"]
    }
  },
  "skills": {"install": {"nodeManager": "npm"}},
  "tools": {
    "web": {
      "search": {"enabled": false},
      "fetch": {"enabled": true}
    }
  },
  "models": {
    "providers": {
      "deepseek": {
        "baseUrl": "https://api.deepseek.com/v1",
        "apiKey": "填入你的 API KEY",
        "api": "openai-completions",
        "models": [
          {
            "id": "deepseek-chat",
            "name": "DeepSeek Chat",
            "reasoning": false,
            "input": ["text"],
            "cost": {"input": 0.14, "output": 0.28},
            "contextWindow": 128000,
            "maxTokens": 4096
          }
        ]
      }
    }
  }
}

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