🦀 ZeroClaw — Asistent AI Personal

Zero overhead. Zero compromisuri. 100% Rust. 100% Agnostic.
⚡️ Rulează pe hardware de $10 cu <5MB RAM: Cu 99% mai puțină memorie decât OpenClaw și cu 98% mai ieftin decât un Mac mini!

Construit de studenți și membri ai comunităților Harvard, MIT și Sundai.Club.

🌐 Limbi: 🇺🇸 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 este un asistent AI personal pe care îl rulezi pe propriile dispozitive. Îți răspunde pe canalele pe care le folosești deja (WhatsApp, Telegram, Slack, Discord, Signal, iMessage, Matrix, IRC, Email, Bluesky, Nostr, Mattermost, Nextcloud Talk, DingTalk, Lark, QQ, Reddit, LinkedIn, Twitter, MQTT, WeChat Work și altele). Are un panou web pentru control în timp real și se poate conecta la periferice hardware (ESP32, STM32, Arduino, Raspberry Pi). Gateway-ul este doar planul de control — produsul este asistentul.

Dacă vrei un asistent personal, pentru un singur utilizator, care se simte local, rapid și mereu activ, acesta este.

Site web · Documentație · Arhitectură · Începe · Migrare de la OpenClaw · Depanare · Discord

Configurare recomandată: rulează zeroclaw onboard în terminalul tău. ZeroClaw Onboard te ghidează pas cu pas prin configurarea gateway-ului, workspace-ului, canalelor și provider-ului. Este calea de configurare recomandată și funcționează pe macOS, Linux și Windows (prin WSL2). Instalare nouă? Începe aici: Începe

• OpenAI Codex (abonament ChatGPT)
• Gemini (Google OAuth)
• Anthropic (cheie API sau token de autentificare)

Notă despre modele: deși sunt suportate multe provider-e/modele, pentru cea mai bună experiență folosește cel mai puternic model de ultimă generație disponibil. Vezi Onboarding.

Configurare modele + CLI: Referință Providers Rotație profil de autentificare (OAuth vs chei API) + failover: Failover model

Runtime: Rust stable toolchain. Binar unic, fără dependențe de runtime.

brew install zeroclaw

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

zeroclaw onboard rulează automat după instalare pentru a configura workspace-ul și provider-ul.

Ghid complet pentru începători (autentificare, asociere, canale): Începe

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

# Pornește gateway-ul (server webhook + panou web)
zeroclaw gateway                # implicit: 127.0.0.1:42617
zeroclaw gateway --port 0       # port aleatoriu (securitate îmbunătățită)

# Vorbește cu asistentul
zeroclaw agent -m "Hello, ZeroClaw!"

# Mod interactiv
zeroclaw agent

# Pornește runtime-ul autonom complet (gateway + canale + cron + hands)
zeroclaw daemon

# Verifică starea
zeroclaw status

# Rulează diagnostice
zeroclaw doctor

Actualizezi? Rulează zeroclaw doctor după actualizare.

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

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

zeroclaw onboard

Alternativă dev (fără instalare globală): prefixează comenzile cu cargo run --release -- (exemplu: cargo run --release -- status).

ZeroClaw poate importa workspace-ul, memoria și configurația OpenClaw:

# Previzualizează ce va fi migrat (sigur, doar citire)
zeroclaw migrate openclaw --dry-run

# Rulează migrarea
zeroclaw migrate openclaw

Aceasta migrează intrările de memorie, fișierele workspace și configurația din ~/.openclaw/ în ~/.zeroclaw/. Configurația este convertită automat din JSON în TOML.

ZeroClaw se conectează la suprafețe de mesagerie reale. Tratează DM-urile primite ca intrare neîncredere.

Ghid complet de securitate: SECURITY.md

Comportament implicit pe toate canalele:

