🦀 ZeroClaw — Assistente Personale IA

Zero overhead. Zero compromessi. 100% Rust. 100% Agnostico.
⚡️ Funziona su hardware da $10 con <5MB di RAM: il 99% in meno di memoria rispetto a OpenClaw e il 98% più economico di un Mac mini!

Costruito da studenti e membri delle comunità di Harvard, MIT e Sundai.Club.

🌐 Lingue: 🇺🇸 English · 🇨🇳 简体中文 · 🇯🇵 日本語 · 🇰🇷 한국어 · 🇻🇳 Tiếng Việt · 🇵🇭 Tagalog · 🇪🇸 Español · 🇧🇷 Português · 🇮🇹 Italiano · 🇩🇪 Deutsch · 🇫🇷 Français · 🇸🇦 العربية · 🇮🇳 हिन्दी · 🇷🇺 Русский · 🇧🇩 বাংলা · 🇮🇱 עברית · 🇵🇱 Polski · 🇨🇿 Čeština · 🇳🇱 Nederlands · 🇹🇷 Türkçe · 🇺🇦 Українська · 🇮🇩 Bahasa Indonesia · 🇹🇭 ไทย · 🇵🇰 اردو · 🇷🇴 Română · 🇸🇪 Svenska · 🇬🇷 Ελληνικά · 🇭🇺 Magyar · 🇫🇮 Suomi · 🇩🇰 Dansk · 🇳🇴 Norsk

ZeroClaw è un assistente personale IA che esegui sui tuoi dispositivi. Ti risponde sui canali che già usi (WhatsApp, Telegram, Slack, Discord, Signal, iMessage, Matrix, IRC, Email, Bluesky, Nostr, Mattermost, Nextcloud Talk, DingTalk, Lark, QQ, Reddit, LinkedIn, Twitter, MQTT, WeChat Work e altri). Ha una dashboard web per il controllo in tempo reale e può connettersi a periferiche hardware (ESP32, STM32, Arduino, Raspberry Pi). Il Gateway è solo il piano di controllo — il prodotto è l'assistente.

Se vuoi un assistente personale, per un singolo utente, che sia locale, veloce e sempre attivo, questo fa per te.

Sito web · Documentazione · Architettura · Per iniziare · Migrazione da OpenClaw · Risoluzione problemi · Discord

Configurazione consigliata: esegui zeroclaw onboard nel tuo terminale. ZeroClaw Onboard ti guida passo dopo passo nella configurazione del gateway, workspace, canali e provider. È il percorso di configurazione consigliato e funziona su macOS, Linux e Windows (tramite WSL2). Nuova installazione? Inizia qui: Per iniziare

• OpenAI Codex (abbonamento ChatGPT)
• Gemini (Google OAuth)
• Anthropic (chiave API o token di autenticazione)

Nota sui modelli: sebbene siano supportati molti provider/modelli, per la migliore esperienza usa il modello di ultima generazione più potente a tua disposizione. Vedi Onboarding.

Configurazione modelli + CLI: Riferimento provider Rotazione profili di autenticazione (OAuth vs chiavi API) + failover: Failover modelli

Requisito: toolchain stabile di Rust. Un singolo binario, nessuna dipendenza di runtime.

brew install zeroclaw

git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw
./install.sh

zeroclaw onboard viene eseguito automaticamente dopo l'installazione per configurare il tuo workspace e provider.

Guida completa per principianti (autenticazione, accoppiamento, canali): Per iniziare

# Installa + onboard
./install.sh --api-key "sk-..." --provider openrouter

# Avvia il gateway (server webhook + dashboard web)
zeroclaw gateway                # predefinito: 127.0.0.1:42617
zeroclaw gateway --port 0       # porta casuale (sicurezza rafforzata)

# Parla con l'assistente
zeroclaw agent -m "Hello, ZeroClaw!"

# Modalità interattiva
zeroclaw agent

# Avvia il runtime autonomo completo (gateway + canali + cron + hands)
zeroclaw daemon

# Controlla lo stato
zeroclaw status

# Esegui diagnostica
zeroclaw doctor

Aggiornamento? Esegui zeroclaw doctor dopo l'aggiornamento.

git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw

cargo build --release --locked
cargo install --path . --force --locked

zeroclaw onboard

Alternativa per lo sviluppo (senza installazione globale): anteponi cargo run --release -- ai comandi (esempio: cargo run --release -- status).

ZeroClaw può importare il tuo workspace, memoria e configurazione da OpenClaw:

# Anteprima di ciò che verrà migrato (sicuro, sola lettura)
zeroclaw migrate openclaw --dry-run

