Skip to main content
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:
Ou defina:
A integração não interativa aceita a chave diretamente:
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:
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:
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