OpenClaw 配置本地 Ollama 模型指南:Auth 设置与离线部署
前置要求(硬件与软件准备)
硬件建议(本地模型跑得顺的关键):
- GPU:NVIDIA RTX 4060 及以上(8GB+ 显存推荐),Apple Silicon M2/M3/M4 也极佳。
- 内存:16GB 起步,32GB 更流畅(OpenClaw 系统提示词 + 工具调用很容易吃 10k+ tokens)。
- 磁盘:20GB+ 剩余空间(模型文件很大)。
- CPU:至少 8 核(无 GPU 时备选)。
软件要求:
- Ollama 0.17 或更高(官方强烈推荐)
- Node.js 18+(npm 安装 OpenClaw)
- Windows 用户建议用 PowerShell 以管理员身份运行;macOS/Linux 用终端即可。
- 可选:Git(安装技能时用到)
检查命令(全部复制粘贴执行):
node --version # 应 >= v18
npm --version # 应 >= 8
ollama --version # 应 >= 0.17
步骤 1:安装 Ollama 并拉取本地模型
拉取推荐本地模型(强烈建议先用 7B-14B 量化版测试):
# 通用推荐(速度快、效果好)
ollama pull qwen2.5:7b
ollama pull qwen3:8b # 2026 新模型,推理更强
ollama pull glm-4.7-flash # ~25GB VRAM,适合强推理
ollama pull llama3.3:8b # Meta 经典
进阶:创建大上下文模型(OpenClaw 必须 ≥16k tokens) OpenClaw 默认需要 16k+ 上下文,否则会报错。我们用 Modelfile 扩展:
# Windows(PowerShell)
cd ~
@"
FROM qwen2.5:7b
PARAMETER num_ctx 32768
"@ | Out-File -Encoding ascii Modelfile
ollama create qwen2.5:7b-32k -f Modelfile
macOS/Linux 同理用 cat > Modelfile 创建文件。验证:
ollama list
ollama show qwen2.5:7b-32k --modelfile
现在模型就绪,Ollama 服务默认监听 http://127.0.0.1:11434。
步骤 2:安装 OpenClaw
最推荐方式(官方一键法,2026 新特性):
ollama launch openclaw
Ollama 会自动检查并通过 npm 安装 OpenClaw,弹出模型选择器,启动 TUI(终端界面)。 直接在终端聊天即可!想换本地模型?执行 即可。


