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及性能更强的模型!
夜雨聆风