OpenClaw 配置本地 Ollama 模型完整指南
OpenClaw 是一个强大的开源智能体框架,配合 Ollama 运行本地模型(如 Qwen3、GLM-4.7、Llama3.3 等),可以实现真正零费用、零网络依赖且隐私保护的全功能 AI 助理。它能帮你管理日历、处理文件、集成通讯工具甚至执行复杂任务。
虽然官方提供了 ollama launch openclaw 一键启动,但为了深度自定义本地模型、解决上下文窗口限制或安装特定技能,手动配置往往更灵活。以下教程基于 2026 年最新协议整理,涵盖从环境准备到 Auth 配置的核心步骤。
一、前置要求
硬件建议
- GPU:NVIDIA RTX 4060 及以上(8GB+ 显存推荐),Apple Silicon M2/M3/M4 表现极佳。
- 内存:16GB 起步,32GB 更流畅(系统提示词 + 工具调用消耗较大)。
- 磁盘:预留 20GB+ 空间用于模型文件。
- CPU:至少 8 核(无 GPU 时的备选)。
软件环境
- Ollama:0.17 或更高版本。
- Node.js:18+ 版本(用于 npm 安装 OpenClaw)。
- 终端:Windows 建议使用 PowerShell(管理员身份),macOS/Linux 使用终端。
环境检查命令
node --version
npm --version
ollama --version
确保 Node.js >= v18,npm >= 8,Ollama >= 0.17。若未安装,请前往官网下载对应 LTS 版本。
二、安装 Ollama 并拉取模型
拉取推荐模型 建议先用 7B-14B 量化版测试效果:
# 通用推荐
ollama pull qwen2.5:7b
ollama pull glm-4.7-flash
ollama pull llama3.3:8b
扩展上下文窗口 OpenClaw 默认需要 16k+ 上下文,否则可能报错。通过 Modelfile 扩展至 32k:
# 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 create。
验证模型列表:
ollama list
ollama show qwen2.5:7b-32k --modelfile
此时 Ollama 服务应监听在 http://127.0.0.1:11434。
三、安装 OpenClaw
官方一键法
ollama launch openclaw
此命令会自动检查依赖、安装 OpenClaw、弹出模型选择器并启动 TUI。如需指定模型,可加参数:
ollama launch openclaw --model qwen2.5:7b-32k


