Ollama

OpenClaw 调用 Ollama 的原生 API（/api/chat），而不是 OpenAI 兼容的 /v1 端点。支持三种模式：

模式	它使用什么
云 + 本地	一个可访问的 Ollama 主机，提供本地模型以及（如果已登录）`:cloud` 模型
仅云	直接连接 `https://ollama.com`，不使用本地守护进程
仅本地	一个可访问的 Ollama 主机，仅提供本地模型

对于使用专用 ollama-cloud provider id 的仅云配置，请参阅 Ollama Cloud。当你希望将云路由与本地 ollama provider 分开时，请使用 ollama-cloud/<model> 引用。

Warning

不要使用 /v1 OpenAI 兼容 URL（http://host:11434/v1）。它会破坏工具调用，并且模型可能将原始工具调用 JSON 作为纯文本输出。请使用原生 URL：baseUrl: "http://host:11434"（不带 /v1）。

标准配置键是 baseUrl。baseURL 也被接受用于 OpenAI-SDK 风格示例，但新配置应使用 baseUrl。

本页是索引。Ollama 的文档分布在九个页面中，每个页面对应一种读者任务。请打开与你的任务匹配的页面。

页面	何时阅读
Ollama 设置	你正在连接一个账户：按主机类型划分的身份验证规则、引导设置和手动设置，以及云加本地混合流程。
Ollama 模型发现	你想知道模型是如何被发现的：隐式发现表、能力检测和冒烟测试探针。
Ollama 节点本地推理	你正在配对的节点上运行模型：设置步骤、模型过滤和直接验证命令。
Ollama 视觉与图像描述	你正在通过本地或托管的 Ollama 视觉模型描述或理解图像。
Ollama 配置	你正在编写 provider 条目：隐式发现、显式模型列表或自定义 base URL。
Ollama 配置配方	你想要一个可复制的可用配置：按场景划分的配方、模型选择和快速验证。
Ollama Web 搜索	你正在将 Ollama 用作 `web_search` provider：主机、身份验证和要求规则。
Ollama 高级配置	你正在调整行为：上下文窗口、思考控制、推理、成本、嵌入和流式传输。
Ollama 故障排除	某些功能出现故障：检测、连接、工具 JSON、乱码输出、超时和 WSL2 崩溃循环。