OpenClaw本地Ollama模型怎么连_OpenClaw零成本本地大模型接入【技巧】

一、验证Ollama服务状态与模型可用性

成功连接OpenClaw与本地Ollama模型的前提，是确保底层服务与模型能力就绪。核心验证点有两个：Ollama服务进程必须在指定端口活跃监听，且目标模型需明确支持工具调用功能。任何一项不满足，都将导致后续自动发现流程失败。

按以下步骤进行诊断与准备。

首先，在管理员权限的PowerShell或终端中，执行服务状态探测命令：curl http://localhost:11434/api/tags。此指令用于向Ollama默认的11434端口发起请求，确认服务是否响应。

若服务正常，将返回JSON格式的本地模型列表。关键点在于：检查你计划使用的模型条目中，“details.tools”字段值必须为“true”。这标识该模型具备工具调用能力，与OpenClaw兼容。若返回“Connection refused”等错误，表明Ollama服务未启动，需首先运行ollama serve启动后台服务。

关于模型选择，若不确定哪些模型支持工具调用，可访问Ollama官方模型库。在模型筛选区直接勾选“Tools”标签，列表将仅展示具备此功能的型号，例如当前主流的qwen3:8b。确定型号后，使用ollama pull qwen3:8b将其下载至本地。

二、配置OLLAMA_API_KEY环境变量

服务与模型就绪后，需为OpenClaw配置访问凭证，即OLLAMA_API_KEY环境变量。此密钥用于身份识别，允许OpenClaw连接本地Ollama实例。其值可为任意非空字符串，但切忌留空——空值将导致自动发现机制完全忽略Ollama提供商。

在Windows系统配置此变量的标准流程如下：

1. 按下Win + R，运行“sysdm.cpl”，打开系统属性面板。
2. 切换至“高级”选项卡，点击底部“环境变量”按钮。
3. 于“系统变量”区域点击“新建”。
4. 变量名填写OLLAMA_API_KEY，变量值可设定为任意非空字符串，例如ollama-local。
5. 逐级点击“确定”保存设置。

配置完成后，务必重启所有已打开的终端窗口（如PowerShell、CMD），以使新环境变量生效。在新终端中执行echo $env:OLLAMA_API_KEY，若正确返回设定的“ollama-local”，即表明密钥配置成功。

三、禁用显式Ollama配置以启用自动发现

完成基础设置后若本地模型仍未出现，很可能因历史配置冲突导致。具体而言，若你曾手动完整配置过Ollama的连接参数，这些显式设置会覆盖并禁用OpenClaw的自动发现功能。

OpenClaw的设计逻辑是：用户未明确指定时，启用自动发现；一旦提供了完整配置，则优先采用手动参数。因此，需将配置重置为最小化状态，仅保留apiKey，以重新激活自动发现。

按此流程操作：

1. 首先检查当前完整配置：openclaw config get models.providers.ollama。
2. 分析输出。若其中除apiKey外，还包含baseUrl、models或maxTokens等字段，即为问题根源。
3. 执行重置命令：openclaw config set models.providers.ollama.apiKey "ollama-local"。此操作将清除其他字段，仅设置apiKey。
4. 再次运行第一步的查看命令验证。理想输出应仅为：apiKey: "ollama-local"。至此，自动发现功能已恢复。

四、运行OpenClaw初始化向导并选择Ollama模型

所有前置条件满足后，可通过OpenClaw初始化向导完成最终连接。

1. 在终端中执行：openclaw onboard --install-daemon，启动配置向导。
2. 跟随指引操作至“Model/auth provider”选择步骤。
3. 若列表中未立即出现“Ollama”选项，可能系插件加载时序所致。可先选择Skip for now暂跳。
4. 进入下一界面后，通常可返回上一步。再次进入提供商选择页，“Ollama”选项通常已加载完成。
5. 选择“Ollama”进入配置页。在“Base URL”栏填写本地地址与端口，如http://127.0.0.1:11434。模式建议选择Cloud+Local。
6. 确认后，系统将自动探测服务并拉取模型列表。从列表中选择已下载且支持tools的模型（如qwen3:8b），回车即完成绑定。

若多次尝试后向导仍不显示Ollama，可尝试彻底卸载并重装OpenClaw，以清除可能的插件缓存问题。

五、通过ollama launch openclaw命令直连

当图形化向导遇到障碍时，可直接从Ollama侧发起连接，此方法更为直接，常能解决复杂配置问题。

该命令通过Ollama客户端直接注册并触发与OpenClaw的绑定流程。

1. 确保Ollama服务正在运行，且所需工具调用模型已下载至本地。
2. 在终端中直接执行：ollama launch openclaw。
3. 命令将列出所有本地可用模型。使用方向键选中你准备好的支持tools的模型（例如qwen2.5-coder:32b）。
4. 回车确认。成功后将显示一个Web UI访问地址，格式如http://127.0.0.1:18789。
5. 将此地址复制到浏览器打开，即可通过OpenClaw网页界面直接调用本地大模型。

此方法绕过了部分中间配置层，连接成功率高，是图形向导失效时的有效备用方案。

来源：互联网