OpenClaw

OpenClaw è un'IA personale self-hosted che gira sulla tua macchina e ti risponde attraverso i canali che già usi (WhatsApp, Telegram, Slack, Discord, iMessage e molti altri). Supporta più provider di modelli — aggiungi Synthorai come uno di essi e qualsiasi modello chat del tuo workspace diventa raggiungibile tramite la configurazione agent di OpenClaw.

Prima di iniziare

Ti serviranno (1) un'installazione di OpenClaw in esecuzione in locale e (2) una chiave API Synthorai da Console → Chiavi API.

Passo 1 — Modifica ~/.openclaw/openclaw.json

Aggiungi Synthorai sotto providers. Le voci openai/anthropic esistenti possono restare — OpenClaw userà quella referenziata da agent.model.

{
  "providers": {
    "synthorai": {
      "type": "openai",
      "base_url": "https://synthorai.io/v1",
      "api_key": "sk-..."
    }
  },
  "agent": {
    "model": "synthorai/gpt-5.4-mini"
  }
}

ℹ

type: openai indica a OpenClaw di parlare il protocollo OpenAI Chat Completions. Synthorai è pienamente compatibile OpenAI su /v1/chat/completions, quindi funziona con qualsiasi modello chat del tuo workspace — non solo quelli ospitati da OpenAI.

Passo 2 — (Facoltativo) aggiungi anche un provider nativo Claude

Se vuoi specificamente il formato messaggi nativo di Anthropic (solo modelli della famiglia Claude), aggiungi un secondo provider che punta al protocollo Anthropic. Nota che base_url non include /v1.

{
  "providers": {
    "synthorai": {
      "type": "openai",
      "base_url": "https://synthorai.io/v1",
      "api_key": "sk-..."
    },
    "synthorai-claude": {
      "type": "anthropic",
      "base_url": "https://synthorai.io",
      "api_key": "sk-..."
    }
  },
  "agent": {
    "model": "synthorai-claude/claude-sonnet-4-6"
  }
}

Passo 3 — Riavvia OpenClaw

OpenClaw rilegge openclaw.json all'avvio. Dopo il riavvio, invia il tuo primo messaggio da qualsiasi canale a cui OpenClaw è collegato (es. Slack, Telegram) — l'agente risponderà usando il modello Synthorai configurato.

Modelli consigliati

Per un assistente conversazionale il miglior compromesso costo-qualità è di solito un modello veloce di fascia media:

Parametro	Tipo	Descrizione
`gpt-5.4-mini`	`fast`	OpenAI; veloce ed economico. Buona scelta predefinita.
`qwen3.5-flash`	`fast`	Alibaba Qwen; prezzo competitivo per cinese + codice + multilingue.
`claude-sonnet-4-6`	`balanced`	Anthropic; ideale per conversazioni a contesto lungo. Richiede il formato provider claude mostrato sopra.
`gemini-2.5-flash`	`fast`	Google; ampia finestra di contesto per workflow con molti file.

Risoluzione dei problemi

Nomi dei campi diversi tra le versioni di OpenClaw — i campi mostrati sopra (type / base_url / api_key) sono lo schema comune. Se una specifica release di OpenClaw li rinomina (e.g. provider_type / baseUrl), consulta il riferimento ufficiale di configurazione e riporta gli stessi valori.

401 / 403 — chiave API errata, disabilitata o con quota esaurita. Controlla /console/keys e /console/billing.

"Unknown model" — lo slug del modello deve corrispondere alla colonna id in /console/pricing. Se lo referenzi tramite agent.model = "synthorai/MODEL_ID" assicurati che MODEL_ID sia instradabile con la chiave fornita.

Deployment privati / air-gapped — lo stesso formato JSON funziona; basta sostituire il https://synthorai.io pubblico con l'hostname del tuo gateway interno.

Per vedere quanto costa ogni opzione per un assistente sempre attivo, fai passare il volume previsto attraverso il LLM API cost calculator.