• Asociere DM (implicit): expeditorii necunoscuți primesc un cod scurt de asociere și bot-ul nu procesează mesajul lor.
• Aprobă cu: zeroclaw pairing approve <channel> <code> (apoi expeditorul este adăugat pe o listă de permisiuni locală).
• DM-urile publice primite necesită un opt-in explicit în config.toml.
• Rulează zeroclaw doctor pentru a identifica politici DM riscante sau configurate greșit.

Niveluri de autonomie:

Straturi de sandboxing: izolarea workspace-ului, blocarea traversării căilor, liste de permisiuni pentru comenzi, căi interzise (/etc, /root, ~/.ssh), limitare de rată (acțiuni maxime/oră, limite de cost/zi).

Folosește acest panou pentru notificări importante (schimbări care rup compatibilitatea, avize de securitate, ferestre de mentenanță și blocaje de lansare).

• Runtime ușor implicit — fluxurile comune CLI și de stare rulează într-un plic de memorie de câțiva megabytes pe build-urile de lansare.
• Implementare eficientă din punct de vedere al costurilor — proiectat pentru plăci de $10 și instanțe cloud mici, fără dependențe runtime grele.
• Porniri la rece rapide — runtime-ul Rust cu binar unic menține pornirea comenzilor și daemon-ului aproape instantanee.
• Arhitectură portabilă — un singur binar pe ARM, x86 și RISC-V cu provider-e/canale/instrumente interschimbabile.
• Gateway local-first — plan de control unic pentru sesiuni, canale, instrumente, cron, SOP-uri și evenimente.
• Inbox multi-canal — WhatsApp, Telegram, Slack, Discord, Signal, iMessage, Matrix, IRC, Email, Bluesky, Nostr, Mattermost, Nextcloud Talk, DingTalk, Lark, QQ, Reddit, LinkedIn, Twitter, MQTT, WeChat Work, WebSocket și altele.
• Orchestrare multi-agent (Hands) — roiuri de agenți autonomi care rulează programat și devin mai inteligenți în timp.
• Proceduri Operaționale Standard (SOP-uri) — automatizare de fluxuri de lucru bazată pe evenimente cu MQTT, webhook, cron și declanșatoare periferice.
• Panou Web — UI web React 19 + Vite cu chat în timp real, browser de memorie, editor de configurare, manager cron și inspector de instrumente.
• Periferice hardware — ESP32, STM32 Nucleo, Arduino, Raspberry Pi GPIO prin trait-ul Peripheral.
• Instrumente de primă clasă — shell, file I/O, browser, git, web fetch/search, MCP, Jira, Notion, Google Workspace și 70+ altele.
• Hook-uri de ciclu de viață — interceptează și modifică apelurile LLM, execuțiile de instrumente și mesajele la fiecare etapă.
• Platformă de skill-uri — skill-uri incluse, comunitare și de workspace cu audit de securitate.
• Suport tunnel — Cloudflare, Tailscale, ngrok, OpenVPN și tuneluri personalizate pentru acces la distanță.

• Ușor implicit: binar Rust mic, pornire rapidă, amprentă de memorie redusă.
• Sigur prin design: asociere, sandboxing strict, liste de permisiuni explicite, limitarea workspace-ului.
• Complet interschimbabil: sistemele de bază sunt trait-uri (provider-e, canale, instrumente, memorie, tuneluri).
• Fără lock-in: suport provider compatibil OpenAI + endpoint-uri personalizate conectabile.

Benchmark rapid pe mașină locală (macOS arm64, feb 2026) normalizat pentru hardware edge 0.8GHz.

Note: Rezultatele ZeroClaw sunt măsurate pe build-uri de lansare folosind /usr/bin/time -l. OpenClaw necesită runtime Node.js (de obicei ~390MB overhead suplimentar de memorie), în timp ce NanoBot necesită runtime Python. PicoClaw și ZeroClaw sunt binare statice. Cifrele RAM de mai sus sunt memorie runtime; cerințele de compilare în timpul build-ului sunt mai mari.

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

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

