Cum să instalezi ZeroClaw: Ghid rapid pentru începători pentru o alternativă ușoară la OpenClaw

De ce merită ZeroClaw să fie instalat

Dacă ai instalat vreodată un instrument AI, ai văzut binarele aterizând în “PATH”, și totuși nu ai avut nicio dovadă că ar putea accesa un model, înțelege spațiul de lucru sau răspunde în siguranță, înțelegi deja problema pe care o rezolvă acest ghid. O instalare finalizată doar dovedește că fișierele au fost copiate. Nu dovedește că runtime-ul agentului este utilizabil.

Aici devine interesant ZeroClaw. Este un runtime ușor pentru agent AI construit în jurul unui singur binar Rust, cu suport pentru furnizori de modele găzduiți în loc de o stivă locală grea din prima zi. În practică, asta înseamnă că este mai aproape de “un runtime controlat pentru utilizarea instrumentelor” decât de “un chatbot într-un terminal.” Pentru cititorii curioși despre unghiul “alternativă OpenClaw”, apelul practic nu este hype sau benchmark-uri. Este povestea de instalare mai ușoară, greutatea dependenței mai mică, și faptul că testarea pe un VPS Ubuntu se simte gestionabilă în loc să se transforme într-un proiect complet de infrastructură.

Acest articol rămâne strict focalizat pe un rezultat: instalează ZeroClaw, rulează “zeroclaw onboard”, verifică o primă sesiune CLI sigură, și pleci cu o idee realistă despre ce să încerci mai departe. Acesta este punctul de reper corect pentru o prezentare VPS prietenoasă pentru începători, deoarece “funcționează” ar trebui să însemne un răspuns prim înrădăcinat pe care îl poți verifica, nu o lungă prezentare de caracteristici.

📝 Notă: Acest ghid dovedește utilizarea CLI funcțională pentru prima dată. Nu este un ghid de implementare în producție și nu încearcă să acopere Docker, gateway-uri publice sau servicii de fundal

Ce este ZeroClaw — în limba engleză simplă

ZeroClaw se înțelege mai bine ca un runtime pentru agent decât ca “un chatbot AI.” Modelul este doar o parte a sistemului. ZeroClaw este stratul care conectează un cont furnizor, o alegere de model, un profil de agent și un spațiu de lucru delimitat, astfel încât instrumentul să poată face mai mult decât să răspundă la o singură solicitare izolată.

Cei patru termeni de mai jos sunt cei care contează cel mai mult în acest tutorial:

Ideea acelui spațiu de lucru contează mai mult decât sună. În acest articol, spațiul de lucru este camera în care agentul este permis să lucreze. De aceea instalarea ZeroClaw nu este același lucru cu configurarea ZeroClaw: binarele pot exista pe disc în timp ce furnizorul, modelul, alias-ul și spațiul de lucru sunt încă lipsă sau defect.

📝 Notă: O instalare reușită este doar jumătate din poveste. Punctul de reper semnificativ este o configurare funcțională sub ~/.zeroclaw care poate accesa un furnizor și opera în interiorul unui spațiu de lucru vizibil.

Aceasta este, de asemenea, cea mai curată modalitate de a explica de ce unii oameni privesc ZeroClaw ca o alternativă OpenClaw fără a forța o comparație completă. Valoarea nu este “OpenClaw rescris în Rust”, și acest ghid nu o tratează în acest fel. Valoarea este o poziție de auto-găzduire mai ușoară, flexibilitate furnizor și un runtime cu binar unic care este ușor de încercat pe un VPS.

Cazurile de utilizare bune pentru prima dată sunt la fel de înrădăcinate: rezumarea unei copii sigure de repo, explicarea unui fișier de configurare, gestionarea unei sarcini helper numai pentru citire în interiorul unui spațiu de lucru cu risc scăzut, sau utilizarea ca asistent delimitat pentru operatori care doresc vizibilitate înainte de a permite orice schimbări reale.

Înainte de instalare: linie de bază Ubuntu, condiții prealabile și siguranță

Înainte de a rula instalatorul, petrece un minut confirmând că VPS-ul este într-adevăr o potrivire bună pentru calea pe care o folosește acest articol. Cerințele minime sunt simple: acces SSH la un VPS Ubuntu, curl, un cont furnizor găzduit cu o cheie API și o mașină sau spațiu de lucru cu risc scăzut pentru prima sesiune.

