连接 openclaw 与本地 ollama

本地 ollama 跑通了，模型也能在命令行里对话，可一到 openclaw 这边就报连接失败或者干脆找不到模型——这是很多人第一次接智能体会卡住的地方。这篇不讲大道理，只给一条核对顺序：先确认 ollama 服务对外提供什么地址，再确认 openclaw 配置里填的模型名和 ollama 注册的名字对不对得上，最后才看协议和网络层。按这个顺序走，基本能自己定位到问题在哪一层。

本地 ollama 跑通了，命令行里能正常对话，可一接到 openclaw 这边就报连接失败，或者干脆提示找不到模型。这类问题九成不在智能体本身，而在中间那几层配置没对齐。这篇只给一条核对顺序：先看 ollama 对外提供什么地址，再看 openclaw 里填的模型名和 ollama 注册的名字能不能对上，最后才去看协议和网络。按这个顺序走，能自己判断问题卡在哪一层。

顺序别乱。很多人一报错就去翻协议文档、改超时参数，结果真正的坑是最前面那一步——服务根本没对外响应。下面每个小节都配了具体动作和判断标准，照着做就行。

第一步：先把 ollama 的服务地址弄成 openclaw 能访问的样子

ollama 默认只监听本机回环地址，也就是只有同一台机器上的程序能连。openclaw 和 ollama 跑在同一台机器上时，用默认地址通常够用；但只要 openclaw 跑在容器里、虚拟机里，或者干脆在另一台机器上，这个默认地址就访问不到了，表现就是连接被拒绝或者超时。

1. 确认 ollama 监听在哪个地址看服务启动时的监听信息，确认是只绑了回环，还是绑了对外可访问的地址。这一步不用改任何东西，先把现状看清楚。
2. 按需改绑定地址如果 openclaw 不在同一台机器上，就通过环境变量把监听地址放开，改完必须重启 ollama 服务才生效。重启是必须的，光改环境变量不重启等于没改。
3. 脱离 openclaw 单独验证一次用命令行或者浏览器直接请求 ollama 的接口，看有没有正常返回。这一步通了，才说明服务这层没问题，可以往下一层查。

第二步：模型名对不上，是最高频的失败原因

地址通了之后，最常见的下一个坑就是模型名。openclaw 配置里填的模型标识，必须和 ollama 里实际拉下来的名字完全一致，包括冒号后面那段标签。手打、凭记忆写、复制时带了多余空格，都会导致找不到模型。

• 先用 ollama 列出本地已有的模型，把名字整段复制进配置，不要手敲
• 注意冒号后面的标签部分也算模型名的一部分，少写或多写都算不匹配
• 如果 openclaw 走的是兼容协议，除了模型名，还要确认它请求的是哪个路径，路径不对往往返回的是找不到模型，而不是连接失败
• 换模型之后记得回头改配置里的名字，两个地方不同步就会出现改了模型反而连不上

第三步：配置写完之后怎么验证，以及不适用的情况

改完配置不要直接上真实任务，那样一旦出错你分不清是配置问题还是任务本身的问题。验证要一步一步来，每步都能独立确认上一层是好的。

1. 先单独请求 ollama绕开 openclaw，直接请求一次，确认服务在响应、模型能加载。
2. 让 openclaw 发一次最小请求用最短的输入测一次，只看它能不能拿到返回，不看内容好不好。
3. 留一条回退路径把配置改回原来的值，如果又能跑通，说明问题就出在这次改动上，而不是环境本身坏了。这条回退路径建议提前记下来。

长期跑下去要留意的几件事

连上只是开始。本地服务长期跑，有几件事会反复影响体验，提前知道能少走弯路。

• ollama 重启后模型会重新加载，第一次请求明显变慢，别误判成连接又坏了
• 多个客户端同时连同一个 ollama 会互相抢显存和算力，并发高的时候要提前规划，别等卡了才查
• 把最终的配置整理成一份可复制的记录，换机器或者重装时直接套用，不用重新试一遍
• 想做变更前，先确认当前这套是能跑的，出了问题好回退

如果拿不准是配置问题还是这台机器的承载能力问题，可以先用站内的速度测试工具跑一轮基线，把「机器本身慢」和「配置没接对」两件事分开看。具体到各家服务当时的可用性和表现，别凭印象，去站内页面核对当时的数字。