本地模型 · 接入

OpenClaw 接 Ollama 能聊天，却不调用工具：从哪一层查起

钳叔 · 龙虾AI 编辑部 · 2026-09-12 发布 · 2026-09-12 更新 · 约 6 分钟

Ollama 能回答一句话，只能说明那次聊天有回复；龙虾能不能动手，还得看有没有真正发出工具调用、收到结果，再据此回答。遇到光说不做，先核对 Ollama 原生接口和 Gateway 的连接位置，再查模型与工具，别急着换显卡。

钳叔建议按下面六步走，每改一处就用同一个小任务复查。本文按2026年9月12日的官方文档整理；目录测试是建议的验收方案，本站未做这套接法的实机测试。旧版命令或选项不同的，先核对自己安装版本的帮助，不把本文当成旧版本兼容承诺。

它说「我去查看」，算动手了吗？

不算。先在当前会话记录或日志里找工具名称、调用参数和返回内容；只有一段像工具指令的文字，也不能算调用成功。

这张表是排查入口，不是凭现象判死因。官方明确提醒，Ollama 的 OpenAI 兼容路径可能破坏工具调用，出现原始工具 JSON 文本。碰到这种输出，先查接法，依据见原生接口说明。其他工具也失败时，可接着看工具调用排查清单。

基址停在端口，别加 /v1

OpenClaw 的 Ollama 原生接法使用 /api/chat。配置里的 baseUrl 只写到主机和端口，例如 http://127.0.0.1:11434；不要在基址后拼 /v1，也不用手填 /api/chat。见官方基址警告。

新接入可以运行 openclaw onboard，选择 Ollama，再选 Local only，按提示填实际基址。已有配置先留副本、确认当前主模型，别把引导当成无副作用的连通测试。入口见官方设置步骤。

手动配置的读者，重点核对 models.providers.ollama 中的两个字段：baseUrl 指向实际 Ollama 服务，api 为 ollama。这里只给检查位置，不给整份配置覆盖模板；保留你已有的其他 provider 和 agent 设置。见官方配置示例。

命令要在 Gateway 那边跑

在 Gateway 所在的同一台机器、同一运行环境检查下面两项。示例假设 Ollama 就在这个环境的本机地址；分开部署时，换成配置中实际可达的地址。

openclaw gateway status --deep
curl http://127.0.0.1:11434/api/tags

Gateway 在容器里，就进入对应容器环境查；在 VPS 上，就去 VPS 查。笔记本里 curl 成功，不能证明 VPS 连得上；容器里的 localhost 也不是宿主机。模型要装在基址指向的 Ollama 服务那台主机上。见官方连接排错。

拿不到模型目录时，先记下是连接失败、超时还是鉴权响应，处理这一层。拿到目录后，再核对里面有没有目标模型。不要为了让这条命令通过，把 11434 端口直接开放到公网。

看得见模型，不等于选对了模型

接着运行 openclaw models list --provider ollama，确认 OpenClaw 这一侧能列出候选；这是官方提供的验证命令。然后检查当前 agent 选的模型，是否确实指向你刚核对的 Ollama 模型。

建议对照目标服务上的 ollama list，逐字核对完整名称，别省略标签。手填了非空 models 列表时，会跳过自动发现；不能笼统写成只要定义 provider 就关闭发现，models: [] 的自托管入口仍可能发现模型。官方通过 /api/tags 读取目录、通过 /api/show 读取能力，见模型发现说明。

短文本探测通过，也没有证明工具、记忆和会话都正常。到这里先别下载更大的模型，下一步让当前模型做一件能核对结果的小事。

用一个空白目录验收工具链

建议你先手动建一个专用空白测试目录，只向当前 agent 提供列目录所需的只读工具和这个目录的访问范围。不要挂私人文件夹。容器场景填工具实际看得见的绝对路径，不照抄宿主路径。

请调用可用的只读工具，列出【测试目录绝对路径】下的文件名。不读文件内容，不创建或修改文件；如果工具不可用，请直接说明，不要猜目录内容。

发送前把占位符换掉。工具尚未注册或没有列目录能力，先停在这里补配置，别用一串催促代替检查。要把执行范围收小，可参考沙箱与权限边界。

验收时看三段证据：发出真实工具事件，工具结果回到会话，模型根据结果给最终回答。空目录应得到与空目录相符的返回；但只看到模型说「没有文件」仍不够，它也可能猜中。若已有权限错误，说明已经走到调用这一层，接下来查授权范围和路径，不要反复修改模型基址。

上下文和权限，分开处理

空目录任务能过，长会话才出问题，建议开新会话重复同一测试，再逐项加回历史和工具。若短任务也没有工具事件，回头核对工具是否可用、模型选择和接口，不要先扩大窗口。

Ollama 对 OpenClaw 本地使用建议至少 64K 上下文，这是推荐值，不是所有任务的硬门槛。更大的上下文会增加内存需求，别照抄大窗口后又把内存不足当成工具坏了。依据分别见集成建议和上下文长度说明；已有内存报错时，再看内存与显存排错。

若错误明确指向策略拒绝，就检查这次只读动作需要的授权，不要全开权限。还要分清部署模式：Ollama 有 Cloud + Local、Cloud only、Local only，名字里有 Ollama 不代表全本地，见模式说明；拿不准任务交给哪里，回看云端与本地的接入取舍。这一轮修复是否成功，仍以工具事件、结果回传和最终回答为准。

排到这里，还可能卡在哪

Ollama 能聊天，为什么还不能证明工具可用？

聊天回复和工具执行是不同环节。要看到真实工具事件、结果回到会话，以及模型依据结果完成回答。短文本探测通过或模型说要动手，都不足以证明工具链正常。

baseUrl 后面到底填不填 /api/chat？

不填。使用 Ollama 原生接法时，baseUrl 只到主机和端口，由原生接入使用 /api/chat；也不要把 /v1 拼进基址。地址必须从 Gateway 所在环境可达。

目录测试提示权限不足，要把权限全部打开吗？

不要。先核对测试目录在执行环境中的真实路径、工具可见范围和只读授权。已有工具错误说明请求走到了调用这一层，应处理具体拒绝原因，而不是扩大到所有目录和工具。

用了 Ollama，就可以认为任务完全离线吗？

不能。Ollama 接入有云端与本地的不同模式，还要核对实际选择的模型和工具。想走本地推理可从 Local only 设置，但工具是否联网仍需单独检查。