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 Cloud 主机
- 自定义提供商 ID
- 认证配置
- 内存嵌入范围
- 引导设置(推荐)
- 运行引导设置
- 选择模型
- 验证
- 手动设置
- 安装并启动 Ollama
- 设置凭据
- 选择该模型
- 故障排除
- WSL2 崩溃循环(反复重启)
- 未检测到 Ollama
- 没有可用模型
- 连接被拒绝
- 远程主机可通过 curl 访问,但 OpenClaw 无法访问
- 模型将工具 JSON 输出为文本
- Kimi 或 GLM 返回乱码符号
- 冷启动本地模型超时
- 大上下文模型过慢或内存不足
相关¶
使用专用 ollama-cloud 提供程序的仅云端设置。
所有提供程序、模型引用和故障转移行为的概述。
如何选择和配置模型。
由 Ollama 驱动的网络搜索的完整设置和行为详情。
另一个用于 GGUF 或 MLX 模型的本地运行器,可作为 GUI 应用或无头服务器。
LanceDB 中的长期记忆,使用本地 Ollama 兼容嵌入。
完整配置参考。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw