Costi e provider dell'API NanoClaw: Claude, OpenCode e percorsi locali

NanoClaw costa 0 $. È distribuito con licenza MIT, è self-hosted, non ha account utente né un livello a pagamento e il suo sito documentale non pubblica affatto una pagina dei prezzi — quindi "prezzi di NanoClaw" significa la fattura del modello del provider che colleghi, oltre a un abbonamento Docker Desktop se la tua azienda supera le soglie di utilizzo gratuito di Docker. Il dato da pianificare è quanto addebita il runtime predefinito, perché NanoClaw viene fornito configurato per Claude; Codex è l'unica alternativa che la configurazione può installare inline, mentre il resto sono componenti aggiuntivi da installare successivamente.

Prima, due disambiguazioni, perché la pagina dei risultati li mescola. Clawland-AI/nanoclaw è un agente Python non correlato per computer a scheda singola e i relativi costi hardware non appartengono a questo prodotto. Un titolo di terze parti ampiamente condiviso associa inoltre una cifra in dollari alle parole "NanoClaw PR factory"; qualunque cosa misuri quella cifra, non è un prezzo applicato da NanoClaw, perché NanoClaw non addebita nulla. Questa pagina riguarda nanocoai/nanoclaw — MIT, non archiviato, 30.814 stelle, creato il 31 gennaio 2026, ultimo push il 19 settembre 2026 (GitHub API, 21 settembre 2026). Il vecchio indirizzo qwibitai/nanoclaw ora restituisce un 301 verso lo stesso repository, quindi un articolo o una voce di directory che vi punti ancora non descrive un secondo progetto. L'installazione documentata da NanoClaw è bash nanoclaw.sh da quel checkout; considera quindi una voce su SourceForge come un mirror anziché come il canale del progetto.

Quanto costa il software e cosa genera effettivamente addebiti

La FAQ della homepage di NanoClaw risponde alla domanda sui costi in una riga: è gratuito e open source con licenza MIT e "il provider del tuo agente può addebitare l'utilizzo dei modelli". L'indice della documentazione elenca 56 pagine e nessuna è dedicata a prezzi, fatturazione o piani. La fattura vive interamente dall'altra parte del container.

Tutto verificato il 21 settembre 2026. La voce Docker è quella che le persone trascurano: Docker Engine su Linux non attiva quella clausola, mentre un'installazione commerciale su macOS o Windows oltre tali soglie sì. Prima di tutto, i requisiti del README sono macOS o Linux (Windows tramite WSL2), Node.js 22+ e pnpm 10+, Docker e Claude Code stesso — che è un prerequisito per /customize, /debug, il recupero dagli errori di configurazione e ogni skill /add-<channel>, non solo per il provider predefinito. La release attuale è v2.4.0, pubblicata il 23 settembre 2026, e package.json sul main coincide.

Il runtime predefinito è Claude e ci sono tre modi per pagarlo

Questa è la distinzione che la maggior parte degli elenchi di provider confonde. Pronto all'uso, NanoClaw esegue Claude Code nel container dell'agente tramite Anthropic Claude Agent SDK — container/cli-tools.json blocca @anthropic-ai/claude-code alla versione 2.1.280. La guida alle credenziali di NanoClaw descrive tre modi in cui la procedura guidata collega Claude — un abbonamento Claude, una chiave API o un token OAuth già in tuo possesso, oppure un endpoint compatibile con Anthropic — e afferma che tutti e tre finiscono come segreto nel vault anziché come variabile d'ambiente, con il percorso dell'abbonamento che esegue claude setup-token e memorizza il token OAuth risultante. I prezzi dei vendor riportati di seguito sono gli importi mostrati da quelle pagine nella data indicata; conferma la cifra nel checkout del vendor prima di impegnarti.