• Plan de control HTTP/WS/SSE Gateway cu sesiuni, prezență, configurare, cron, webhook-uri, panou web și asociere.
• Suprafață CLI: gateway, agent, onboard, doctor, status, service, migrate, auth, cron, channel, skills.
• Buclă de orchestrare agent cu dispatch de instrumente, construcție de prompt, clasificare de mesaje și încărcare de memorie.
• Model de sesiune cu aplicarea politicii de securitate, niveluri de autonomie și aprobare condiționată.
• Wrapper provider rezilient cu failover, reîncercare și rutare de modele pe 20+ backend-uri LLM.

Canale: WhatsApp (nativ), 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.

Feature-gated: Matrix (channel-matrix), Lark (channel-lark), Nostr (channel-nostr).

Panou web React 19 + Vite 6 + Tailwind CSS 4 servit direct din Gateway:

• Dashboard — prezentare generală a sistemului, stare de sănătate, uptime, urmărire costuri
• Agent Chat — chat interactiv cu agentul
• Memory — navighează și gestionează intrările de memorie
• Config — vizualizează și editează configurația
• Cron — gestionează sarcinile programate
• Tools — navighează instrumentele disponibile
• Logs — vizualizează jurnalele de activitate ale agentului
• Cost — utilizarea token-urilor și urmărirea costurilor
• Doctor — diagnostice de sănătate a sistemului
• Integrations — starea integrărilor și configurare
• Pairing — gestionarea asocierii dispozitivelor

• De bază: shell, file read/write/edit, operații git, glob search, content search
• Web: browser control, web fetch, web search, screenshot, image info, PDF read
• Integrări: Jira, Notion, Google Workspace, Microsoft 365, LinkedIn, Composio, Pushover
• MCP: Model Context Protocol tool wrapper + deferred tool sets
• Programare: cron add/remove/update/run, schedule tool
• Memorie: recall, store, forget, knowledge, project intel
• Avansat: delegate (agent-la-agent), swarm, model switch/routing, security ops, cloud ops
• Hardware: board info, memory map, memory read (feature-gated)

• Niveluri de autonomie: ReadOnly, Supervised (implicit), Full.
• Sandboxing: izolarea workspace-ului, blocarea traversării căilor, liste de permisiuni pentru comenzi, căi interzise, Landlock (Linux), Bubblewrap.
• Limitare de rată: acțiuni maxime pe oră, cost maxim pe zi (configurabil).
• Aprobare condiționată: aprobare interactivă pentru operațiuni de risc mediu/ridicat.
• E-stop: capacitate de oprire de urgență.
• 129+ teste de securitate în CI automatizat.

• Panou web servit direct din Gateway.
• Suport tunnel: Cloudflare, Tailscale, ngrok, OpenVPN, comandă personalizată.
• Adaptor runtime Docker pentru execuție containerizată.
• CI/CD: beta (automat la push) → stable (dispatch manual) → Docker, crates.io, Scoop, AUR, Homebrew, tweet.
• Binare pre-construite pentru Linux (x86_64, aarch64, armv7), macOS (x86_64, aarch64), Windows (x86_64).

Minimal ~/.zeroclaw/config.toml:

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

Referință completă de configurare: 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"  # sau "tailscale", "ngrok", "openvpn", "custom", "none"

Detalii: Referință canale · Referință configurare

• native (implicit) — execuție directă a procesului, cea mai rapidă cale, ideală pentru medii de încredere.
• docker — izolare completă în container, politici de securitate aplicate, necesită Docker.

Setează runtime.kind = "docker" pentru sandboxing strict sau izolare de rețea.

ZeroClaw suportă profiluri de autentificare native abonament (multi-cont, criptate în repaus).

• Fișier de stocare: ~/.zeroclaw/auth-profiles.json
• Cheie de criptare: ~/.zeroclaw/.secret_key
• Format id profil: <provider>:<profile_name> (exemplu: openai-codex:work)

# OpenAI Codex OAuth (abonament 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

