跳转至

Ollama Cloud

Ollama Cloud 是 Ollama 的托管模型 API。ollama-cloud 提供商直接通过 Ollama 原生 /api/chat API 调用 https://ollama.com，无需本地 Ollama 服务器，也无需已登录云模式的本地 Ollama 应用。请使用类似 ollama-cloud/kimi-k2.6 的模型引用。

OpenClaw 将 ollama-cloud 注册为其自身的提供商 ID，因此仅限云端的凭据、实时目录发现和模型选择不会与本地 ollama 主机混淆。有关本地 Ollama、云端加本地混合路由、嵌入以及自定义主机详情，请参阅 Ollama。

设置

按照 Ollama 的 API 密钥说明，然后运行：

openclaw onboard --auth-choice ollama-cloud

或设置：

export OLLAMA_API_KEY="<your-ollama-cloud-api-key>" # pragma: allowlist secret

非交互式引导会直接接受密钥：

openclaw onboard --auth-choice ollama-cloud --ollama-cloud-api-key "<key>"

引导会将默认模型设置为 ollama-cloud/minimax-m2.7。

默认值

  • 提供商：ollama-cloud
  • 基础 URL：https://ollama.com
  • 环境变量：OLLAMA_API_KEY
  • API 风格：Ollama 原生 /api/chat
  • 引导默认模型：ollama-cloud/minimax-m2.7

何时选择 Ollama Cloud

  • 你希望使用托管的 Ollama 模型，而无需在本地运行 ollama serve。
  • 你希望使用 OpenClaw 为本地 Ollama 使用的相同原生 Ollama 聊天 API 形式，但指向 https://ollama.com。
  • 你希望为已经位于 Ollama 托管目录中的模型提供简单的云端路径。
  • 你不需要本地模型拉取、本地 GPU 控制或仅限局域网的推理。

如果你希望通过已登录的 Ollama 主机进行仅本地或云端加本地路由，请改用 Ollama。如果你需要 /v1/chat/completions 语义或特定于提供商的 OpenAI 风格功能，请改用 OpenAI 兼容提供商。

模型

该提供商需要 API 密钥；没有密钥时它会保持非活动状态。有了密钥后，OpenClaw 会从托管目录实时发现 Ollama Cloud 模型：

openclaw models list --provider ollama-cloud
openclaw models set ollama-cloud/kimi-k2.6

实时目录中的托管 ID 包括 deepseek-v4-flash、glm-5.2、gpt-oss:20b、kimi-k3 和 minimax-m3。发现失败会为相同凭据保留最后一次成功的清单。如果没有先前清单，OpenClaw 会提供捆绑建议并记录发现失败。成功的空响应会清除已发现的模型；后续失败会保留该空结果。已退役的 kimi-k2.5 对于现有精确引用仍标记为已弃用，但不再是当前托管模型。

模型 ID 是云目录 ID，而不是本地拉取名称。如果某个模型名称在本地 Ollama 主机上可用，但不在托管目录中，请改用 ollama 提供商和该本地主机。

实时测试

对于 Ollama Cloud API 密钥冒烟测试，请将 Ollama 实时测试指向托管端点，并从当前目录中选择一个模型：

export OLLAMA_API_KEY="<your-ollama-cloud-api-key>" # pragma: allowlist secret

OPENCLAW_LIVE_TEST=1 \
OPENCLAW_LIVE_OLLAMA=1 \
OPENCLAW_LIVE_OLLAMA_BASE_URL=https://ollama.com \
OPENCLAW_LIVE_OLLAMA_MODEL=kimi-k2.6 \
pnpm test:live -- extensions/ollama/ollama.live.test.ts

云端冒烟测试会运行文本、原生流和网页搜索；设置 OPENCLAW_LIVE_OLLAMA_WEB_SEARCH=0 可跳过网页搜索。对于 https://ollama.com，它默认跳过嵌入，因为 Ollama Cloud API 密钥可能未授权 /api/embed；使用 OPENCLAW_LIVE_OLLAMA_EMBEDDINGS=1 可强制启用。

故障排查

  • Ollama Cloud requires an API key / Set OLLAMA_API_KEY 错误：请提供真实的云端 API 密钥。本地 ollama-local 标记仅用于本地或私有 Ollama 主机。
  • 未知模型错误：运行 openclaw models list --provider ollama-cloud，并准确复制托管模型 ID。
  • 自定义 Ollama 主机上的工具调用或原始 JSON 问题：检查是否意外使用了 OpenAI 兼容的 /v1 URL。Ollama 路由应使用不带 /v1 后缀的原生基础 URL。

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