本地AI自由！OpenClaw + Ollama 全离线部署实战手册 (Windows版)
厌倦了云端AI的Token计费焦虑和隐私泄露风险？想拥有一位完全听命于你的本地AI助手？本文将手把手教你，无需深厚编程基础，只需跟随步骤执行命令，即可在个人电脑上搭建属于你的全功能AI Agent。
核心优势：零费用：无需API Key，彻底告别按量付费。强隐私：数据全程本地处理，断网也能流畅使用。高自由：随心切换Qwen、GLM等顶尖开源模型。
️ 第一阶段：环境准备（地基搭建）
在开始之前，请以管理员身份打开 PowerShell (按下 Win + X 选择)。这是我们接下来的操作中心。
1. 安装 Node.js (v18+)
Node.js 是 OpenClaw 的运行环境，安装它时 npm 会自动就位。
- 访问 Node.js 官网，下载 LTS (长期支持) 版本的 Windows 安装包 (.msi)。
- 双击运行安装程序。关键步骤：在自定义安装界面，务必勾选
Add to PATH。 - 一路 Next 完成安装。
验证：在 PowerShell 中输入以下命令，若显示版本号（如 v18.x.x），则成功。
node-vnpm-v2. 安装 Git
Git 用于管理代码和扩展技能，是生态的重要组成部分。
- 访问 Git 官网 下载 Windows 版安装包。
- 运行安装程序，建议保持所有默认选项，特别是确保将 Git 添加到系统 PATH 中。
验证：在 PowerShell 中输入命令，若显示版本信息则成功。
git--version️ 第二阶段：部署 Ollama (本地模型引擎)
Ollama 是你的本地模型管家，负责承载AI的“大脑”。
1. 安装与配置
- 访问 Ollama 官网 下载 Windows 版本并安装。
- 环境变量配置 (推荐)：为了让模型响应更快，避免重复加载，建议设置模型常驻内存。
- 按下
Win键，搜索“环境变量”，点击「编辑系统环境变量」 -> 「环境变量」。 - 在“系统变量”中点击「新建」：
- 变量名：
OLLAMA_KEEP_ALIVE - 变量值：
24h
- 变量名：
- 按下
2. 下载核心模型 (解决“找不到模型”问题的关键)
很多用户报错 file does not exist 是因为模型标签过旧或拼写错误。请使用以下绝对可用的命令：
- 验证：下载完成后，看到
>>>符号即代表模型已在本地运行。
备选方案 (国内镜像)：
如果官网下载速度慢或失败，可以尝试国内开发者维护的镜像：
ollama run dengcao/qwen:8b-q4_0 首选通用命令 (推荐)：
直接运行以下命令，Ollama 会自动匹配并下载一个性能均衡的量化版通义千问模型（约5-6GB）。
ollama run qwen:8b-instruct-q4_K_M 解释：q4_K_M是目前兼容性最好的量化格式，在8GB显存的设备上也能流畅运行，完美替代了你之前遇到问题的q4_0。
第三阶段：部署 OpenClaw (AI Agent 核心)
OpenClaw 是AI的大脑，它将利用 Ollama 提供的模型能力，执行复杂的任务自动化。
1. 安装 OpenClaw
在 PowerShell 中执行以下命令进行全局安装：
npminstall-g openclaw 若安装速度慢，可先切换国内源：npm config set registry https://registry.npmmirror.com
验证：
openclaw --version 2. 初始化与配置
- 初始化向导：
openclaw onboard - 在交互式向导中，除模型配置外可一路回车。当询问是否配置模型时，选择
Skip for now(稍后手动配置)。 - 手动对接 Ollama：
依次执行以下三行命令，告诉 OpenClaw 如何连接本地的 Ollama。注意：第三行的模型名必须与ollama list中显示的完全一致。
openclaw config set models.providers.ollama.apiKey "ollama-local" openclaw config set models.providers.ollama.baseUrl "http://localhost:11434/v1" openclaw config set models.default "ollama/qwen:8b-instruct-q4_K_M" - 重启生效：
openclaw restart openclaw gateway start 第四阶段：启动与验证 (见证奇迹)
1. 获取访问令牌
在 PowerShell 中执行，生成并复制你的登录令牌：
openclaw token generate 2. 打开 Web 控制台
- 打开浏览器，访问：http://localhost:18789/
- 粘贴刚才复制的令牌，点击登录。
3. 开始对话
在输入框中输入：“你好，本地助手！”，如果收到流畅回复，恭喜你，部署成功！现在你可以断开网络测试，它依然能工作。
️ 附录：常见问题与避坑指南
| 问题现象 | 解决方案 |
|---|---|
| 拒绝访问 / 权限不足 | 请务必右键点击 PowerShell，选择 “以管理员身份运行” 后再执行命令。 |
| node 不是内部命令 | Node.js 安装时未配置环境变量。请重装 Node.js，并勾选 Add to PATH。 |
| 拉取模型速度极慢 | 使用国内镜像命令 ollama run dengcao/qwen:8b-q4_0，或开启代理工具。 |
| 模型上下文太小 | 请务必使用 q4_K_M 等量化版本，它们通常已包含足够的上下文窗口（约32K）。 |
** 进阶提示**：
部署完成后，你可以在控制台安装“文件处理”、“浏览器控制”等插件，让你的本地AI助手帮你自动整理下载文件夹、查询资料，真正解放生产力！
