OpenClaw con Ollama

Ollama è la strada più semplice della documentazione verso un modello locale, e la pagina che lo riguarda si apre con un avvertimento anziché con un benvenuto: OpenClaw parla con l’API nativa di Ollama, e puntarlo all’URL compatibile con OpenAI rompe le chiamate agli strumenti. Sono supportate tre modalità: cloud più locale tramite un host su cui hai effettuato l’accesso, solo cloud verso il servizio di Ollama stesso, e solo locale. Ecco cosa rileva l’onboarding e cosa si rifiuta di dare per scontato, le regole di autenticazione per tipo di host, l’elenco della risoluzione dei problemi e la regola sui modelli piccoli che non sparisce solo perché il modello è gratuito.

Non usare l’URL /v1 compatibile con OpenAI (http://host:11434/v1). Rompe le chiamate agli strumenti e i modelli possono emettere il JSON grezzo delle chiamate agli strumenti come testo normale.

Configurazione

• Onboarding: seleziona Ollama e scegli una modalità. In una nuova configurazione guidata OpenClaw controlla l’host predefinito o configurato, e il rilevamento automatico considera solo i modelli già caricati in memoria, con supporto agli strumenti e almeno 16K di contesto confermati; un modello installato ma inattivo non è un candidato, la route richiede un completamento reale prima di essere salvata, e il rilevamento non scarica né carica mai nulla.
• La modalità solo cloud chiede la chiave API e suggerisce modelli ospitati come predefiniti; le modalità cloud più locale e solo locale chiedono un URL di base e ispezionano i modelli installati, e se non trova nessun modello in grado di usare gli strumenti, la configurazione può chiedere il permesso di scaricarne uno consigliato. Un modello dichiarato solo per embedding non può diventare il modello predefinito per la chat.
• Manuale: installa Ollama, scarica un modello, effettua il login sullo stesso host per l’accesso cloud ibrido, imposta una credenziale (un valore qualsiasi per un host locale o in LAN, la chiave vera per il servizio di Ollama), poi imposta il riferimento del modello come ollama, barra, il nome del modello.

Regole di autenticazione

Gli host loopback, di rete privata, .local e con nome host semplice non richiedono un vero bearer token; per loro OpenClaw usa un marcatore locale. Gli host remoti pubblici e il servizio di Ollama richiedono una credenziale reale, e per l’uso ospitato diretto la documentazione preferisce l’ID provider cloud dedicato, così l’instradamento cloud resta separato da un provider locale. Una semplice chiave nella variabile d’ambiente viene trattata come la convenzione cloud e per impostazione predefinita non viene inviata agli host locali, e l’autenticazione bearer per gli embedding della memoria è limitata all’host per cui è stata dichiarata.

Risoluzione dei problemi

• Crash loop su WSL2: l’installer ufficiale per Linux crea un servizio con restart always; su una configurazione CUDA può caricare un modello all’avvio, bloccare la memoria dell’host, far terminare la VM da Windows e riavviarsi all’infinito. Disattiva il servizio, disattiva il recupero automatico della memoria nella configurazione di WSL, oppure avvia Ollama a mano con un keep-alive breve.
• Non rilevato: verifica che sia in esecuzione e che rientri nell’ambito dei modelli dell’agente; il rilevamento implicito su localhost richiede la variabile della chiave o un profilo di autenticazione, e un elenco manuale di modelli non vuoto salta del tutto il rilevamento.
• Nessun modello: scaricane uno o definiscilo esplicitamente. Connessione rifiutata: controlla il processo e riavvia. JSON degli strumenti stampato come testo: l’URL compatibile con OpenAI, l’errore di inizio pagina.

La guida ai modelli gratuiti per OpenClaw mette Ollama accanto a LM Studio, llama.cpp e agli altri backend, e la guida all’installazione di OpenClaw su Windows è il punto da cui parte la configurazione di WSL2.

La regola che vale ancora

La FAQ sui modelli lo dice nello stesso respiro del quick start di Ollama: i modelli più piccoli e fortemente quantizzati sono più vulnerabili alla prompt injection, usa modelli grandi per qualsiasi bot con accesso agli strumenti e, se usi comunque quelli piccoli, attiva il sandboxing ed elenchi rigorosi degli strumenti autorizzati. L’articolo su OpenClaw e la prompt injection spiega l’attacco e l’articolo sul sandboxing di OpenClaw il contenimento.

Su Diali

Su Diali non c’è nessun Ollama da installare: i modelli sono nel catalogo gestito e si pagano con i crediti inclusi. OpenClaw ospitato su Diali è l’assistente, e la pagina su modelli e provider di OpenClaw elenca cosa copre il catalogo.

• API nativa, mai l’URL compatibile con OpenAI.
• Il rilevamento vede solo i modelli caricati; la configurazione non scarica nulla senza chiedere.
• Gli host locali richiedono un marcatore, quelli remoti una chiave, i modelli piccoli una sandbox.