# Esegui la migrazione
zeroclaw migrate openclaw

Questo migra le tue voci di memoria, i file del workspace e la configurazione da ~/.openclaw/ a ~/.zeroclaw/. La configurazione viene convertita da JSON a TOML automaticamente.

ZeroClaw si connette a superfici di messaggistica reali. Tratta i DM in arrivo come input non attendibile.

Guida completa alla sicurezza: SECURITY.md

Comportamento predefinito su tutti i canali:

• Accoppiamento DM (predefinito): i mittenti sconosciuti ricevono un breve codice di accoppiamento e il bot non elabora il loro messaggio.
• Approva con: zeroclaw pairing approve <channel> <code> (il mittente viene quindi aggiunto a una allowlist locale).
• I DM pubblici in arrivo richiedono un'attivazione esplicita in config.toml.
• Esegui zeroclaw doctor per individuare politiche DM rischiose o mal configurate.

Livelli di autonomia:

Livelli di sandboxing: isolamento del workspace, blocco del traversal dei percorsi, allowlist dei comandi, percorsi proibiti (/etc, /root, ~/.ssh), limitazione della velocità (max azioni/ora, tetti di costo/giorno).

Usa questa bacheca per avvisi importanti (breaking change, avvisi di sicurezza, finestre di manutenzione e bloccanti del rilascio).

• Runtime leggero per impostazione predefinita — i flussi di lavoro comuni di CLI e stato funzionano in pochi megabyte di memoria nelle build release.
• Distribuzione economica — progettato per schede da $10 e piccole istanze cloud, nessuna dipendenza di runtime pesante.
• Avvio a freddo rapido — il runtime Rust a binario singolo mantiene l'avvio dei comandi e del daemon quasi istantaneo.
• Architettura portabile — un binario per ARM, x86 e RISC-V con provider/canali/strumenti intercambiabili.
• Gateway local-first — piano di controllo unico per sessioni, canali, strumenti, cron, SOP ed eventi.
• Casella di posta multicanale — WhatsApp, Telegram, Slack, Discord, Signal, iMessage, Matrix, IRC, Email, Bluesky, Nostr, Mattermost, Nextcloud Talk, DingTalk, Lark, QQ, Reddit, LinkedIn, Twitter, MQTT, WeChat Work, WebSocket e altri.
• Orchestrazione multi-agente (Hands) — sciami di agenti autonomi che funzionano secondo programma e diventano più intelligenti nel tempo.
• Procedure Operative Standard (SOP) — automazione dei flussi di lavoro guidata da eventi con MQTT, webhook, cron e trigger dei periferici.
• Dashboard web — interfaccia web React 19 + Vite con chat in tempo reale, browser della memoria, editor di configurazione, gestore cron e ispettore degli strumenti.
• Periferiche hardware — ESP32, STM32 Nucleo, Arduino, Raspberry Pi GPIO tramite il trait Peripheral.
• Strumenti di prima classe — shell, I/O file, browser, git, web fetch/search, MCP, Jira, Notion, Google Workspace e oltre 70 altri.
• Hook del ciclo di vita — intercetta e modifica chiamate LLM, esecuzioni di strumenti e messaggi in ogni fase.
• Piattaforma skill — skill incluse, della community e del workspace con audit di sicurezza.
• Supporto tunnel — Cloudflare, Tailscale, ngrok, OpenVPN e tunnel personalizzati per l'accesso remoto.

• Leggero per impostazione predefinita: binario Rust piccolo, avvio rapido, basso consumo di memoria.
• Sicuro per design: accoppiamento, sandboxing rigoroso, allowlist esplicite, scoping del workspace.
• Completamente intercambiabile: i sistemi centrali sono trait (provider, canali, strumenti, memoria, tunnel).
• Nessun vendor lock-in: supporto provider compatibili con OpenAI + endpoint personalizzati collegabili.

Benchmark rapido su macchina locale (macOS arm64, feb 2026) normalizzato per hardware edge a 0.8GHz.

Note: I risultati di ZeroClaw sono misurati su build release usando /usr/bin/time -l. OpenClaw richiede il runtime Node.js (tipicamente ~390MB di overhead di memoria aggiuntivo), mentre NanoBot richiede il runtime Python. PicoClaw e ZeroClaw sono binari statici. I valori di RAM sopra sono memoria a runtime; i requisiti di compilazione sono superiori.

cargo build --release
ls -lh target/release/zeroclaw

/usr/bin/time -l target/release/zeroclaw --help
/usr/bin/time -l target/release/zeroclaw status