Per quanto riguarda l'opzione dell'abbonamento, due dichiarazioni ufficiali sono affiancate e questa pagina non le riconcilierà per te. La procedura guidata di NanoClaw definisce l'accesso tramite abbonamento "consigliato se hai Pro o Max", mentre la pagina dei prezzi di Claude elenca Pro a 20 $ al mese con fatturazione mensile, oppure 17 $ al mese con il piano annuale da 200 $ addebitati in anticipo, e Max a partire da 100 $ al mese. La panoramica dell'Agent SDK di Anthropic afferma separatamente che, salvo approvazione preventiva, non consente agli sviluppatori di terze parti di offrire il login claude.ai o i limiti di velocità per i propri prodotti, inclusi gli agenti creati con Agent SDK. Nessuna fonte pubblica qui consultata può stabilire se NanoClaw disponga di tale approvazione; né può stabilire quale quota di utilizzo un abbonamento assegni a un agente — Anthropic non pubblica alcuna quantità di token per Pro o Max.

API personalizzata di NanoClaw: l'unico percorso documentato

Un endpoint compatibile con Anthropic è un percorso di configurazione di prima classe ed è più ristretto di quanto suggerisca il README. Impostare entrambe le variabili seguenti fa sì che la configurazione crei un segreto OneCLI con inserimento dell'header associato al tuo hostname, scriva soltanto l'URL di base in .env e registri la configurazione del provider con endpoint personalizzato.

# NanoClaw's credentials guide: set BOTH before running setup.
# Only one of the two is not enough — setup takes this branch only when
# no Anthropic secret exists yet, and the URL is an origin with no /v1.
export NANOCLAW_ANTHROPIC_BASE_URL=https://api.kunavo.com
export NANOCLAW_ANTHROPIC_AUTH_TOKEN=<your key>

# The same two values exist as setup flags:
#   --anthropic-base-url   --anthropic-auth-token

Da come è costruito derivano quattro vincoli. Entrambe le variabili sono obbligatorie: il ramo della configurazione verifica la coppia. Il ramo viene eseguito solo quando non esiste ancora alcun segreto Anthropic, quindi questo è un percorso di prima installazione, non un modo per reindirizzare una macchina a cui Claude è già collegato. Il segreto è associato all'hostname estratto dal tuo URL, quindi cambiare dominio significa ricrearlo. Inoltre, l'URL deve essere un'origine: il riferimento di Kunavo ad ANTHROPIC_BASE_URL spiega perché https://api.kunavo.com funziona e https://api.kunavo.com/v1 produce richieste verso /v1/v1/messages.

Blocca anche il modello. Un gruppo senza un proprio modello esegue quello predefinito di Claude Code, che segue l'Opus più recente — Opus 5.5 dalla v2.4.0, secondo il changelog di NanoClaw — e un modello che Kunavo non serve ancora restituisce 404. NANOCLAW_DEFAULT_MODEL nel .env dell'installazione completa ogni gruppo che non ne abbia impostato uno; il riferimento alle variabili d'ambiente afferma che una modifica richiede il riavvio dell'host e poi il riavvio delle sessioni interessate.

# NanoClaw 2.4.0+: the model for every agent group that has not set its
# own (a group's own model wins). Install-wide, so Codex and OpenCode groups
# without one get it too; on a mixed install set each Claude group instead:
#   ncl groups config update --id <group> --model <model>
NANOCLAW_DEFAULT_MODEL=claude-sonnet-5

Nel container il tuo token non compare mai. Il provider Claude di NanoClaw inserisce l'URL di base più ANTHROPIC_AUTH_TOKEN=placeholder, e il gateway del vault riscrive il bearer sulla rete — il che significa anche che l'inserimento dipende dal fatto che il container utilizzi il proprio HTTPS_PROXY configurato. Qualsiasi bypass di quel proxy bypassa anche la credenziale. Nella v2.3.0 il driver rifiuta una specifica del container che contenga in assoluto un valore di credenziale nell'ambiente fornito, quindi modificare manualmente un container.json generato inserendo una chiave reale viene negato dalle policy anziché essere semplicemente sconsigliato.

