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 é a API de modelos hospedada da Ollama. O provedor ollama-cloud a acessa diretamente em https://ollama.com pela API nativa /api/chat da Ollama, sem servidor Ollama local e sem aplicativo Ollama local conectado ao modo de nuvem. Use referências de modelo como ollama-cloud/kimi-k2.6.

O OpenClaw registra ollama-cloud com seu próprio identificador de provedor para que credenciais exclusivas da nuvem, descoberta dinâmica do catálogo e seleção de modelos não sejam misturadas com um host ollama local. Para Ollama local, roteamento híbrido entre nuvem e ambiente local, embeddings e detalhes de hosts personalizados, consulte Ollama.

Configuração

Crie uma chave de API do Ollama Cloud em ollama.com/settings/keys e execute:

bash
openclaw onboard --auth-choice ollama-cloud

Ou defina:

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

A integração não interativa aceita a chave diretamente:

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

A integração define o modelo padrão como ollama-cloud/kimi-k2.5:cloud.

Padrões

  • Provedor: ollama-cloud
  • URL base: https://ollama.com
  • Variável de ambiente: OLLAMA_API_KEY
  • Estilo da API: /api/chat nativa da Ollama
  • Modelo padrão da integração: ollama-cloud/kimi-k2.5:cloud

Quando escolher o Ollama Cloud

  • Você quer modelos Ollama hospedados sem executar ollama serve localmente.
  • Você quer o mesmo formato da API nativa de chat da Ollama que o OpenClaw usa para a Ollama local, mas direcionado a https://ollama.com.
  • Você quer um caminho simples pela nuvem para modelos que já estão no catálogo hospedado da Ollama.
  • Você não precisa baixar modelos localmente, controlar GPUs locais nem realizar inferência exclusiva pela LAN.

Use Ollama quando quiser roteamento somente local ou entre nuvem e ambiente local por meio de um host Ollama conectado. Use um provedor compatível com OpenAI quando precisar da semântica de /v1/chat/completions ou de recursos específicos do provedor no estilo OpenAI.

Modelos

O provedor exige uma chave de API; sem ela, permanece inativo. Com uma chave, o OpenClaw descobre dinamicamente os modelos do Ollama Cloud no catálogo hospedado:

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

Os identificadores hospedados no catálogo dinâmico incluem deepseek-v4-flash, glm-5, gpt-oss:20b, kimi-k2.6 e minimax-m2.7. Quando a descoberta dinâmica não retorna nada, o OpenClaw usa como alternativa as entradas incluídas kimi-k2.5:cloud, minimax-m2.7:cloud, glm-5.1:cloud e glm-5.2:cloud.

Os identificadores de modelos são os do catálogo da nuvem, não nomes de downloads locais. Se o nome de um modelo funcionar em um host Ollama local, mas não estiver presente no catálogo hospedado, use o provedor ollama com esse host local.

Teste em ambiente real

Para testes rápidos com chave de API do Ollama Cloud, direcione o teste em ambiente real da Ollama ao endpoint hospedado e escolha um modelo do seu catálogo atual:

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

O teste rápido na nuvem executa texto, fluxo nativo e pesquisa na web; defina OPENCLAW_LIVE_OLLAMA_WEB_SEARCH=0 para ignorar a pesquisa na web. Ele ignora embeddings por padrão para https://ollama.com, pois as chaves de API do Ollama Cloud podem não autorizar /api/embed; force-os com OPENCLAW_LIVE_OLLAMA_EMBEDDINGS=1.

Solução de problemas

  • Erros Ollama Cloud requires an API key / Set OLLAMA_API_KEY: forneça uma chave de API de nuvem válida. O marcador local ollama-local serve apenas para hosts Ollama locais ou privados.
  • Erros de modelo desconhecido: execute openclaw models list --provider ollama-cloud e copie exatamente o identificador do modelo hospedado.
  • Problemas com chamadas de ferramentas ou JSON bruto em hosts Ollama personalizados: verifique se você está usando acidentalmente uma URL /v1 compatível com OpenAI. As rotas da Ollama devem usar a URL base nativa sem o sufixo /v1.

Conteúdo relacionado

Was this useful?
On this page

On this page