乐于分享
好东西不私藏

OpenClaw | 03 Windows 安装

OpenClaw | 03 Windows 安装

保姆级|Windows+WSL2+Ollama+OpenClaw:本地 AI 网关部署全攻略

适配 RTX5060 等 N 卡,全程踩坑实测,新手直接抄作业

重要事情说三遍:

不要在Windows安装,采用Windows+WSL2方式安装!

不要在Windows安装,采用Windows+WSL2方式安装!

不要在Windows安装,采用Windows+WSL2方式安装!

已踩坑:电脑系统出问题,以前的软件不可用了!

一、前言

想在本地搭建专属 AI 工作台?OpenClaw是一款开源 AI 网关工具,可对接 Ollama 本地大模型,提供可视化面板、多模型切换、技能插件、联网搜索、文件解析、读图识图等能力。Windows 原生部署存在端口占用、开机自启难控等问题,WSL2(Ubuntu 子系统)是更稳定、干净的运行环境,今天手把手教你完整部署流程,从环境配置到多模态读图、技能配置全搞定。

二、前期准备:开启 Windows WSL2 环境

1. 开启系统功能

以管理员身份打开 PowerShell,依次执行:

# 开启WSL功能wsl --install# 直接安装Ubuntu默认子系统wsl --install -d Ubuntu

重启电脑后,完成 Ubuntu 初始化用户名密码设置。

2. 安装 NVIDIA GPU 驱动(关键!)

1Windows 端安装最新 NVIDIA 显卡驱动

1WSL2 内安装 CUDA 适配工具,确保 Ollama 能调用 GPU 加速推理

三、WSL2 内安装 Ollama,部署本地大模型

1. 一键安装 Ollama

Ubuntu 终端执行官方脚本:

curl -fsSL https://ollama.com/install.sh | sh

2. 拉取大模型(文本 + 读图双版本)

# 1. 通义千问Qwen3.5-9B 文本大模型(日常对话首选)ollama pull qwen3.5:9b# 2. 多模态读图模型(后期补充,解决图片识别)# 网络不稳定优先选 qwen2.5-vl:3b 轻量读图版ollama pull qwen2.5-vl:3b

避坑提醒:qwen3.5-vl:9b官方暂未上架 Ollama,直接拉取会提示文件不存在,不要踩坑!

3. 验证 Ollama 运行

ollama run qwen3.5:9b

能正常对话,即 GPU 推理环境正常。

四、WSL2 安装 & 启动 OpenClaw 网关

1. 一键安装 OpenClaw

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

2. 核心配置:对接 Ollama 模型

编辑配置文件

vim ~/.openclaw/openclaw.json

粘贴以下配置,同时支持文本 + 读图模型:

{  "gateway": {"mode":"local"},  "models":{    "providers":{      "ollama":{        "baseUrl":"http://127.0.0.1:11434",        "apiKey":"ollama-local",        "api":"ollama",        "models":[          {"id":"qwen3.5:9b","name":"Qwen3.5 9B 文本","input":["text"],"contextWindow":262144},          {"id":"qwen2.5-vl:3b","name":"Qwen2.5-VL 3B 读图","input":["text","image"],"contextWindow":131072}        ]      }    }  },  "agents":{"defaults":{"model":{"primary":"ollama/qwen3.5:9b"}}}}

3. 启动 & 验证网关

# 启动网关openclaw gateway# 查看运行状态openclaw gateway status

出现ready即启动成功,浏览器访问:http://127.0.0.1:18789,进入 OpenClaw 可视化面板。

五、进阶玩法:OpenClaw 技能配置

面板进入Skills页面,43 个待配置技能,WSL2 仅启用 Linux 可用技能:

1✅shell:AI 直接执行 Ubuntu 终端命令(nvidia-smi、文件操作等)

1✅file-read/file-write:本地文档读取、日志解析

1✅web-search:联网实时搜索❌ 禁用:apple 系列、Windows 专属技能,WSL2 无法使用

配置后,直接对话即可自动调用技能,实现全能本地 AI 助手。

六、总结

这套 Windows+WSL2+Ollama+OpenClaw 架构,完美解决原生 Windows 部署不稳定、GPU 调用异常、开机自启难控等问题,RTX5060 8G 显卡可流畅运行 9B 大模型,支持对话、代码、文档解析、读图识图、联网搜索、终端执行全功能。简单任务用9B模型,复杂任务用deepseek-v4-pro等模型,目前是个人本地 AI 工作台的最优方案

期待以后能免费或者限额调用32B及性能更强的模型!