Rulează mai întâi verificările de mai jos. În rularea de validare prezentată în capturi de ecran, au returnat Ubuntu 24.04.4 LTS (Noble Numbat), x86_64 și /usr/bin/curl. Asta este suficient pentru a confirma linia de bază a ghidului fără a pretinde că fiecare server va returna rezultate identice.

cat /etc/os-release

uname -m
command -v curl

Pentru exemplul furnizorului găzduit, OpenRouter este cea mai curată opțiune implicită deoarece ține prezentarea VPS-prietenoasă și evită configurarea modelului local pe server. Dacă folosești deja alt furnizor suportat, asta este bine, dar ai cheia API gata înainte ca zeroclaw onboard să înceapă să pună întrebări. Scopul aici este succes pentru prima dată, nu cumpărături de furnizor, deci o cale curată găzduită este mai bună decât încercarea de a evalua fiecare furnizor în aceeași ședință.

ZeroClaw suportă atât căi de instalare precompilate cât și din sursă. Gândește-te la ruta precompilată ca la un aparat gata făcut și la ruta sursă ca la un kit de construire-ți-singur. Ambele sunt legitime, dar servesc cititori diferiți. Pentru acest quickstart, lucrul important este să înțelegi diferența acum și să faci recomandarea reală în pasul de instalare.

⚠️ Avertisment: Folosește această listă de verificare pentru prima rulare înainte de a continua:

• rămâi într-un spațiu de lucru cu risc scăzut
• păstrează comportamentul implicit supervizat
• evită expunerea publică și datele de producție
• fă prima sarcină numai pentru citire în scop

Instalează ZeroClaw cu scriptul oficial

Cu preflight-ul din cale, folosește instalatorul oficial ca ruta principală. Aceasta este cea mai scurtă cale suportată pentru un quickstart VPS Ubuntu:

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

Pe această cale de instalare, scriptul rulează neinteractiv și ia calea versiunii precompilate automat. În rularea de validare pentru acest ghid, a detectat ținta Linux, a descărcat tarball-ul versiunii GitHub corespunzător, a verificat suma de control, a instalat activele web dashboard sub ~/.local/share/zeroclaw/web/dist și a plasat binarele zeroclaw în ~/.cargo/bin. Deoarece capturile de ecran au fost capturate din contul root, căile concrete prezentate sunt /root/.local/share/zeroclaw/web/dist, /root/.cargo/bin/zeroclaw și /root/.bashrc; pe un cont de utilizator obișnuit, așteptă același aspect sub propriul tău director home.

Acea cale rapidă nu este o scurtătură sau o instalare mai puțin oficială. Este ruta normală de quickstart pentru publicul pentru care este scris acest ghid: descarcă versiunea corespunzătoare, verifică-o și plasează binarele în ~/.cargo/bin/zeroclaw. Dacă intenționezi o construire din sursă, folosește ruta de clonare a repo-ului de mai jos în loc să aștepți ca acest flux de instalare să se oprească și să ofere o alegere de construire separată.

💡 Sfat: Pe Linux, cea mai frecventă problemă post-instalare este PATH, nu instalarea în sine. Urmează sugestia instalatorului de a adăuga export PATH=”$HOME/.cargo/bin:$PATH” la profilul tău shell și reîncarcă-l cu source ~/.bashrc (sau redeschide shell-ul). Dacă ai nevoie doar de o reparație temporară pentru sesiunea curentă, folosește exportul pe o singură linie prezentat mai jos.

După ce binarele sunt la locul lor, scriptul se termină cu un mesaj de confirmare neinteractiv în loc să lanseze configurarea automat. În rularea de validare pentru acest ghid, acel mesaj de închidere a indicat zeroclaw quickstart, dar binarele instalate “v0.7.5” au expus onboard ca subcomanda reală de configurare în zeroclaw –help. De asemenea, indică faptul că zeroclaw daemon este calea pentru daemon-ul mereu activ plus web dashboard în timp ce zeroclaw agent este calea chat CLI unică.

Pentru acest articol, continuă cu zeroclaw onboard mai departe. Asta ține prezentarea aliniată la promisiunea reală a articolului: prima sesiune de agent funcțională în terminal, nu cuplarea dashboard sau runtime mereu activ.