• Piano di controllo Gateway HTTP/WS/SSE con sessioni, presenza, configurazione, cron, webhook, dashboard web e accoppiamento.
• Superficie CLI: gateway, agent, onboard, doctor, status, service, migrate, auth, cron, channel, skills.
• Loop di orchestrazione dell'agente con dispatch degli strumenti, costruzione dei prompt, classificazione dei messaggi e caricamento della memoria.
• Modello di sessione con applicazione delle policy di sicurezza, livelli di autonomia e approvazione condizionale.
• Wrapper provider resiliente con failover, retry e routing dei modelli su oltre 20 backend LLM.

Canali: WhatsApp (nativo), Telegram, Slack, Discord, Signal, iMessage, Matrix, IRC, Email, Bluesky, DingTalk, Lark, Mattermost, Nextcloud Talk, Nostr, QQ, Reddit, LinkedIn, Twitter, MQTT, WeChat Work, WATI, Mochat, Linq, Notion, WebSocket, ClawdTalk.

Abilitati tramite feature gate: Matrix (channel-matrix), Lark (channel-lark), Nostr (channel-nostr).

Dashboard web React 19 + Vite 6 + Tailwind CSS 4 servita direttamente dal Gateway:

• Dashboard — panoramica del sistema, stato di salute, uptime, tracciamento dei costi
• Chat dell'agente — chat interattiva con l'agente
• Memoria — esplora e gestisci le voci di memoria
• Configurazione — visualizza e modifica la configurazione
• Cron — gestisci attività programmate
• Strumenti — esplora gli strumenti disponibili
• Log — visualizza i log di attività dell'agente
• Costi — utilizzo dei token e tracciamento dei costi
• Doctor — diagnostica della salute del sistema
• Integrazioni — stato e configurazione delle integrazioni
• Accoppiamento — gestione dell'accoppiamento dei dispositivi

• Core: shell, lettura/scrittura/modifica file, operazioni git, ricerca glob, ricerca contenuti
• Web: controllo browser, web fetch, web search, screenshot, informazioni immagine, lettura PDF
• Integrazioni: Jira, Notion, Google Workspace, Microsoft 365, LinkedIn, Composio, Pushover
• MCP: Model Context Protocol tool wrapper + set di strumenti differiti
• Programmazione: cron add/remove/update/run, strumento di programmazione
• Memoria: recall, store, forget, knowledge, project intel
• Avanzato: delegate (agente-a-agente), swarm, cambio/routing modelli, operazioni di sicurezza, operazioni cloud
• Hardware: board info, memory map, memory read (abilitato tramite feature gate)

• Livelli di autonomia: ReadOnly, Supervised (predefinito), Full.
• Sandboxing: isolamento del workspace, blocco del traversal dei percorsi, allowlist dei comandi, percorsi proibiti, Landlock (Linux), Bubblewrap.
• Limitazione della velocità: max azioni per ora, max costo per giorno (configurabile).
• Approvazione condizionale: approvazione interattiva per operazioni a rischio medio/alto.
• Arresto di emergenza: capacità di spegnimento di emergenza.
• 129+ test di sicurezza in CI automatizzato.

• Dashboard web servita direttamente dal Gateway.
• Supporto tunnel: Cloudflare, Tailscale, ngrok, OpenVPN, comando personalizzato.
• Adattatore runtime Docker per esecuzione in container.
• CI/CD: beta (automatico al push) → stable (dispatch manuale) → Docker, crates.io, Scoop, AUR, Homebrew, tweet.
• Binari precompilati per Linux (x86_64, aarch64, armv7), macOS (x86_64, aarch64), Windows (x86_64).

~/.zeroclaw/config.toml minimo:

default_provider = "anthropic"
api_key = "sk-ant-..."

Riferimento completo della configurazione: docs/reference/api/config-reference.md.

Telegram:

[channels.telegram]
bot_token = "123456:ABC-DEF..."

Discord:

[channels.discord]
token = "your-bot-token"

Slack:

[channels.slack]
bot_token = "xoxb-..."
app_token = "xapp-..."

WhatsApp:

[channels.whatsapp]
enabled = true

Matrix:

[channels.matrix]
homeserver_url = "https://matrix.org"
username = "@bot:matrix.org"
password = "..."

Signal:

[channels.signal]
phone_number = "+1234567890"

[tunnel]
kind = "cloudflare"  # o "tailscale", "ngrok", "openvpn", "custom", "none"

Dettagli: Riferimento canali · Riferimento configurazione

• native (predefinito) — esecuzione diretta dei processi, percorso più veloce, ideale per ambienti fidati.
• docker — isolamento completo in container, policy di sicurezza forzate, richiede Docker.

Imposta runtime.kind = "docker" per sandboxing rigoroso o isolamento di rete.

ZeroClaw supporta profili di autenticazione nativi tramite abbonamento (multi-account, crittografati a riposo).

• File di archiviazione: ~/.zeroclaw/auth-profiles.json
• Chiave di crittografia: ~/.zeroclaw/.secret_key
• Formato id profilo: <provider>:<profile_name> (esempio: openai-codex:work)

# OpenAI Codex OAuth (abbonamento ChatGPT)
zeroclaw auth login --provider openai-codex --device-code

# Gemini OAuth
zeroclaw auth login --provider gemini --profile default

# Anthropic setup-token
zeroclaw auth paste-token --provider anthropic --profile default --auth-kind authorization

# Controlla / aggiorna / cambia profilo
zeroclaw auth status
zeroclaw auth refresh --provider openai-codex --profile default
zeroclaw auth use --provider openai-codex --profile work

# Esegui l'agente con autenticazione tramite abbonamento
zeroclaw agent --provider openai-codex -m "hello"
zeroclaw agent --provider anthropic -m "hello"

Root del workspace: ~/.zeroclaw/workspace/ (configurabile tramite config).

File di prompt iniettati:

• IDENTITY.md — personalità e ruolo dell'agente
• USER.md — contesto e preferenze dell'utente
• MEMORY.md — fatti e lezioni a lungo termine
• AGENTS.md — convenzioni di sessione e regole di inizializzazione
• SOUL.md — identità centrale e principi operativi

Skill: ~/.zeroclaw/workspace/skills/<skill>/SKILL.md o SKILL.toml.

# Elenca le skill installate
zeroclaw skills list

# Installa da git
zeroclaw skills install https://github.com/user/my-skill.git

# Audit di sicurezza prima dell'installazione
zeroclaw skills audit https://github.com/user/my-skill.git

# Rimuovi una skill
zeroclaw skills remove my-skill

# Gestione del workspace
zeroclaw onboard              # Procedura guidata di configurazione
zeroclaw status               # Mostra stato del daemon/agente
zeroclaw doctor               # Esegui diagnostica del sistema

# Gateway + daemon
zeroclaw gateway              # Avvia server gateway (127.0.0.1:42617)
zeroclaw daemon               # Avvia runtime autonomo completo

# Agente
zeroclaw agent                # Modalità chat interattiva
zeroclaw agent -m "message"   # Modalità messaggio singolo

# Gestione servizi
zeroclaw service install      # Installa come servizio del SO (launchd/systemd)
zeroclaw service start|stop|restart|status

# Canali
zeroclaw channel list         # Elenca i canali configurati
zeroclaw channel doctor       # Controlla la salute dei canali
zeroclaw channel bind-telegram 123456789

# Cron + programmazione
zeroclaw cron list            # Elenca i lavori programmati
zeroclaw cron add "*/5 * * * *" --prompt "Check system health"
zeroclaw cron remove <id>

# Memoria
zeroclaw memory list          # Elenca le voci di memoria
zeroclaw memory get <key>     # Recupera una memoria
zeroclaw memory stats         # Statistiche della memoria

# Profili di autenticazione
zeroclaw auth login --provider <name>
zeroclaw auth status
zeroclaw auth use --provider <name> --profile <profile>

# Periferiche hardware
zeroclaw hardware discover    # Scansiona i dispositivi connessi
zeroclaw peripheral list      # Elenca le periferiche connesse
zeroclaw peripheral flash     # Flash del firmware sul dispositivo

# Migrazione
zeroclaw migrate openclaw --dry-run
zeroclaw migrate openclaw

# Completamento shell
source <(zeroclaw completions bash)
zeroclaw completions zsh > ~/.zfunc/_zeroclaw

Riferimento completo dei comandi: docs/reference/cli/commands-reference.md

curl -LsSf https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/install.sh | bash

./install.sh --prefer-prebuilt

./install.sh --prebuilt-only

Gli asset di release sono pubblicati per:

• Linux: x86_64, aarch64, armv7
• macOS: x86_64, aarch64
• Windows: x86_64

Scarica gli ultimi asset da: https://github.com/zeroclaw-labs/zeroclaw/releases/latest

Usa queste risorse quando hai superato il flusso di onboarding e vuoi il riferimento più approfondito.

• Inizia con l'indice della documentazione per la navigazione e "cosa c'è dove."
• Leggi la panoramica dell'architettura per il modello completo del sistema.
• Usa il riferimento della configurazione quando hai bisogno di ogni chiave ed esempio.
• Esegui il Gateway secondo il libro con il runbook operativo.
• Segui ZeroClaw Onboard per una configurazione guidata.
• Risolvi errori comuni con la guida alla risoluzione dei problemi.
• Rivedi la guida alla sicurezza prima di esporre qualsiasi cosa.

