跳转至

Ollama

OpenClaw 调用 Ollama 的原生 API(/api/chat),而不是 OpenAI 兼容的 /v1 端点。支持三种配置:

配置方案 使用内容
云 + 本地 可访问的 Ollama 主机,提供本地模型,并在已登录时提供 :cloud 模型
仅本地 可访问的 Ollama 主机,仅提供本地模型
Ollama Cloud 通过 ollama-cloud 提供商直接访问 https://ollama.com,无需守护进程

仅托管访问是独立的 Ollama Cloud 配置选项;参见 Ollama Cloud。其 ollama-cloud/<model> 引用将 云端路由与本地 ollama 提供商保持分离。

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 配置 你正在编写提供商条目:隐式发现、显式模型列表或自定义基础 URL。
Ollama 配置示例 你想要一个可复制的可用配置:按场景的配置示例、模型选择和快速验证。
Ollama Web Search 你正在将 Ollama 用作 web_search 提供商:主机、认证和规则要求。
Ollama 高级配置 你正在调整行为:上下文窗口、思考控制、推理、成本、嵌入和流式传输。
Ollama 故障排查 某些功能出现故障:检测、连接、工具 JSON、乱码输出、超时和 WSL2 崩溃循环。

各章节迁移位置

单页版本发布的所有锚点在此处仍然可以解析,因此诸如 /providers/ollama#node-local-inference 之类的现有链接仍可正常工作。 每个条目指向当前承载该内容的页面。

Ollama 设置

Ollama 模型发现

Ollama 节点本地推理

Ollama 视觉与图像描述

Ollama 配置

Ollama 配置示例

Ollama 网络搜索

Ollama 高级配置

Ollama 故障排除

Ollama Cloud

使用专用 ollama-cloud 提供程序的仅云端设置。

模型提供程序

所有提供程序、模型引用和故障转移行为的概述。

模型选择

如何选择和配置模型。

Ollama 网络搜索

由 Ollama 驱动的网络搜索的完整设置和行为详情。

LM Studio

另一个用于 GGUF 或 MLX 模型的本地运行器,可作为 GUI 应用或无头服务器。

Memory LanceDB

LanceDB 中的长期记忆,使用本地 Ollama 兼容嵌入。

配置

完整配置参考。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw