Sezioni dell'archivio conoscenza ▾

Navigazione

▸ Inizia qui Per ruolo

Categorie

Strumenti 52
Glossario 12

Strumenti

OpenClaw + Gonka AI — agenti AI accessibili

OpenClaw è un framework per la creazione di AI-agent autonomi, capaci di eseguire compiti complessi: ricerca, scrittura di codice, automazione dei processi aziendali. Gli agenti lavorano nel ciclo "pensa → agisci → osserva", scomponendo autonomamente i compiti e richiamando strumenti.

Il problema principale degli agenti autonomi è il costo. Un agente può effettuare 50-500 chiamate LLM per compito. Con i prezzi OpenAI ($5—30/1M token) sono $10—100 per compito. Se l'agente lavora continuamente, il conto mensile raggiunge migliaia di dollari. È la differenza tra un prodotto redditizio e uno in perdita.

JoinGonka Gateway riduce il costo di circa 720—1,400 volte: $0.0069/1M token in input e $0.021/1M in output. Un agente che costava $100 per compito, ora costa circa 10 centesimi (ai prezzi di settembre 2026). Ciò rende gli agenti autonomi economicamente sostenibili anche per startup e sviluppatori indie.

Passo 1: Ottieni la chiave API

Registrazione su JoinGonka Gateway:

  1. Vai su gate.joingonka.ai/register.
  2. Ottieni un bonus di 3M token gratuiti.
  3. Crea una API-key nella Dashboard → API Keys (formato: jg-xxx).

Il bonus è sufficiente per testare il collegamento sui primi avvii dell'agente — l'economia è radicalmente diversa rispetto a OpenAI.

Passo 2: Configura OpenClaw

OpenClaw funziona con JoinGonka Gateway in modalità compatibile con OpenAI. Il modo più semplice è configurarlo con l'installer da un solo comando: imposta da sé il provider con il baseUrl e i modelli corretti, facendo un backup della configurazione attuale:

npx @joingonka/setup --tool openclaw

È l'installer universale di JoinGonka: senza flag — npx @joingonka/setup — ti propone di scegliere uno strumento da un elenco. Ce ne sono già 25: Claude Code, Codex CLI, OpenClaw, Cursor, Cline e altri — l'elenco completo nel README del pacchetto.

L'installer chiede l'API key (jg-…) e aggiunge in ~/.openclaw/openclaw.json solo il provider JoinGonka, senza toccare il resto delle tue impostazioni. La chiave viene scritta nel file come literal, e il file riceve i permessi 600. Il modello principale diventa DeepSeek V4 Flash, mentre GLM-5.3 Flash e MiniMax M2.7 fungono da fallback: se un modello è occupato, l'agente passa al successivo invece di fermarsi. Il tuo elenco di modelli di fallback, se ne hai già uno, non viene toccato dall'installer; per impostare un altro modello principale si usa il flag --model minimax|deepseek|glm.

Configurare manualmente (piano B)

OpenClaw memorizza i provider in ~/.openclaw/openclaw.json — una struttura annidata in models.providers. Aggiungi il provider gonka in modalità OpenAI (api: openai-completions, baseUrl con /v1):

{
  "models": {
    "providers": {
      "gonka": {
        "baseUrl": "https://gate.joingonka.ai/v1",
        "api": "openai-completions",
        "apiKey": "jg-your-key",
        "models": [
          { "id": "deepseek-ai/DeepSeek-V4-Flash-0731", "name": "DeepSeek V4 Flash", "contextWindow": 380000, "maxTokens": 32768 },
          { "id": "zai-org/GLM-5.3-Flash", "name": "GLM-5.3 Flash", "contextWindow": 390000, "maxTokens": 8192 },
          { "id": "MiniMaxAI/MiniMax-M2.7", "name": "MiniMax M2.7", "contextWindow": 200000, "maxTokens": 8192 }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "gonka/deepseek-ai/DeepSeek-V4-Flash-0731",
        "fallbacks": ["gonka/zai-org/GLM-5.3-Flash", "gonka/MiniMaxAI/MiniMax-M2.7"]
      }
    }
  }
}

La chiave è scritta nel file come literal, quindi lascia l'accesso al file solo a te stesso: chmod 600 ~/.openclaw/openclaw.json. OpenClaw supporta anche il riferimento a una variabile d'ambiente ("apiKey": "${GONKA_API_KEY}"), ma funziona solo finché la variabile è esportata nell'ambiente da cui viene avviato l'agente; il literal invece non dipende dall'ambiente. Il blocco fallbacks contiene i modelli di riserva: se il principale è occupato, l'agente passa al successivo invece di fermarsi. Per ogni modello sono indicati la finestra di contesto e il limite massimo di risposta reali.

Tool calling: tutti i modelli della rete supportano il tool calling nativo — fondamentale per i framework agentici. L'agente può richiamare ricerca, lettura di file, esecuzione di codice e altri strumenti tramite la standard OpenAI function calling API.

Verifica: avvia un semplice agente con il compito «scrivi hello world in Python e spiega il codice». Se l'agente ha portato a termine il compito, la configurazione è riuscita.

Economia degli agenti autonomi

Gli agenti autonomi sono tra le applicazioni che richiedono più token. Un singolo ciclo di un agente (prompt → strumenti → riflessione) consuma 5-50K token. Un compito complesso può richiedere 50-500 cicli. Confrontiamo l'economia:

ScenarioToken per compitoOpenAI GPT-5.5JoinGonka MiniMax M2.7Risparmio
Compito semplice (10 cicli)~500K$1.25 — $5.00$0.0072170x — 700x
Compito medio (100 cicli)~5M$12.50 — $50.00$0.072170x — 700x
Compito complesso (500 cicli)~25M$62.50 — $250.00$0.36170x — 700x
Mese di lavoro continuo~5B$12,500 — $50,000$72170x — 700x

Con i prezzi di OpenAI, gli agenti autonomi non sono economicamente sostenibili per la maggior parte delle attività. Con i prezzi di Gonka, un agente può operare 24 ore su 24 per $48 al mese. Questo cambia il modello: gli agenti passano da "costoso giocattolo" a strumento di lavoro.

Per le aziende: se il vostro prodotto utilizza AI-agents (assistenza clienti, analisi dati, automazione), il passaggio a Gonka può ridurre i costi del 99.81%, aumentando così il margine o riducendo il prezzo per i clienti.

Limitazioni: la finestra di contesto di MiniMax M2.7 è di 200K token, mentre per DeepSeek V4 Flash è di 380K. Per agenti con una cronologia molto lunga (500+ cicli), potrebbe essere necessaria una sintesi del contesto. La lunghezza massima di ogni risposta è di 8192 token per MiniMax M2.7 e GLM-5.3 Flash, 32768 per DeepSeek V4 Flash, sufficienti per un tipico ciclo di un agente (istruzione + chiamata a strumento).

OpenClaw + Gonka = AI-agents autonomi a $24/mese invece di $12,500+ con OpenAI. Risparmi di centinaia di volte rendono gli agenti redditizi anche per gli sviluppatori indipendenti. Il tool calling nativo su tutti i modelli della rete garantisce una piena compatibilità.

Vuoi saperne di più?

Esplora altre sezioni o inizia a guadagnare GNK subito.

Ottieni token gratuiti →