• Hub della documentazione: docs/README.md
• TOC unificato dei docs: docs/SUMMARY.md
• Riferimento comandi: docs/reference/cli/commands-reference.md
• Riferimento configurazione: docs/reference/api/config-reference.md
• Riferimento provider: docs/reference/api/providers-reference.md
• Riferimento canali: docs/reference/api/channels-reference.md
• Runbook operativo: docs/ops/operations-runbook.md
• Risoluzione problemi: docs/ops/troubleshooting.md

• Guida alla contribuzione: CONTRIBUTING.md
• Politica del flusso di lavoro PR: docs/contributing/pr-workflow.md
• Guida al flusso di lavoro CI: docs/contributing/ci-map.md
• Manuale del revisore: docs/contributing/reviewer-playbook.md
• Politica di divulgazione della sicurezza: SECURITY.md
• Template della documentazione: docs/contributing/doc-template.md

• Guida alla distribuzione in rete: docs/ops/network-deployment.md
• Manuale dell'agente proxy: docs/ops/proxy-agent-playbook.md
• Guide hardware: docs/hardware/README.md

ZeroClaw è stato costruito per il granchio liscio 🦀, un assistente IA veloce ed efficiente. Costruito da Argenis De La Rosa e la comunità.

• zeroclawlabs.ai
• @zeroclawlabs

Se ZeroClaw ti aiuta nel lavoro e vuoi supportare lo sviluppo continuo, puoi donare qui:

Un sentito ringraziamento alle comunità e alle istituzioni che ispirano e alimentano questo lavoro open source:

• Harvard University — per alimentare la curiosità intellettuale e spingere i confini del possibile.
• MIT — per difendere la conoscenza aperta, l'open source e la convinzione che la tecnologia debba essere accessibile a tutti.
• Sundai Club — per la comunità, l'energia e la spinta instancabile a costruire cose che contano.
• Il Mondo e Oltre 🌍✨ — a ogni contributore, sognatore e costruttore che rende l'open source una forza per il bene. Questo è per te.

Stiamo costruendo apertamente perché le migliori idee vengono da ovunque. Se stai leggendo questo, ne fai parte. Benvenuto. 🦀❤️

Nuovo su ZeroClaw? Cerca le issue etichettate good first issue — consulta la nostra Guida alla contribuzione per sapere come iniziare. PR con IA/vibe-coded sono benvenuti! 🤖

Vedi CONTRIBUTING.md e CLA.md. Implementa un trait, invia un PR:

• Guida al flusso di lavoro CI: docs/contributing/ci-map.md
• Nuovo Provider → src/providers/
• Nuovo Channel → src/channels/
• Nuovo Observer → src/observability/
• Nuovo Tool → src/tools/
• Nuovo Memory → src/memory/
• Nuovo Tunnel → src/tunnel/
• Nuovo Peripheral → src/peripherals/
• Nuovo Skill → ~/.zeroclaw/workspace/skills/<name>/

Questo è l'unico repository ufficiale di ZeroClaw:

https://github.com/zeroclaw-labs/zeroclaw

Qualsiasi altro repository, organizzazione, dominio o pacchetto che affermi di essere "ZeroClaw" o implichi un'affiliazione con ZeroClaw Labs non è autorizzato e non è affiliato a questo progetto. I fork non autorizzati conosciuti saranno elencati in TRADEMARK.md.

Se incontri impersonificazione o uso improprio del marchio, per favore apri una issue.

ZeroClaw ha doppia licenza per massima apertura e protezione dei contributori:

Puoi scegliere una delle due licenze. I contributori concedono automaticamente diritti sotto entrambe — vedi CLA.md per l'accordo completo dei contributori.

Il nome e il logo di ZeroClaw sono marchi di ZeroClaw Labs. Questa licenza non concede il permesso di usarli per implicare approvazione o affiliazione. Vedi TRADEMARK.md per gli usi consentiti e proibiti.

• Mantieni il copyright delle tue contribuzioni
• Concessione di brevetti (Apache 2.0) ti protegge da rivendicazioni di brevetti di altri contributori
• Le tue contribuzioni sono permanentemente attribuite nella cronologia dei commit e NOTICE
• Nessun diritto di marchio viene trasferito contribuendo

ZeroClaw — Zero overhead. Zero compromessi. Distribuisci ovunque. Scambia qualsiasi cosa. 🦀

Questa lista è generata dal grafico dei contributori di GitHub e si aggiorna automaticamente.