OpenClaw + Ollama + Gemma 4 本地部署完全教程
适用于 Mac mini M4 / MacBook，完全离线、免费、私有化部署方案 ⸻ 一、核心结论 特性 说明 完全离线 断网、不联网照样能用 无需 API 不需要云端 API Key 数据安全 公司机密文件不出本地电脑 零费用 免费使用，无调用成本
唯一需要联网的场景：
第一次下载模型权重
第一次安装 Ollama / 依赖库
更新模型或软件时
⸻ 二、三者关系图解
┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ OpenClaw │────▶│ Ollama │────▶│ Gemma 4 │ │ (整台车) │ │(发动机支架) │ │ (发动机) │ └─────────────┘ └─────────────┘ └─────────────┘ 用户界面 模型管理/接口 AI大脑
Gemma 4 = 发动机（负责思考、推理）
Ollama = 发动机支架 + 接口面板（负责启动、管理模型，提供调用接口）
OpenClaw = 整台车（方向盘、仪表盘、操控系统）
OpenClaw 不直接碰 Gemma 4，只跟 Ollama 说话，Ollama 再转给 Gemma 4。 ⸻ 三、部署步骤
步骤 1：安装 Ollama
访问官网下载安装： https://ollama.com
步骤 2：下载并运行 Gemma 4
在 Mac 终端执行： ollama run gemma4
看到能聊天，说明本地模型已启动。
步骤 3：OpenClaw 配置
在 OpenClaw 中填写以下 4 项： 配置项 填写内容 模型类型 ollama 接口地址 http://127.0.0.1:11434 模型名称 gemma4 API Key 留空（本地不需要） ⸻ 四、给技术的一句话说明
本地用 Ollama 跑 Gemma 4，OpenClaw 对接本地地址 http://127.0.0.1:11434，模型名 gemma4，纯离线调用，不联网、不用 API。 ⸻ 五、本地知识库方案（RAG）
方案 A：手动粘贴（适合少量机密文档）
在 OpenClaw 对话框中：
下面是公司机密文档： [粘贴文档全文]
帮我总结这个文档的关键点。
优点： 最简单、最安全、零配置
缺点： 每次都要手动粘贴
方案 B：真正的本地知识库（推荐）
所需工具（全免费、本地运行）：
Ollama（已有）
Gemma4（已有）
OpenClaw（已有）
本地向量库：Chroma / LanceDB（超轻量）
工作流程：
- 指定本地文件夹（如：/Users/用户名/公司机密文档/） ↓
- 扫描文档 → 转文本 → 存入本地向量库 ↓
- 提问时：OpenClaw → 查本地向量库 → 发给 Gemma4 → 本地出答案
安全保证：
✅ 文件不会离开你的 Mac
✅ 不会上传到任何服务器
✅ 全程离线，不联网
✅ 只有你指定的目录能被读取
✅ 其他文件、系统文件完全碰不到
给技术的配置话术（复制即用）
我要做本地RAG知识库，要求：
- 只读取我指定的本地文件夹，不扫描其他位置
- 向量库存在本地，不上云
- 全程离线，不联网
- 调用本地 Ollama 的 gemma4 模型
- 接口对接 OpenClaw
- 确保公司机密文件绝对不出本地电脑
⸻ 六、本地智能体（Agent）方案
当前结构 组件 功能 Gemma 4 思考、判断、决策（大脑） 缺少 工具调用、记忆、计划、执行、工作流
要做 Agent，必须加一层执行框架。
推荐方案：OpenClaw 直接调用 Ollama（你现在就在用的）
OpenClaw = 智能体外壳
Ollama = 本地大脑
能做的事情：
理解你的意图
调用本地工具
执行工作流
完全不联网、不用 API
进阶方案 方案 适用场景 特点 Open Interpreter 个人/小团队 轻量代码方案，脚本向 Ollama 提问并执行动作 LangChain / AutoGen 专业级 支持工具调用、多轮记忆、任务拆解、RAG
LangChain 配置示例： llm: ollama://gemma4
⸻ 七、关键认知
本地模型的定位 场景 解决方案 对外查实时信息 用云端 API（豆包、Kimi、DeepSeek） 对内处理公司数据、工作流、私有化部署 用本地模型（Gemma 4）
本地模型的能力边界
✅ 推理、逻辑、写作、代码、总结
✅ 处理企业内部文档、流程、话术
❌ 知道"今天发生什么"（训练截止前的知识）
❌ 实时联网查资料
离线 = 安全、可控、免费，但没有实时信息。 ⸻ 八、总结
你现在这套方案：
Mac mini M4 + 本地 Gemma 4 + 本地 OpenClaw
就是标准的 完全离线本地 AI 方案：
✅ 本地部署
✅ 免费
✅ 不走外网
✅ 不泄露公司数据
✅ OpenClaw 用本地 Gemma 4 当大脑
100% 能通，放心用。