# Verifică / reîmprospătează / schimbă profilul
zeroclaw auth status
zeroclaw auth refresh --provider openai-codex --profile default
zeroclaw auth use --provider openai-codex --profile work

# Rulează agentul cu autentificare prin abonament
zeroclaw agent --provider openai-codex -m "hello"
zeroclaw agent --provider anthropic -m "hello"

Rădăcina workspace: ~/.zeroclaw/workspace/ (configurabilă prin config).

Fișiere prompt injectate:

• IDENTITY.md — personalitatea și rolul agentului
• USER.md — contextul și preferințele utilizatorului
• MEMORY.md — fapte și lecții pe termen lung
• AGENTS.md — convenții de sesiune și reguli de inițializare
• SOUL.md — identitate de bază și principii operaționale

Skill-uri: ~/.zeroclaw/workspace/skills/<skill>/SKILL.md sau SKILL.toml.

# Listează skill-urile instalate
zeroclaw skills list

# Instalează din git
zeroclaw skills install https://github.com/user/my-skill.git

# Audit de securitate înainte de instalare
zeroclaw skills audit https://github.com/user/my-skill.git

# Elimină un skill
zeroclaw skills remove my-skill

# Gestionarea workspace-ului
zeroclaw onboard              # Asistent de configurare ghidată
zeroclaw status               # Afișează starea daemon/agent
zeroclaw doctor               # Rulează diagnostice de sistem

# Gateway + daemon
zeroclaw gateway              # Pornește serverul gateway (127.0.0.1:42617)
zeroclaw daemon               # Pornește runtime-ul autonom complet

# Agent
zeroclaw agent                # Mod chat interactiv
zeroclaw agent -m "message"   # Mod mesaj unic

# Gestionarea serviciilor
zeroclaw service install      # Instalează ca serviciu OS (launchd/systemd)
zeroclaw service start|stop|restart|status

# Canale
zeroclaw channel list         # Listează canalele configurate
zeroclaw channel doctor       # Verifică sănătatea canalelor
zeroclaw channel bind-telegram 123456789

# Cron + programare
zeroclaw cron list            # Listează sarcinile programate
zeroclaw cron add "*/5 * * * *" --prompt "Check system health"
zeroclaw cron remove <id>

# Memorie
zeroclaw memory list          # Listează intrările de memorie
zeroclaw memory get <key>     # Recuperează o memorie
zeroclaw memory stats         # Statistici memorie

# Profiluri de autentificare
zeroclaw auth login --provider <name>
zeroclaw auth status
zeroclaw auth use --provider <name> --profile <profile>

# Periferice hardware
zeroclaw hardware discover    # Scanează dispozitivele conectate
zeroclaw peripheral list      # Listează perifericele conectate
zeroclaw peripheral flash     # Încarcă firmware pe dispozitiv

# Migrare
zeroclaw migrate openclaw --dry-run
zeroclaw migrate openclaw

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

Referință completă comenzi: 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

Resursele de lansare sunt publicate pentru:

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

Descarcă cele mai recente resurse de la: https://github.com/zeroclaw-labs/zeroclaw/releases/latest

Folosește-le când ai trecut de fluxul de onboarding și vrei referința mai detaliată.

• Începe cu indexul documentației pentru navigare și „ce este unde."
• Citește prezentarea arhitecturii pentru modelul complet al sistemului.
• Folosește referința de configurare când ai nevoie de fiecare cheie și exemplu.
• Rulează Gateway-ul conform runbook-ului operațional.
• Urmează ZeroClaw Onboard pentru configurare ghidată.
• Depanează eșecurile comune cu ghidul de depanare.
• Revizuiește ghidul de securitate înainte de a expune ceva.

• Hub documentație: docs/README.md
• TOC documentație unificată: docs/SUMMARY.md
• Referință comenzi: docs/reference/cli/commands-reference.md
• Referință configurare: docs/reference/api/config-reference.md
• Referință providers: docs/reference/api/providers-reference.md
• Referință canale: docs/reference/api/channels-reference.md
• Runbook operațional: docs/ops/operations-runbook.md
• Depanare: docs/ops/troubleshooting.md

