OpenClaw接入本地模型需通过Ollama运行器实现完全离线,关键在端口(11434)、模型名(如qwen3:8b)和服务状态(ollama serve常驻)三者匹配;配置后须经ollama ps、浏览器访问localhost:11434及Web界面指令测试三重验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

OpenClaw 接入本地模型走的是「本地大模型引擎 + 本地AI智能体」双组件离线路径,核心是让 OpenClaw 不调用任何公网API,所有推理、记忆、执行都在你自己的设备上完成。关键不在于“能不能连”,而在于“连对没连稳”——端口、模型名、服务状态这三点卡住90%的失败案例。
一、先装好本地模型运行器(Ollama)
Ollama 是本地模型的“操作系统”,必须先跑起来,OpenClaw 才能找得到它:
- 去 ollama.com/download 下载对应系统安装包(Windows/macOS/Linux 全支持),一路默认安装即可
- 安装完后打开终端(CMD/PowerShell/Terminal),输入 ollama --version,有版本号就说明装好了
- 启动服务:运行 ollama serve(后台常驻,别关这个窗口)
- 拉一个能干活的模型,推荐命令:
ollama pull qwen3:8b 或 ollama pull deepseek-coder:6.7b(编程强、吃资源少) - 验证模型是否可用:ollama run qwen3:8b,输入一句“你好”,有回复即成功
二、再配 OpenClaw 连本地模型
OpenClaw 默认会尝试连云端,必须手动切到本地模式。有两种主流方式,选一种即可:
完整的工作区安全套件:检测未授权修改,扫描提示注入模式,自动响应应对措施——快照恢复、技能隔离、Git回滚和自动保护扫描。智能体工作区的完整安装后安全层。
-
图形向导方式(新手推荐):
运行 openclaw onboard → 选择 Use local model (Ollama) → API Key 留空 → 模型名填你刚拉的那个(如 qwen3:8b)→ 完成后务必重启 OpenClaw -
手动改配置文件(更可控):
编辑 ~/.openclaw/openclaw.json(Windows 在 %USERPROFILE%\.openclaw\),确保包含以下字段:
"baseUrl": "http://localhost:11434",
"model": "qwen3:8b",
"api": "openai-completions"
三、检查连接是否真生效
光配完不等于跑通,要确认三件事都在线:
- Ollama 服务在运行:终端里 ollama ps 应显示模型状态为 running
- OpenClaw 能访问 Ollama:浏览器打开 http://localhost:11434,能显示 JSON 响应页即通
- 实际指令测试:进 OpenClaw Web 界面(http://localhost:8000),发一句 “列出当前目录下的所有 .txt 文件”,能返回真实结果才算真正对接成功
四、低配机器特别注意点
内存 ≤8GB 的电脑容易卡在加载或超时,这几个设置能救命:
- 只用 7B 或 8B 级别模型,别碰 14B/34B
- Ollama 启动前加内存限制:OLLAMA_NUM_PARALLEL=2 ollama serve
- 设模型常驻:OLLAMA_KEEP_ALIVE=24h(环境变量,避免反复加载)
- 关闭所有非必要后台程序,尤其是浏览器多标签、视频软件等内存大户

















