Windows 10 22H2 及以上版本系统 WSL 调用本地 Ollama 大模型的 OpenClaw 安装方式

常规
1

前言：

在 Windows 系统下，通过WSL 2部署Ollama与OpenClaw，是兼顾兼容性、性能、跨系统协同、安全隔离与运维标准化的行业最优实践，也是官方与社区公认的标准方案。

Ollama：核心为 Linux/macOS 原生开发，Windows 原生版功能受限、依赖复杂、社区支持弱。
OpenClaw：基于 Node.js 构建，插件生态与执行环境完全面向 Linux/Unix，Windows 原生部署易出现依赖冲突、权限异常、插件不可用等问题。

WS L2基于 Hyper-V 虚拟化，运行真实 Linux 内核，而非翻译层（WSL 1），支持 systemd、Docker、GPU 透传等完整 Linux 能力。WSL 2 提供完整 Linux 内核与用户态，消除了跨平台兼容性鸿沟，是两者稳定运行的必要条件。
官方明确：WSL 2 是 Windows 上运行 OpenClaw 的推荐方式。

（ 以下操作步骤默认基于Windows 10 22H2 专业版 新装系统实现 ）

目录：

  1. 前置环境检查（步骤1-4）

  2. WSL2环境搭建（步骤5-8）

  3. Ollama安装配置（步骤9-10）

  4. Node.js环境配置（步骤11-12）

  5. OpenClaw安装（步骤13-14）

  6. 启动与使用（步骤15-17）

  7. BIOS 虚拟化：

    Intel VT-x（ Intel 平台 ）或 AMD-V（ AMD 平台 ） —— 确保设置为：Enabled

    也可以在任务管理器里查看 —— Ctrl + Shift + Esc 打开任务管理器 —— 性能 —— 虚拟化：已启用

2： 确认系统版本

  按 Win + R 键，输入 winver，回车 —— 在弹出的窗口中确认：

  版本号是 22H2（ 你的系统符合要求 ）
  构建号在 19045 或更高

3： 开启所有必要的 Windows 功能：

  控制面板 —— 程序 —— 程序和功能 —— 启用或关闭 Windows 功能 —— 勾选以下 4 项：

 （1）适用于 Linux 的 Windows 子系统（ WSL 核心组件 ）
 （2）虚拟机平台（ WSL2 必须 ）
 （3）Windows 虚拟机监控程序平台
 （4）Hyper-V （ WSL2 依赖的虚拟化技术 ）

4：（4-1）执行系统更新至不再更新（ 升级操作系统除外 ）

 （4-1）更新Edge浏览器或下载最新版谷歌浏览器！（ 本操作至关重要！可大幅降低因浏览器导致的：语言兼容、后续网络连通性等问题 ）

 （4-3）更新 Microsoft Store（ 微软应用商店 ）
           *本步骤非必要操作，但在网络连通性不好的时候可以提供更多可操作选项，对后续6、7、12步骤有极大便利性

5： 系统需开启虚拟化功能。请以管理员身份打开 PowerShell ，执行以下命令并重启：

 （5-1）dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

 （5-2）dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

  1. 安装 WSL2 核心组件：在 PowerShell 中设置 WSL2 为默认版本

    （6-1）设置 WSL 默认版本为 2：
    wsl --set-default-version 2

    （6-2）更新 WSL 到最新版本（ 确保支持 systemd ）：
    wsl --update
    *若网络不畅可在 Microsoft Store（ 微软应用商店 ）中查询并安装 wsl

  2. 安装 Ubuntu

    wsl --install -d Ubuntu-22.04

    安装后启动 Ubuntu，按提示创建用户名和密码

    *若网络不畅可在 Microsoft Store（ 微软应用商店 ）中查询并安装 Ubuntu ，本文中使用22.04较稳定版本 ，此版本可在微软应用商店中搜到

  3. 更新系统并安装基础工具 —— 在 Ubuntu 终端中，依次执行以下命令：

    （8-1）更新软件源：
    sudo apt update

    （8-2）升级已安装的软件包：
    sudo apt upgrade -y

    （8-3）安装 Git 和 curl：
    sudo apt install -y git curl

    （8-4）验证安装：
    git --version
    curl --version

    （8-5）查看 WSL 在 Windows 中的状态 —— PowerShell ：
    wsl --list --verbose

  4. 安装 WSL 中的压缩解压工具 —— zstd：

    sudo apt-get install zstd -y

  5. 安装 Ollama :

    （10-1）安装Ollama：
    curl -fsSL https://ollama.com/install.sh | sh
    （ 备用地址：curl -fsSL https://cnb.cool/hex/ollama/-/git/raw/main/install.sh | sh ）

    （10-2）验证 Ollama 安装：
    ollama --version

    （10-3）启动 Ollama 服务：
    ollama serve & （ 后台运行，不占用当前终端；退出终端后进程可能终止 ！）
    *建议：使用前台运行（新开终端） 则无需执行15-6步骤

  6. 安装大模型 —— （ 示例 ）qwen3.5:9b ：

    ollama pull qwen3.5:9b
    （ 可使用 ghfast.top 加速：OLLAMA_MIRROR=“https://ghproxy.cn/https://github.com/ollama/ollama/releases/latest/download” ollama pull qwen3.5:9b ）

  7. 安装 npm（ Node.js 包管理器）：

    （12-1）安装 npm ：
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

    （12-2）安装最新的 LTS 版本 Node.js ：
    nvm install --lts

    （12-3）切换当前终端会话使用 LTS 版本：
    nvm use --lts

    （12-4）设置系统默认 Node.js 版本为最新 LTS 版：
    nvm alias default ‘lts/*’

    （12-5）验证安装，检查一下版本：
    node -v
    npm -v

    *若本步骤网络连通性实在不行，可以就 Node 官网：Node.js — 下载 Node.js® 下载 .msi 安装包替代（ 不建议，但可以解决眼下麻烦 ）

  8. 重新配置用户目录：

    （13-1）创建用户目录：
    mkdir -p ~/.npm-global

    （13-2）设置 npm 使用这个目录：
    npm config set prefix ~/.npm-global

    （13-3）验证配置是否写入：
    npm config get prefix

    （13-4）添加到 PATH（ 关键步骤 ）：

             （13-4-1）配置环境变量：
                         echo 'export PATH=$HOME/.npm-global/bin:$PATH' >> ~/.bashrc

         （13-4-2）立即生效：
                         source ~/.bashrc

         （13-4-3）验证 PATH 是否包含：
                         echo $PATH | grep .npm-global

    *本步骤至关重要！OpenClaw 很多兼容性问题皆因此步骤未提前做好！！！

  9. 完成以上步骤后，安装 OpenClaw ：

    （14-1）强制 Git 走 HTTPS：
    git config --global url.“https://github.com/”.insteadOf git@github.com:

    （14-2）验证配置是否生效
    git config --global --list | grep insteadOf

    （14-3）正式安装 OpenClaw ：
    npm i -g openclaw

    （14-4）验证安装：

            （14-4-1）查找 openclaw 可执行文件的位置：
                        which openclaw

        （14-4-2）验证版本和完整性：
                        openclaw --version

  10. 安装 net-tools ：

    sudo apt update && sudo apt install net-tools -y

  11. 准备启动 OpenClaw （ 在此之前若退出 Ubuntu 过终端，请确认Ollama服务被再次启动！ollama serve & ）：

    （16-1）快速状态检查：
    openclaw status

    （16-2）查看 OpenClaw 完整状态：
    openclaw status --all

    （16-3）网关连通性探测：
    openclaw gateway probe

    （16-4）网关详细状态：
    openclaw gateway status

    （16-5）自检并修复可能存在的问题：
    openclaw doctor

*（16-6）在此之前若退出 Ubuntu 过终端，请确认 Ollama 服务被再次启动并检查模型列表：
ollama serve & （ 后台运行，不占用当前终端；退出终端后进程可能终止 ）
ollama list

  1. 启动 OpenClaw ：

    （17-1）完成初始化配置（ 仅首次运行 ）：
    openclaw onboard --install-daemon

    （17-2）启动 OpenClaw ：

            （17-2-1）调试模式（ 前台运行 ）：
                        openclaw gateway run

        （17-2-2）守护进程模式（ 后台运行 ）：
                       openclaw gateway start

        （17-2-3）查看并确认运行状态：
                       openclaw gateway status

    （17-3）查看实时日志（ 若无报错之后按 Ctrl + C 退出 )：
    openclaw logs --follow

  2. OpenClaw WebUi ：

    根据安装配置完成后的输入日志，token=80c4d9da28ac5f0b7fd4a67ecebde5a51e43ae753f76dffe （ 示例 ）字符串
    输入至浏览器，格式：http://localhost:18789/#token=80c4d9da28ac5f0b7fd4a67ecebde5a51e43ae753f76dffe 打开 OpenClaw 网页交互界面，即可开始使用（ 此方法较稳妥 ）

*注：步骤10、11、14，即：安装 Ollama 、大模型 、OpenClaw 时，若遇网络不畅，可选哈希值相同的加速连接，但务必和原版保持一致！否则后续可能导致诸多兼容性和安全问题！