Installa ZeroClaw
Singolo binario Rust, molteplici metodi di installazione. Scegli quello che fa per te.
checklist Requisiti di Sistema
Toolchain Rust (stable) tramite rustup.rs — necessaria solo per la compilazione dai sorgenti
Linux (x86_64, aarch64, armv7), macOS (x86_64, aarch64), Windows (x86_64)
Runtime: <5MB di RAM. Compilazione dai sorgenti: 2GB+ di RAM, 4GB consigliati
Binario: ~8.8MB. Compilazione dai sorgenti: 6GB di spazio libero, 10GB consigliati
Opzionale: Docker (per runtime sandboxed), Git (per compilazione dai sorgenti)
Internet per le chiamate API AI. I modelli locali tramite Ollama funzionano completamente offline.
Script in una riga che gestiscono tutto. Consigliato per la maggior parte degli utenti.
Remote One-Liner
macOS / Linux. Single command.
curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/bootstrap.sh | bash Local Bootstrap
Clone first, then bootstrap. More options.
git clone https://github.com/zeroclaw-labs/zeroclaw.git cd zeroclaw && ./bootstrap.sh # With system deps + Rust: ./bootstrap.sh --install-system-deps --install-rust # With onboarding: ./bootstrap.sh --onboard --api-key "sk-..." --provider openrouter verified Verifica l'Installazione
Esegui questi comandi per confermare che ZeroClaw è installato correttamente.
zeroclaw --version Dovrebbe stampare la versione installata. Esecuzione in ~0.02s con ~3.9MB di memoria al picco.
zeroclaw doctor Esegue la diagnostica di sistema: versione Rust, file di configurazione, connettività provider, stato dei canali.
zeroclaw onboard --interactive Wizard di setup interattivo per API key, selezione provider e configurazione canali.
settings Configurazione Iniziale
Dopo l'installazione, il wizard di onboarding ti guida nel setup. Ecco cosa fa ogni passaggio.
Scegli il Tuo Provider AI
Seleziona dal catalogo provider: OpenAI, Anthropic, Google Gemini, xAI, Mistral, DeepSeek, OpenRouter (100+ modelli), o qualsiasi endpoint compatibile OpenAI incluso Ollama per modelli locali.
Aggiungi la Tua API Key
Incolla la tua API key. Le chiavi sono salvate localmente in config.toml — mai inviate altrove se non al provider AI. Supportata anche l'autenticazione subscription (OpenAI Codex, Anthropic) con profili cifrati.
Collega un Canale
Collega Telegram (incolla il token del bot), Discord (incolla il token del bot), Slack (app workspace), WhatsApp (codice QR), o uno qualsiasi degli oltre 17 canali supportati. Policy allowlist deny-by-default.
Avvia l'Agente
Esegui 'zeroclaw agent -m "Ciao!"' per un test rapido, 'zeroclaw daemon' per il runtime autonomo completo, o 'zeroclaw service install' per il servizio in background.
.env — Tutta la configurazione è salvata in ~/.zeroclaw/config.toml. Modifica direttamente per cambiare provider, canali, backend di memoria, tunnel e impostazioni di sicurezza. Vedi docs/reference/README.md per il riferimento completo.
system_update_alt Aggiornare ZeroClaw
Mantieni ZeroClaw aggiornato per ottenere le ultime funzionalità, integrazioni e patch di sicurezza.
brew upgrade zeroclaw cargo install zeroclaw --force cd zeroclaw && git pull && cargo build --release --locked ./bootstrap.sh --docker --skip-build Controlla il changelog su github.com/zeroclaw-labs/zeroclaw/releases per le novità di ogni versione.
build Risoluzione Problemi
Problemi comuni e come risolverli.
Serve Aiuto?
Unisciti alla nostra community per supporto all'installazione e risoluzione problemi.