Skip to main content
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。

​
设置

Follow Ollama’s API key instructions, then run:
或者设置：
非交互式 onboarding 也可以直接接受密钥：
Onboarding sets the default model to ollama-cloud/minimax-m2.7.

​
默认值

  • Provider: ollama-cloud
  • Base URL: https://ollama.com
  • Env var: OLLAMA_API_KEY
  • API style: Ollama native /api/chat
  • Onboarding default model: ollama-cloud/minimax-m2.7

​
何时选择 Ollama Cloud

  • 你想在不本地运行 ollama serve 的情况下使用托管的 Ollama 模型。
  • 你希望使用与 OpenClaw 在本地 Ollama 上相同的原生 Ollama 聊天 API 形状，但指向 https://ollama.com。
  • 你需要一个简单的云端路径来使用已经位于 Ollama 托管目录中的模型。
  • 你不需要本地模型拉取、本地 GPU 控制或仅限局域网的推理。
当你想要通过已登录的 Ollama 主机进行仅本地或云加本地路由时，请改用 Ollama。当你需要 /v1/chat/completions 语义或提供方特定的 OpenAI 风格功能时，请改用 OpenAI 兼容的提供方。

​
模型

该提供程序需要 API 密钥；没有密钥时它将保持非活跃状态。使用密钥后， OpenClaw 会从托管目录中实时发现 Ollama Cloud 模型：
Hosted ids in the live catalog include deepseek-v4-flash, glm-5.2, gpt-oss:20b, kimi-k2.6, and minimax-m2.7. When live discovery returns nothing, OpenClaw falls back to the bundled rows minimax-m2.7, glm-5.1, and glm-5.2. The retiring kimi-k2.5 model is hidden from model pickers but remains selectable by exact reference until Ollama retires it on July 31, 2026. 模型 id 是云目录 id，而不是本地拉取名称。如果某个模型名称在 本地 Ollama 主机上可用，但在托管目录中不存在，请改用 ollama 提供程序并指定该本地主机。

​
实时测试

对于 Ollama Cloud API 密钥冒烟测试，请将 Ollama 实时测试指向托管 端点，并从你当前目录中选择一个模型：
云端冒烟测试会运行文本、原生流式和网页搜索；设置 OPENCLAW_LIVE_OLLAMA_WEB_SEARCH=0 可跳过网页搜索。默认情况下， 对于 https://ollama.com 它会跳过嵌入，因为 Ollama Cloud API 密钥可能 不会授权 /api/embed；可通过 OPENCLAW_LIVE_OLLAMA_EMBEDDINGS=1 强制启用。

​
故障排查

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

​
相关内容