Nuvem OpenClaw Ollama: Correção em Três Camadas para Modelos Faltantes e Bug de Deleção do Médico

O usuário /u/christof21 relata uma frustrante instalação limpa do OpenClaw no Mac Mini com apenas um modelo cloud (kimi-k2.5:cloud) funcionando, apesar de configurar três modelos. Após depuração profunda, descobriram um problema de três camadas envolvendo registro de provedores, validação de esquema e um ponto cego no comando doctor.

O Problema de Três Camadas

Os padrões de modelo integrados do OpenClaw só trazem três modelos Ollama Cloud: kimi-k2.5:cloud, minimax-m2.7:cloud e glm-5.1:cloud. Quaisquer modelos personalizados (ex.: deepseek-v4-pro:cloud, nemotron-3-ultra:cloud, minimax-m3:cloud) devem ser registrados em models.providers.ollama-cloud.models[]. O instalador não escreveu essas entradas — por isso apenas kimi-k2.5 apareceu.

Segundo, cada entrada de modelo precisa dos campos id e name para satisfazer o esquema do gateway. Adicionar apenas id (como sugere a dica em tempo de execução) falha silenciosamente. A correção: incluir ambos.

Terceiro, openclaw doctor --fix e config validate não carregam a extensão Ollama. Por não reconhecerem ollama-cloud como um provedor integrado, reclamam "must declare baseUrl" e doctor --fix deleta todo o bloco do provedor Ollama Cloud. É por isso que a correção manual sumia ao reiniciar.

A Correção

Adicione um baseUrl explícito: "https://ollama.com" (idêntico ao valor embutido, sem mudança de comportamento) na configuração do seu provedor. Isso satisfaz tanto o validador quanto o gateway.

providers:
  ollama-cloud:
    baseUrl: "https://ollama.com"
    models:
      - id: deepseek-v4-pro:cloud
        name: deepseek-v4-pro:cloud
      - id: nemotron-3-ultra:cloud
        name: nemotron-3-ultra:cloud
      - id: minimax-m3:cloud
        name: minimax-m3:cloud

Avisos

• Não execute openclaw doctor --fix — ele eliminará seu bloco novamente. Valide manualmente ou pule o doctor completamente.
• Ao adicionar mais modelos cloud depois, adicione-os tanto em agents.defaults.models quanto na lista de provedores com {id, name}.
• Mantenha a linha baseUrl — é a única defesa contra a deleção do doctor.

Por enquanto, o workaround funciona. Uma correção permanente exigiria que o comando doctor carregasse extensões antes de validar provedores — mas isso é upstream.