Dacă ești conștient de securitate și preferi să inspecționezi instalatorul înainte de a-l rula, folosește această abordare alternativă:

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

Înainte de a te gândi la furnizori sau solicitări, verifică că binarele sunt apelabile în shell:

zeroclaw --version

Dacă asta funcționează, instalarea în sine a reușit. Dacă shell-ul spune command not found, aplică reparația PATH temporară de mai jos și testează din nou:

export PATH="$HOME/.cargo/bin:$PATH"

Separarea acestui pas de configurare contează. Un zeroclaw –version funcțional îți spune că problema instalatorului este rezolvată înainte de a începe depanarea configurării furnizorului.

Rulează zeroclaw onboard și verifică ce a creat

Acesta este punctul în care “instalat” trebuie să devină “configurat”. Pe calea de instalare neinteractivă folosită mai sus, scriptul omite în mod explicit solicitarea de configurare. Dacă mesajul instalatorului menționează zeroclaw quickstart dar binarele nu o recunosc, încredință zeroclaw –help și pornește asistentul de configurare pentru prima dată cu:

zeroclaw onboard

Asistentul se deschide pe ecranul spațiului de lucru. În rularea capturată, calea implicită a spațiului de lucru era /root/.zeroclaw/workspace. Dacă nu ai un motiv puternic să o muți, acceptă implicit. Pe un cont non-root, același aspect va trăi sub propriul tău director home.

Pentru această prezentare CLI pentru începători, lasă profilurile multi-spațiu de lucru dezactivate. Activarea lor creează memorie separată, secrete și directoare de audit per angajament, care pot fi utile mai târziu, dar adaugă overhead mental suplimentar pentru un prim test de fum.

Pe ecranul furnizorului, alege OpenRouter. Lista este mult mai mare decât are nevoie un ghid pentru începători, ceea ce este exact de ce ajută să alegi o cale curată găzduită și să te ții de ea pentru prima rulare.

Lipește cheia ta API OpenRouter când ți se cere. Intrarea este ascunsă și solicitarea notează în mod explicit că ZeroClaw stochează secretul prin inelul de chei al SO atunci când este posibil în loc să te ceară să o codifici în config.toml.

Lista de modele OpenRouter este lungă. În rularea capturată, deepseek/deepseek-v4-pro a fost selectat. Poți alege alt model OpenRouter curent dacă preferi, dar restul acestei prezentări urmează acea selecție exactă.

Când asistentul întreabă despre setări avansate, lasă-le dezactivate pentru acest ghid. Activarea lor este pentru anulări țintite, cum ar fi temperatură, timeout, URL de bază sau protocol de sârmă.

Pe ecranul Canale, selectează Gata fără a adăuga Discord, Telegram, Slack sau orice altă suprafață externă. Asta ține prima validare numai CLI. Poți adăuga canale mai târziu odată ce calea agentului local funcționează.

Pentru memorie, alege SQLite cu Vector Search (recomandat). Este cea mai puternică opțiune implicită aici deoarece ține totul local în timp ce îți oferă în continuare suport pentru căutare hibridă și încorporări.

Lasă salvarea automată setată la Da pentru ca propriile tale solicitări să fie înregistrate ca istoric de conversație. Dacă mai târziu dorești control manual mai strict, poți dezactiva asta și salva memorie doar în mod explicit.

Lasă controlul hardware dezactivat. Această configurare VPS nu are nevoie de GPIO, plăci legate prin USB sau sonde de depanare.

Pentru furnizorul de tunel public, ține-l la niciunul. Asta se potrivește cu poziția de siguranță a acestui articol: nicio expunere publică în timpul primului test de fum.

Când pasul Personalitate spune că este deja configurat, lasă Reconfigurare? la Nu. Personalitatea implicită este suficientă pentru validarea pentru prima dată.

Ceea ce contează aici nu este memorarea fiecărui panou al asistentului. Ceea ce contează este calea pe care o dovedesc capturile de ecran: spațiu de lucru unic, furnizor OpenRouter, intrare cheie API ascunsă, o alegere de model concretă, fără anulări avansate, fără canale suplimentare, memorie SQLite locală, salvare automată activată, hardware dezactivat și fără tunel public. Asta este mai mult decât suficient pentru a produce o configurație CLI utilizabilă pentru prima dată sub ~/.zeroclaw.

