Guida all'installazione

Avvia NanoClaw

Nucleo leggero in TypeScript, un solo percorso di installazione. Clona, esegui claude, usa /setup.

checklist Requisiti di sistema

javascript Node.js

Node.js 20+ (LTS consigliato)

computer OS

macOS o Linux. Windows tramite WSL2 potrebbe funzionare ma non è ufficialmente supportato.

memory RAM

512MB+ di RAM. Runtime leggero, nessuna compilazione pesante.

hard_drive Disk

~50MB installati (node_modules). L'immagine container aggiunge ~500MB.

extension Optional

Necessario: Apple Container (macOS) o Docker (macOS/Linux). Necessario: CLI di Claude Code.

wifi Network

Connessione internet necessaria per le chiamate API Anthropic. Nessuna modalità offline.

Clona il repository e inizia con la CLI di Claude. Operativo in pochi minuti.

bolt

One-Liner

Requires Claude CLI. All platforms.

$ git clone https://github.com/qwibitai/NanoClaw.git && cd NanoClaw && claude

list_alt

Step-by-Step

Clone first, then configure. More control.

$ git clone https://github.com/qwibitai/NanoClaw.git

$ cd NanoClaw && npm install

$ # Run claude and use /setup for guided configuration

$ # Or edit .env and src/index.ts directly

verified Verifica l'installazione

Esegui questi comandi per confermare che NanoClaw è installato correttamente.

$ node -e "console.log(require('./package.json').version)"

Dovrebbe stampare il numero di versione installato.

$ npm test

Esegue la suite di test (vitest) per verificare dipendenze e funzionalità principali.

$ claude

Apre Claude Code. Esegui /setup nella sessione per la configurazione guidata.

settings Configurazione iniziale

Claude Code gestisce la configurazione tramite /setup. Ecco cosa configura.

Installa dipendenze

Claude Code esegue npm install e crea l'immagine container (nanoclaw-agent:latest) con Chromium, agent-browser e Claude Code preinstallati.

Autenticazione

Imposta ANTHROPIC_API_KEY nel file .env, oppure autenticati tramite Claude Code OAuth. I segreti vengono passati ai container a runtime, mai caricati in process.env.

Collega WhatsApp

Esegui 'npm run auth' per associare tramite codice QR. WhatsApp è il canale integrato. Aggiungi Telegram, Discord o Slack in seguito tramite skill (/add-telegram, /add-discord, /add-slack).

Avvia l'agente

Esegui 'npm start' per avviare NanoClaw. Si collega a WhatsApp, avvia il ciclo di polling dei messaggi e inizia a elaborare i messaggi in container isolati.

.env — NanoClaw non usa file di configurazione. Per apportare modifiche, di' a Claude Code cosa vuoi. Il codice è abbastanza piccolo perché Claude possa modificarlo in sicurezza.

system_update_alt Aggiornamento di NanoClaw

Mantieni NanoClaw aggiornato per ottenere le ultime funzionalità, integrazioni e patch di sicurezza.

Git + npm

$ cd NanoClaw && git pull && npm install

Docker

$ cd NanoClaw && git pull && docker compose up --build

Consulta il changelog su github.com/qwibitai/nanoclaw/releases per le novità di ogni versione.

build Risoluzione dei problemi

Problemi comuni e come risolverli.

Serve aiuto?

Unisciti alla nostra comunità per supporto all'installazione e risoluzione dei problemi.

forum Unisciti a Discord menu_book Leggi la documentazione

hub Integrazioni • article Blog • menu_book Documentazione