• Ghid de contribuție: CONTRIBUTING.md
• Politica fluxului de lucru PR: docs/contributing/pr-workflow.md
• Ghid flux de lucru CI: docs/contributing/ci-map.md
• Playbook recenzent: docs/contributing/reviewer-playbook.md
• Politica de divulgare a securității: SECURITY.md
• Șablon documentație: docs/contributing/doc-template.md

• Ghid de implementare în rețea: docs/ops/network-deployment.md
• Playbook proxy agent: docs/ops/proxy-agent-playbook.md
• Ghiduri hardware: docs/hardware/README.md

ZeroClaw a fost construit pentru smooth crab 🦀, un asistent AI rapid și eficient. Construit de Argenis De La Rosa și comunitate.

• zeroclawlabs.ai
• @zeroclawlabs

Dacă ZeroClaw te ajută în muncă și vrei să susții dezvoltarea continuă, poți dona aici:

Mulțumiri sincere comunităților și instituțiilor care inspiră și alimentează această muncă open-source:

• Harvard University — pentru cultivarea curiozității intelectuale și extinderea limitelor posibilului.
• MIT — pentru promovarea cunoștințelor deschise, open source și credința că tehnologia ar trebui să fie accesibilă tuturor.
• Sundai Club — pentru comunitate, energie și dorința neîncetată de a construi lucruri care contează.
• Lumea și Dincolo 🌍✨ — fiecărui contributor, visător și constructor care face din open source o forță a binelui. Aceasta este pentru voi.

Construim deschis pentru că cele mai bune idei vin de peste tot. Dacă citești asta, faci parte din asta. Bine ai venit. 🦀❤️

Nou la ZeroClaw? Caută probleme etichetate good first issue — vezi Ghidul de Contribuție pentru cum să începi. PR-urile create cu AI/vibe-coded sunt binevenite! 🤖

Vezi CONTRIBUTING.md și CLA.md. Implementează un trait, trimite un PR:

• Ghid flux de lucru CI: docs/contributing/ci-map.md
• Provider nou → src/providers/
• Channel nou → src/channels/
• Observer nou → src/observability/
• Tool nou → src/tools/
• Memory nou → src/memory/
• Tunnel nou → src/tunnel/
• Peripheral nou → src/peripherals/
• Skill nou → ~/.zeroclaw/workspace/skills/<name>/

Acesta este singurul depozit oficial ZeroClaw:

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

Orice alt depozit, organizație, domeniu sau pachet care pretinde a fi „ZeroClaw" sau implică afiliere cu ZeroClaw Labs este neautorizat și nu este afiliat cu acest proiect. Fork-urile neautorizate cunoscute vor fi listate în TRADEMARK.md.

Dacă întâmpini uzurpare de identitate sau utilizare abuzivă a mărcii comerciale, te rugăm deschide o problemă.

ZeroClaw este dual-licențiat pentru deschidere maximă și protecția contributorilor:

Poți alege oricare licență. Contributorii acordă automat drepturi sub ambele — vezi CLA.md pentru acordul complet al contributorului.

Numele și logo-ul ZeroClaw sunt mărci comerciale ale ZeroClaw Labs. Această licență nu acordă permisiunea de a le folosi pentru a implica aprobare sau afiliere. Vezi TRADEMARK.md pentru utilizări permise și interzise.

• Păstrezi drepturile de autor ale contribuțiilor tale
• Acordarea de brevete (Apache 2.0) te protejează de revendicări de brevete ale altor contributori
• Contribuțiile tale sunt atribuite permanent în istoricul commit-urilor și NOTICE
• Nu se transferă drepturi de marcă comercială prin contribuție

ZeroClaw — Zero overhead. Zero compromisuri. Implementează oriunde. Schimbă orice. 🦀

Această listă este generată din graficul contributorilor GitHub și se actualizează automat.