După ce onboarding-ul se termină, confirmă că directorul de configurare principal și spațiul de lucru există:

Dacă rularea de onboarding se completează curat, ar trebui să cazi înapoi la shell cu un mesaj de configurare încărcat ca cel de mai jos:

ls ~/.zeroclaw
ls ~/.zeroclaw/workspace

În rularea capturată, ~/.zeroclaw conținea config.toml și workspace/, iar spațiul de lucru în sine a arătat IDENTITY.md și SOUL.md.

Asta este deja suficient pentru a dovedi că ZeroClaw are acum o cameră de operare, nu doar un binar instalat. De aceea analogia spațiului de lucru este utilă: verifici că camera există, că agentul are context în interiorul ei și că configurarea a trecut dincolo de “instalatorul s-a terminat.” Fișiere cum ar fi IDENTITY.md și SOUL.md nu sunt decorative. Sunt parte din contextul pe care ZeroClaw îl folosește pentru a înțelege cum ar trebui să se comporte în interiorul acelui spațiu de lucru.

Înainte de prima solicitare live, rulează o verificare de sănătate compactă:

zeroclaw status

zeroclaw doctor

Pentru acest prim test de fum CLI-doar, nu panica dacă zeroclaw doctor nu este perfect curat. În rularea capturată, verificările importante au trecut: fișierul de configurare a fost găsit, furnizorul openrouter era valid, cheia API a fost configurată, modelul implicit a fost setat și spațiul de lucru exista și era scris.

Avertismentele și erorile rămase nu sunt critice pentru un chat terminal: “niciun canal configurat” este așteptat deoarece prezentarea a omis în mod intenționat Discord, Telegram și alte canale externe; AGENTS.md nu a fost găsit (opțional) este în mod explicit non-blocare; daemon_state.json nu a fost găsit doar înseamnă că daemon-ul mereu activ nu rulează încă; și plângerea listării modelelor live OpenRouter este mai bine citită ca o limitare a sondei decât dovadă că configurarea furnizorului a eșuat, mai ales pentru că ieșirea raportează în continuare openrouter: 344 modele.

grep -E 'default_provider|default_model|[agents.|[risk_profiles.' ~/.zeroclaw/config.toml

Semnalul de succes aici este operațional, nu cosmetic. zeroclaw status este cea mai clară sursă de adevăr pentru rezumatul runtime-ului activ, zeroclaw doctor îți spune dacă ceva important este rupt și ieșirea grep este mai bine tratată ca o privire aproximativă la intrările de configurare legate de furnizor/model decât una perfectă. Așteptă-te ca formularea și potrivirile exacte să varieze în funcție de versiune. Nu cauți un perete perfect de text verde. Cauți absența blocajelor pentru prima rulare și prezența datelor de configurare reale.

📝 Notă: config.toml poate să nu-ți arate cheia API în text clar. Asta poate fi normal. În rularea de onboarding capturată, solicitarea cheii API a spus în mod explicit că secretul ar fi stocat prin inelul de chei al SO atunci când este posibil, deci “nicio cheie vizibilă în fișierul TOML” nu este același lucru cu “configurarea a eșuat.”

Pornește primul chat CLI sigur

Cu configurația și spațiul de lucru la locul lor, lansează agentul în modul interactiv:

zeroclaw agent

În rularea capturată, ZeroClaw a încărcat configurația, a inițializat memorie cu suport SQLite, a tipărit bannerul modului interactiv și a căzut la solicitarea >. Scopul nu este să pornești o demonstrație strălucitoare. Scopul este să dovedești conectivitate end-to-end, configurare validă și conștientizare a spațiului de lucru înrădăcinat într-un singur pas cu risc scăzut. Un test numai pentru citire îți dă semnale mult mai utile în această etapă decât o solicitare “uite ce poate face” cu capacitate de scriere.

Pentru prima solicitare, folosește această verificare exactă numai pentru citire:

tell me your current workspace path, list the top-level files you can see there, and briefly explain what each one is for. Do not create, edit, or delete anything.

Deoarece runtime-ul este în modul supervizat, primul răspuns util poate necesita o aprobare a instrumentului. În rularea capturată, ZeroClaw a cerut să execute o comandă shell numai pentru citire: “pwd && echo “—-” && ls -la”

