OpenClaw com Ollama

O Ollama é o caminho mais fácil da documentação para um modelo local, e a página sobre ele abre com um aviso em vez de boas-vindas: o OpenClaw conversa com a API nativa do Ollama, e apontá-lo para a URL compatível com OpenAI quebra as chamadas de ferramentas. Três modos são suportados: nuvem mais local, por meio de um host com login feito; somente nuvem, contra o serviço do próprio Ollama; e somente local. Veja o que o onboarding descobre e o que ele se recusa a presumir, as regras de autenticação por tipo de host, a lista de solução de problemas e a regra sobre modelos pequenos que não desaparece só porque o modelo é gratuito.

Não use a URL /v1 compatível com OpenAI (http://host:11434/v1). Ela quebra as chamadas de ferramentas, e os modelos podem emitir o JSON bruto das chamadas de ferramentas como texto simples.

Configuração

• Onboarding: selecione Ollama e escolha um modo. Em uma configuração guiada do zero, o OpenClaw verifica o host padrão ou o configurado, e a descoberta automática considera apenas modelos já carregados na memória, com suporte a ferramentas e pelo menos 16K de contexto confirmados; um modelo instalado, mas ocioso, não é candidato, a rota precisa de uma completion real antes de ser salva, e a descoberta nunca baixa nem carrega nada.
• Somente nuvem pede a chave de API e sugere padrões hospedados; nuvem mais local e somente local pedem uma URL base e inspecionam os modelos instalados, e, se nenhum modelo com suporte a ferramentas for encontrado, a configuração pode pedir permissão para baixar um recomendado. Um modelo anunciado como apenas de embeddings não pode se tornar o padrão do chat.
• Manual: instale o Ollama, baixe um modelo, faça login no mesmo host para ter acesso híbrido à nuvem, defina uma credencial (qualquer valor para um host local ou da LAN e a chave real para o serviço do Ollama) e, depois, defina a referência do modelo como ollama, barra, o nome do modelo.

Regras de autenticação

Hosts de loopback, de rede privada, .local e de hostname simples não precisam de um bearer token real; o OpenClaw usa um marcador local para eles. Hosts remotos públicos e o serviço do Ollama precisam de uma credencial real, e a documentação prefere o ID de provedor de nuvem dedicado para uso hospedado direto, para que o roteamento de nuvem fique separado de um provedor local. Uma chave de ambiente simples é tratada como a convenção de nuvem e não é enviada a hosts locais por padrão, e a autenticação bearer para embeddings de memória fica restrita ao host para o qual foi declarada.

Solução de problemas

• Loop de travamentos no WSL2: o instalador oficial para Linux cria um serviço com restart always; em uma configuração com CUDA, ele pode carregar um modelo durante o boot, fixar a memória do host, fazer com que o Windows encerre a VM e reiniciar para sempre. Desative o serviço, desligue a recuperação automática de memória na configuração do WSL ou rode o Ollama manualmente com um keep-alive curto.
• Não detectado: confirme que ele está rodando e dentro do escopo de modelos do agente; a descoberta ambiente em localhost precisa da variável da chave ou de um perfil de autenticação, e uma lista manual de modelos não vazia pula a descoberta por completo.
• Nenhum modelo: baixe um ou defina-o explicitamente. Conexão recusada: verifique o processo e reinicie. JSON de ferramentas impresso como texto: a URL compatível com OpenAI, o erro do topo da página.

O guia de modelos gratuitos para o OpenClaw coloca o Ollama ao lado do LM Studio, do llama.cpp e dos outros backends, e a configuração do WSL2 começa no guia de instalação do OpenClaw no Windows.

A regra que continua valendo

A FAQ de modelos diz isso no mesmo fôlego que o início rápido do Ollama: modelos menores e muito quantizados são mais vulneráveis à injeção de prompt; use modelos grandes para qualquer bot com acesso a ferramentas e, se usar modelos pequenos mesmo assim, ative a sandbox e listas de permissões de ferramentas rígidas. O guia sobre injeção de prompt no OpenClaw explica o ataque, e o guia de sandbox do OpenClaw, a contenção.

Na Diali

Na Diali, não há Ollama para instalar: os modelos estão no catálogo gerenciado e são pagos com os créditos incluídos. O OpenClaw hospedado na Diali é o assistente, e a página de modelos e provedores do OpenClaw lista o que o catálogo cobre.

• API nativa, nunca a URL compatível com OpenAI.
• A descoberta só vê modelos carregados; a configuração não baixa nada sem perguntar.
• Hosts locais precisam de um marcador; hosts remotos, de uma chave; modelos pequenos, de uma sandbox.