OpenClaw想要连接Ollama本地模型,本质上是在完全离线、隐私可控的环境下,直接调用本地部署的大语言模型,例如DeepSeek、Qwen、Phi3等。这样数据不会离开本地,响应速度也更稳定可控。但前提是Ollama服务必须已启动并监听正确端口,同时OpenClaw侧的配置需要精准指向该地址,否则会出现“model not found”或连接超时等问题。

具体操作分为三步:首先确认Ollama服务是否运行、端口是否正确;然后在OpenClaw中填写准确的配置;最后验证连接并加载模型。
确认Ollama服务正在运行并暴露正确端口
打开终端,先执行 ollama serve 启动服务。如果服务已在后台运行,可以使用 ollama ps 检查是否至少有一个模型处于 active 状态。
默认情况下,Ollama 监听在 http://127.0.0.1:11434。如果需要更改端口(例如与其他服务冲突),必须显式指定:OLLAMA_HOST=127.0.0.1:11435 ollama serve,后续所有配置都要同步更新该地址,确保完全一致。
关键前提:Ollama 必须通过 HTTP 提供 API,不能启用 TLS 或基础认证——OpenClaw 当前版本尚不支持带证书或 Bearer Token 的 Ollama 服务,这个前置条件必须满足。
在OpenClaw中配置Ollama模型后端
启动 OpenClaw Web UI(通常访问 http://localhost:3000),点击右上角的齿轮图标进入 Settings → Model Configuration。
选择 “Custom LLM” 类型,然后填写以下三项:
- Model Name:填写你在 Ollama 中实际拉取或创建的模型名称,例如
qwen2:7b或deepseek-r1:14b。注意名称必须与ollama list输出的完全一致,包括冒号和标签,一个字符都不能错。 - Base URL:填写
http://host.docker.internal:11434(容器内访问宿主机 Ollama),或http://127.0.0.1:11434(本地直接运行 OpenClaw 时)。这里有一个常见误区:Windows 和 macOS 上使用 Docker Desktop 的用户必须使用host.docker.internal,如果直接写127.0.0.1会导致容器内网络不通,始终无法连接。 - API Key:留空即可——Ollama 本地 API 不需要密钥。
验证连接并加载模型
第一步:点击 “Test Connection” 按钮。如果连接成功,会返回类似 {"models":[{"name":"qwen2:7b","modified_at":"2026-07-25T14:22:11.789Z"}]} 的 JSON 数据,表明基础连通性已建立。
第二步:点击 “Load Model”,等待状态栏显示 “Model loaded successfully”。此时 Ollama 会将模型加载到内存中,首次加载可能需要 10 到 60 秒,具体时间取决于模型大小和硬件性能。
第三步:切换到 Chat 界面,输入任意提示词(例如“你好”),并发送。如果能收到合理的回复,而不是报错信息(如 “context length exceeded” 或 “connection refused”),则说明 OpenClaw 已成功接管 Ollama 的模型推理流程,可以正常使用。
