OpenClaw 配置本地 Ollama 模型指南：打造离线个人 AI 助理
OpenClaw 是一个强大的本地 AI 代理框架，能够帮你清理收件箱、管理日历、处理文件并执行复杂任务。配合 Ollama 运行本地模型（如 Qwen、Llama 等），即可实现零费用、零网络依赖且全隐私保护的智能体体验。虽然官方提供了一键启动方式，但为了深度自定义本地模型、解决上下文窗口限制及安装特定技能，手动配置往往更为灵活。
环境准备
硬件建议
- GPU: NVIDIA RTX 4060 及以上（8GB+ 显存），Apple Silicon M2/M3/M4 亦佳。
- 内存: 16GB 起步，32GB 更流畅。
- 磁盘: 预留 20GB+ 空间。
- CPU: 至少 8 核。
软件要求
- Ollama: 0.17 或更高版本。
- Node.js: 18+ 版本（用于 npm 安装）。
- 系统: Windows 建议使用 PowerShell 管理员模式，macOS/Linux 使用终端。
检查环境命令：
node --version
npm --version
ollama --version
安装 Ollama 与模型
首先安装 Ollama 服务。Windows 用户可直接下载安装器，macOS/Linux 执行以下脚本：
curl -fsSL https://ollama.com/install.sh | sh
拉取推荐模型（建议先用 7B-14B 量化版测试）：
ollama pull qwen2.5:7b
ollama pull glm-4.7-flash
ollama pull llama3.3:8b
若需扩展上下文窗口（OpenClaw 通常需 ≥16k tokens），可通过 Modelfile 创建大上下文模型：
# Windows (PowerShell)
@" FROM qwen2.5:7b PARAMETER num_ctx 32768 "@ | Out-File -Encoding ascii Modelfile
ollama create qwen2.5:7b-32k -f Modelfile
验证模型列表：
ollama list
安装 OpenClaw
推荐使用官方一键法：
ollama launch openclaw
该命令会自动检查环境、安装 OpenClaw 并启动 TUI 界面。如需指定模型，可添加参数：
ollama launch openclaw --model qwen2.5:7b-32k
手动安装方式：
npm install -g openclaw@latest
openclaw --version
连接本地模型配置
这是最关键的一步。OpenClaw 基于 OpenAI 兼容协议设计，即使使用本地 Ollama，也需配置正确的鉴权信息。
配置向导（推荐）
运行以下命令进入配置流程：
openclaw onboard
按提示选择：
- Model/auth provider: Custom Provider
