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