Due fonti ufficiali non concordano sulla versione semplice di .env, ed è utile conoscere entrambe. Il README presenta ANTHROPIC_BASE_URL e ANTHROPIC_AUTH_TOKEN in .env "per esperimenti una tantum", mentre il riferimento alle variabili d'ambiente afferma che ANTHROPIC_BASE_URL è attivo solo dopo che la configurazione ha registrato la configurazione del provider con endpoint personalizzato. Nel main attuale la parte relativa al token non raggiunge mai una richiesta: il file del provider Claude collegato sopra chiede a .env soltanto ANTHROPIC_BASE_URL e imposta ANTHROPIC_AUTH_TOKEN sulla stringa letterale placeholder. Considera il frammento del README un esperimento, esattamente come è etichettato, e il percorso di configurazione riportato sopra come quello da eseguire.

Predefinito rispetto a esteso: cosa installa effettivamente ogni route

Fonti verificate il 21 settembre 2026: la guida ai provider di NanoClaw, i relativi file skill /add-opencode e /add-codex, docs/ollama.md e la pagina dei prezzi di ChatGPT (il vecchio URL dei prezzi di Codex ora reindirizza lì). La prima colonna segue la stessa guida ai provider, che indica che il selettore del runtime durante la configurazione iniziale offre Codex come installazione in linea, mentre OpenCode viene aggiunto dopo la configurazione con /add-opencode. L'avvertenza su Ollama proviene dal fornitore stesso: la guida ai provider afferma che la skill resta nel repository ma punta a un percorso di configurazione più vecchio, che tali modifiche legacy «non costituiscono un passaggio senza adattamenti supportato sul ramo main attuale» e che l'integrazione deve prima essere portata e testata — mentre il README continua a elencarla come percorso supportato. Quando le due fonti divergono, la guida ai provider, più recente e specifica, è quella da seguire. OpenRouter raggiunge NanoClaw tramite il backend OpenCode, non tramite un URL di base Anthropic; le FAQ di OpenRouter applicano il 5,5% con un minimo di $0,80 sugli acquisti di credito con carta e il 5% sulle criptovalute, senza maggiorazione sull'inferenza stessa.

Una stima esemplificativa dei costi API di NanoClaw

Si tratta di un calcolo dei token basato su ipotesi dichiarate, non del costo misurato di un'attività né di un limite massimo della fattura. Supponiamo un gruppo di agenti che gestisca 40 turni al giorno, ciascuno con 30.000 token di input e 1.500 token di output, con nulla fornito dalla cache. Le tariffe sono i prezzi aggiornati del catalogo Kunavo per milione di token.

Tre considerazioni. Primo, Claude Sonnet 5 e Claude Opus 5 non hanno più la stessa tariffa di catalogo, quindi confronta direttamente queste due righe prima di scegliere — rispetto alla tariffa pubblicata da Anthropic per lo stesso model ID Opus 5, $5,00 e $25,00 per milione, il costo stimato per lo stesso mese di utilizzo è di $225,00. Secondo, la cache è una leva più importante della riga del modello, perché la stessa pagina indica una lettura dalla cache pari a 0,1x dell'input di base e una scrittura in cache di cinque minuti pari a 1,25x: se il 70% dell'input precedente arrivasse come letture dalla cache alla tariffa di catalogo per l'input in cache di $0,35 per milione, il costo stimato per lo stesso mese di utilizzo di Claude Opus 5 sarebbe di $78,12 invece di $157,50. Terzo, adatta il numero di turni ai tuoi canali prima di considerare tutto questo un budget: un agente NanoClaw collegato a una chat di gruppo molto attiva e uno collegato a una singola persona non rappresentano lo stesso carico di lavoro.

L'importo del catalogo Kunavo è una soglia minima di fatturazione, non un tetto massimo: quando il provider upstream comunica il proprio addebito, la fattura è pari al maggiore tra il costo del catalogo e il costo upstream moltiplicato per il markup applicabile. La ricarica minima è $10 in credito prepagato — una soglia di finanziamento, non un costo per attività né un abbonamento. Consulta i dettagli sulla fatturazione e i report sull'utilizzo.

Verifica minima e costi futuri dell'estensione

La verifica utile più economica è semplice: setup/index.ts registra un passaggio verify, e la stessa skill /add-opencode prevede di inviare un messaggio, confermare una risposta, quindi inviarne un secondo per confermare che la sessione continui. Per un endpoint personalizzato, docker exec <container> env | grep ANTHROPIC dovrebbe mostrare il tuo base URL accanto a un token segnaposto — se lì è visibile la chiave reale, c'è un problema nel percorso, non una conferma del suo corretto funzionamento.

