OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

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.com/settings/keys 建立 Ollama Cloud API 金鑰，然後執行：

bash
openclaw onboard --auth-choice ollama-cloud

或者設定：

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

非互動式初始設定可直接接受金鑰：

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

初始設定會將預設模型設為 ollama-cloud/kimi-k2.5:cloud。

預設值

  • 提供者：ollama-cloud
  • 基底 URL：https://ollama.com
  • 環境變數：OLLAMA_API_KEY
  • API 樣式：Ollama 原生 /api/chat
  • 初始設定的預設模型：ollama-cloud/kimi-k2.5:cloud

何時選擇 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 模型：

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

即時目錄中的託管 ID 包括 deepseek-v4-flash、glm-5、gpt-oss:20b、kimi-k2.6 和 minimax-m2.7。當即時探索未傳回任何內容時，OpenClaw 會回退至內建項目 kimi-k2.5:cloud、minimax-m2.7:cloud、glm-5.1:cloud 和 glm-5.2:cloud。

模型 ID 是雲端目錄 ID，而不是本機下載名稱。若某個模型名稱可在本機 Ollama 主機上使用，但不在託管目錄中，請改用 ollama 提供者搭配該本機主機。

即時測試

若要對 Ollama Cloud API 金鑰進行冒煙測試，請將 Ollama 即時測試指向託管端點，並從您目前的目錄選擇模型：

bash
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。

相關內容

Was this useful?
On this page

On this page