Asta este exact tipul de comandă pe care o dorești pentru acest test de fum: tipărește calea spațiului de lucru și listează conținutul de nivel superior fără a schimba nimic. Aprobă-o cu Y pentru un da unic. De asemenea, ai putea o nega cu N, dar atunci agentul ar pierde cea mai ușoară modalitate de a răspunde din starea reală a sistemului de fișiere în loc să ghicească.

📝 Notă:De asemenea, poți vedea un avertisment de urmărire a costurilor pentru modelul OpenRouter selectat înainte de solicitarea de aprobare. În rularea capturată, ZeroClaw a avertizat că nicio intrare de preț nu a fost definită pentru openrouter/deepseek/deepseek-v4-pro. Asta nu blochează chat-ul în sine. Doar înseamnă că utilizarea token-ului poate fi înregistrată cu cost zero până când definești preț model în mod explicit.

Această solicitare este puternică deoarece testează trei lucruri deodată. În primul rând, ZeroClaw trebuie să ajungă la furnizor și să obțină un răspuns înapoi. În al doilea rând, agentul trebuie să înțeleagă spațiul de lucru configurat. În al treilea rând, răspunsul trebuie să fie specific suficient pentru a-l compara cu ceea ce este de fapt pe disc. Cu alte cuvinte, asta dovedește că agentul rămâne în camera pe care i-a fost dată.

Un bun prim răspuns ar trebui să îndeplinească patru condiții:

• nicio autentificare sau erori de furnizor
• nicio “configurare nu a fost găsită” sau eșecuri de model lipsă
• calea corectă a spațiului de lucru apare în răspuns
• fișierele reale de nivel superior sunt numite, fără nicio pretenție că ceva a fost schimbat

Dacă dorești o modalitate diferită de a invoca agentul, poți trimite aceeași solicitare ca o comandă unică în loc să rămâi în sesiunea interactivă. Tratează asta ca opțional, nu ca ruta principală a prezentării. Calea interactivă este încă o experiență mai bună pentru prima dată deoarece face runtime-ul să se simtă observabil în loc de magic.

zeroclaw agent -m "tell me your current workspace path, list the top-level files you can see there, and briefly explain what each one is for. Do not create, edit, or delete anything."

Ce să faci mai departe odată ce ZeroClaw funcționează

Mișcarea corectă următoare nu este să activezi fiecare caracteristică pe care o poți găsi. Este să adaugi un strat controlat la o dată, deci știi întotdeauna ce schimbare a introdus risc nou sau fricțiune nouă.

💡 Sfat: Odată ce primul chat sigur funcționează, păstrează aceeași disciplină pentru faza următoare. Treci la o copie sigură de repo sau director de note mai întâi, ține sarcinile numai pentru citire unde este posibil și extinde privilegiile doar după ce fluxul de lucru de bază se simte previzibil.

Sarcinile bune de urmărire sunt plictisitoare în scop: rezumă un README, explică un fișier de configurare sau listează idei de curățare fără a schimba nimic. Acel tip de muncă este semnal înalt deoarece folosește același runtime pe care tocmai l-ai validat, dar nu te forțează în acces de scriere înainte de a încredința instrumentul. Dacă dorești un spațiu de lucru real mai bun pentru prima dată, folosește o copie sigură de repo, un director de note de staging sau un mic folder de documente interne în loc de ceva orientat spre producție.

Pașii buni următori, în ordine, arată așa:

• indică ZeroClaw la o copie sigură de repo sau director de note
• încearcă o sarcină helper numai pentru citire
• compară furnizori doar după ce fluxul de lucru de bază se simte stabil
• uită-te la servicii, canale sau Docker mai târziu ca proiecte separate

Dacă dorești să compari furnizori mai târziu, fă asta după ce fluxul de lucru de bază este stabil. Dacă dorești pasul de infrastructură următor după succes CLI, acestea sunt comenzile care merită cunoscute:

zeroclaw service install
zeroclaw service start
zeroclaw service status

Asta este punctul în care acest articol ar trebui să se oprească și următorul subiect ar trebui să înceapă. Gestionarea serviciilor, implementarea Docker, gateway-uri publice, canale de mesagerie și hardening de securitate mai profund merită propriile prezentări.

Dacă acest prim test de f