游乐游手机版
首页/AI热点日报/热点详情

OpenClaw连接Ollama本地模型操作步骤

类型:热点整理2026-07-30
OpenClaw连接Ollama本地模型可实现离线隐私调用。需先确保Ollama服务运行并监听正确端口,不能启用TLS或基础认证;再在OpenClaw中配置CustomLLM,填写模型名、BaseURL(容器内用host docker internal),APIKey留空;最后测试连接并加载模型即可使用。

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

OpenClaw怎么连接Ollama本地模型?

具体操作分为三步:首先确认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 的模型推理流程,可以正常使用。

来源:https://www.php.cn/faq/2896358.html?uid=1431639

相关热点

继续查看同栏目近期热点。

延伸阅读

补充最近整理过的热点入口。