Poi considera il costo della manutenzione, perché i provider estesi sono software bloccato a versioni specifiche. Il changelog di NanoClaw registra che il precedente pin di Codex utilizzava per impostazione predefinita un modello ritirato da OpenAI da Codex il 31 agosto 2026 e che rieseguire /add-codex non aggiorna il pin di un'installazione esistente — il pin attuale è @openai/codex 0.155.1, dalla v2.4.0. Anche il pin di OpenCode è oggetto di un conflitto tra fonti aggiornate: il file skill del repository afferma che entrambi i pin devono rimanere esattamente 1.18.25, mentre la guida ai provider pubblicata indica ancora 1.4.17. Il repository è la fonte più specifica e OpenCode ha inoltre cambiato organizzazione — sst/opencode ora reindirizza con un 301 a anomalyco/opencode, la cui release più recente è la v1.18.31 del 14 settembre 2026. Le installazioni su OneCLI 1.41.0 richiedono inoltre una nuova autenticazione manuale quando scade un login ChatGPT di OpenCode.

Le capacità cambiano quando abbandoni il provider Claude, secondo la guida ai provider: OpenCode e Codex dichiarano entrambi di non avere comandi slash nativi, accodano entrambi i messaggi successivi invece di accettare input durante il turno, Codex legge AGENTS.md con un limite di 32 KiB rispetto ai 4 MiB di Claude e solo il provider Claude ruota le trascrizioni. Cambiando gruppo, l'albero memory/ viene trasferito ma non il contesto della conversazione in corso, e le modifiche diventano effettive solo al successivo avvio del container.

Configurare NanoClaw per usare Kunavo

Kunavo pubblica riferimenti di configurazione per questo tipo di client — le guide Claude Agent SDK e Claude Code coprono il runtime predefinito, mentre OpenCode e Codex CLI coprono i due runtime estesi. Sono riferimenti di configurazione pubblicati, non test di compatibilità: NanoClaw non è stato testato a runtime qui e tutto quanto sopra è una lettura del suo repository e della sua documentazione. Mantieni disponibile una route funzionante mentre lo provi, esegui un'attività delimitata, quindi leggi ciò che il tuo account ha registrato. Crea un account Kunavo quando sei pronto a finanziare una chiave.

Stai scegliendo tra agenti anziché tra provider? NanoClaw vs OpenClaw confronta l'isolamento e la libertà di scelta dei provider, mentre prezzi di OpenCode, prezzi di Codex e alternative a OpenRouter coprono le tre route che questa pagina tratta come componenti aggiuntivi. Prezzi di Claude Code descrive più dettagliatamente la fatturazione propria del runtime predefinito.

Domande frequenti

Recuperati direttamente durante la stesura di questa pagina, il 21 settembre 2026: il record del repository nanocoai/nanoclaw e l'elenco delle release, package.json, container/cli-tools.json, il README, la documentazione dell'immagine hardened, nanoclaw.dev, l'indice della documentazione, le pagine sulle credenziali, sulle variabili d'ambiente e sui provider, docs/ollama.md, il changelog, i file skill /add-opencode e /add-codex, il repository OneCLI e la pagina dei prezzi di Anthropic. Gli importi di Docker, degli abbonamenti Claude, di ChatGPT e di OpenRouter sono citati dalle rispettive pagine dei prezzi dei vendor come registrati nella stessa data, anziché essere recuperati nuovamente qui; confermali quindi nel checkout del vendor. Le tariffe dei token Kunavo provengono dal catalogo aggiornato. La release v2.4.0, il relativo changelog, container/cli-tools.json e il riferimento alle variabili d'ambiente sono stati verificati nuovamente il 24 settembre 2026, quando è stato aggiunto il pin del modello. Nulla in questa pagina è stato testato a runtime contro un'installazione NanoClaw e ogni cifra in dollari è un calcolo illustrativo dei token.