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

De ce merită să instalezi ZeroClaw

Dacă ai instalat vreodată un instrument AI, ai văzut binarele ajungâ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ță, deja înțelegi 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ăzduite în loc de o stivă locală grea din prima zi. În practică, asta înseamnă că este mai apropiat de “un runtime controlat de utilizare a 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 instalării mai ușoare, 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 concentrat pe un singur rezultat: instalează ZeroClaw, rulează “zeroclaw onboard”, verifică o primă sesiune CLI sigură, și pleacă cu o idee realistă despre ce să încerci mai departe. Acesta este jaloanul corect pentru o prezentare VPS prietenoasă pentru începători, pentru că “funcțional” ar trebui să însemne un răspuns inițial fundamentat pe care să-l poți verifica, nu o lungă prezentare de caracteristici.

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

Ce este ZeroClaw — explicat simplu

ZeroClaw se înțelege mai bine ca un agent runtime decât ca “un chatbot AI”. Modelul este doar o parte a sistemului. ZeroClaw este stratul care conectează un cont de furnizor, o alegere de model, un profil de agent și un workspace 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 de workspace contează mai mult decât sună. În acest articol, workspace-ul este camera în care agentul are permisiunea să lucreze. De aceea instalarea ZeroClaw nu este același lucru cu configurarea ZeroClaw: binarului poate exista pe disc în timp ce furnizorul, modelul, aliasul și workspace-ul sunt încă lipsă sau conectați greșit.

📝 Notă: O instalare reușită este doar jumătate din poveste. Piatra de hotar semnificativă este o configurație funcțională sub ~/.zeroclaw care poate ajunge la un furnizor și să opereze în interiorul unui workspace vizibil.

Aceasta este, de asemenea, cel mai curat mod 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 felul acesta. Valoarea este o postură 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 sunt la fel de bine fundamentate: rezumarea unei copii sigure de repo, explicarea unui fișier de configurare, gestionarea unei sarcini auxiliare numai pentru citire în interiorul unui workspace cu risc scăzut, sau utilizarea acestuia ca asistent delimitat pentru operatori care doresc vizibilitate înainte de a permite orice modificări reale.

Înainte de instalare: linia de bază Ubuntu, cerințe preliminare și siguranță

Înainte de a rula instalatorul, petrece un minut confirmând că VPS este într-adevăr o alegere bună pentru calea pe care o folosește acest articol. Cerințele minime sunt simple: acces SSH la un VPS Ubuntu, curl, un cont la un 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, acestea au returnat Ubuntu 24.04.4 LTS (Noble Numbat), x86_64, și /usr/bin/curl. Aceasta 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ă alegere implicită, deoarece menține ghidul VPS-friendly și evită configurarea modelului local pe server. Dacă folosești deja un alt furnizor acceptat, este în regulă, dar pregătește cheia API înainte ca zeroclaw onboard să înceapă să pună întrebări. Scopul aici este primul succes, nu cumpărături de furnizor, deci o cale curată și găzduită este mai bună decât încercarea de a evalua fiecare furnizor în aceeași ședință.

ZeroClaw acceptă 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 din sursă ca la un kit de construire-ți-singur. Ambele sunt legitime, dar servesc cititori diferiți. Pentru acest ghid rapid, lucrul important este să înțelegi diferența acum și să faci recomandarea efectivă î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 supervizat implicit
• evită expunerea publică și datele de producție
• fă prima sarcină doar pentru citire în mod intenționat

Instalați ZeroClaw cu scriptul oficial

Cu verificarea preliminară finalizată, utilizați instalatorul oficial ca cale principală. Aceasta este cea mai scurtă rută acceptată pentru o pornire rapidă Ubuntu VPS:

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

Pe această cale de instalare, scriptul se execută non-interactiv și ia automat calea versiunii pre-construite. În execuția de validare pentru acest ghid, a detectat ținta Linux, a descărcat tarball-ul versiunii GitHub corespunzătoare, a verificat suma de control, a instalat activele tabloului de bord web sub ~/.local/share/zeroclaw/web/dist, și a plasat binarul zeroclaw în ~/.cargo/bin. Deoarece capturile de ecran au fost realizate din contul root, căile concrete afișate sunt /root/.local/share/zeroclaw/web/dist, /root/.cargo/bin/zeroclaw, și /root/.bashrc; pe un cont de utilizator obișnuit, așteptați aceeași structură în propriul dvs. director home.

Acea cale rapidă nu este o scurtătură sau o instalare mai puțin oficială. Este ruta normală de pornire rapidă pentru audiența pentru care este scris acest ghid: descărcați versiunea corespunzătoare, verificați-o, și plasați binarul în ~/.cargo/bin/zeroclaw. Dacă doriți intenționat o construire din sursă, utilizați în schimb calea de clonare a depozitorului de mai jos, în loc să vă așteptaț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. Urmați sugestia instalatorului pentru a adăuga export PATH=”$HOME/.cargo/bin:$PATH” la profilul dvs. shell și reîncărcați-l cu source ~/.bashrc (sau redeschideți shell-ul). Dacă aveți nevoie doar de o reparație temporară pentru sesiunea curentă, utilizați exportul pe o linie prezentat mai jos.

După ce binarul este în loc, scriptul se termină cu un mesaj de confirmare non-interactiv în loc să lanseze configurarea automat. În execuția de validare pentru acest ghid, acel mesaj de închidere a indicat zeroclaw quickstart, dar binarul instalat “v0.7.5” a expus onboard ca subcomanda de configurare reală în zeroclaw –help. De asemenea, indică faptul că zeroclaw daemon este calea pentru daemon-ul permanent plus tabloul de bord web, în timp ce zeroclaw agent este calea chat CLI o singură dată.

Pentru acest articol, continuați cu zeroclaw onboard în continuare. Aceasta ține pasul cu promisiunea reală a articolului: prima sesiune de agent funcțională în terminal, nu asocierea tabloului de bord sau runtime-ul permanent.

Dacă sunteți conștient de securitate și preferați să inspectați instalatorul înainte de a-l executa, utilizați această abordare alternativă:

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

Înainte de a vă gândi la furnizori sau solicitări, verificați că binarul este apelabil în shell:

zeroclaw --version

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

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

Separarea acestui pas de configurare este importantă. Un zeroclaw –version funcțional vă 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 non-interactivă folosită mai sus, scriptul omite în mod explicit promptul de configurare. Dacă mesajul instalatorului menționează zeroclaw quickstart dar binarului nu-l recunoaște, ai încredere în zeroclaw –help și pornește vrăjitorul de primă rulare cu:

zeroclaw onboard

Vrăjitorul se deschide pe ecranul workspace-ului. În rularea capturată, calea workspace-ului implicit era /root/.zeroclaw/workspace. Dacă nu ai un motiv puternic să o muți, acceptă cea implicită. Pe un cont non-root, aceeași structură va fi în directorul tău home.

Pentru această introducere CLI pentru începători, lasă profilurile multi-workspace dezactivate. Activarea lor creează directoare separate de memorie, secrete și audit per angajament, ceea ce poate fi util mai târziu, dar adaugă complexitate mentală suplimentară pentru un prim test de funcționare.

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

Lipește cheia ta API OpenRouter când ți se cere. Intrarea este ascunsă, iar promptul notează în mod explicit că ZeroClaw stochează secretul prin inelul OS atunci când este posibil, în loc să te ceară să-l 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 actual dacă preferi, dar restul acestui ghid urmează exact această selecție.

Când vrăjitorul te î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 transmisie.

Pe ecranul Canale, selectează Gata fără a adăuga Discord, Telegram, Slack sau alte suprafețe externe. Asta ține prima validare doar 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 pentru că ține totul local, oferind în același timp suport pentru căutare hibridă și embeddings.

Lasă auto-save setat la Da pentru ca propriile tale prompturi să fie înregistrate ca istoric de conversație. Dacă mai târziu vrei control manual mai strict, poți dezactiva asta și salva memoria doar în mod explicit.

Lasă controlul hardware dezactivat. Această configurație VPS nu are nevoie de GPIO, plăci tethered USB sau sonde de debug.

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 funcționare.

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

Ceea ce contează aici nu este memorarea fiecărui panou al vrăjitorului. Ceea ce contează este calea pe care o dovedesc captura de ecran: workspace unic, furnizor OpenRouter, intrare ascunsă a cheii API, o alegere de model concretă, fără anulări avansate, fără canale suplimentare, memorie SQLite locală, auto-save activat, hardware dezactivat, fără tunel public și fără rescrierea personalității. Asta este mai mult decât suficient pentru a produce o configurație CLI utilizabilă de primă rulare sub ~/.zeroclaw.

După ce onboarding-ul se termină, confirmă că directorul de configurare principal și workspace-ul există:

Dacă rularea onboarding-ului se termină curat, ar trebui să revii la shell cu un mesaj de tip config-loaded ca cel de mai jos:

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

În rularea capturată, ~/.zeroclaw conținea config.toml și workspace/, iar workspace-ul în sine arăta IDENTITY.md și SOUL.md.

Asta este deja suficient pentru a dovedi că ZeroClaw are acum o cameră de operații, nu doar un binar instalat. Asta este și motivul pentru care analogia workspace-ului este utilă: verifici că camera există, că agentul are context în ea, și că configurarea a depășit “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 acel workspace.

Înainte de primul prompt live, rulează o verificare de sănătate compactă:

zeroclaw status

zeroclaw doctor

Pentru acest prim test de funcționare CLI-only, nu intra în panică 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, iar workspace-ul exista și era scris.

Avertismentele și erorile rămase nu sunt critice pentru un chat terminal: “niciun canal configurat” este de așteptat pentru că ghidul a omis 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 înseamnă doar că demonul always-on nu rulează încă; și plângerea OpenRouter privind listarea modelelor live 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ă încă 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 stricat, iar ieșirea grep este mai bine tratată ca o privire aproximativă în intrările de configurare legate de furnizor/model decât una perfectă pe o linie. 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 de primă rulare și prezența datelor de configurare reale.

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

Porniți primul chat CLI sigur

Cu configurația și spațiul de lucru în loc, lansați agentul în modul interactiv:

zeroclaw agent

În rularea capturată, ZeroClaw a încărcat configurația, a inițializat memoria susținută de SQLite, a tipărit bannerul modului interactiv și a coborât la promptul >. Scopul nu este să porniți o demonstrație strălucitoare. Scopul este să dovediți conectivitatea end-to-end, configurația validă și conștientizarea spațiului de lucru în un singur pas cu risc scăzut. Un test doar pentru citire vă oferă un semnal mult mai util în această etapă decât un prompt capabil de scriere “priviți ce poate face”.

Pentru primul prompt, utilizați această verificare exactă doar 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 doar pentru citire: “pwd && echo “—-” && ls -la”

Aceasta este exact tipul de comandă pe care o doriți pentru acest test de funcționare: tipărește calea spațiului de lucru și listează conținutul de nivel superior fără a schimba nimic. Aprobați-o cu Y pentru un da unic. Ați putea, de asemenea, să o refuzați cu N, dar atunci agentul ar pierde cea mai ușoară modalitate de a răspunde la întrebare din starea reală a sistemului de fișiere în loc să ghicească.

📝 Notă:Puteți vedea, de asemenea, o avertizare de urmărire a costurilor pentru modelul OpenRouter selectat înainte de promptul de aprobare. În rularea capturată, ZeroClaw a avertizat că nu a fost definită nicio intrare de preț pentru openrouter/deepseek/deepseek-v4-pro. Aceasta nu blochează chatul în sine. Aceasta înseamnă doar că utilizarea tokenilor poate fi înregistrată cu cost zero până când definiți explicit prețurile modelului.

Acest prompt este puternic deoarece testează trei lucruri simultan. În primul rând, ZeroClaw trebuie să ajungă la furnizor și să obțină un răspuns. Î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 suficient de specific pentru a-l compara cu ceea ce se află de fapt pe disc. Cu alte cuvinte, aceasta dovedește că agentul rămâne în interiorul camerei în care a fost plasat.

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

• fără erori de autentificare sau furnizor
• fără erori “configurație negăsită” sau model lipsă
• calea corectă a spațiului de lucru apare în răspuns
• fișierele reale de nivel superior sunt numite, fără a pretinde că ceva a fost schimbat

Dacă doriți o modalitate diferită de a invoca agentul, puteți trimite același prompt ca o comandă unică în loc să rămâneți în sesiunea interactivă. Tratați aceasta ca opțională, nu ca principalul ghid. Calea interactivă este încă mai buna primă experiență deoarece face runtime-ul să pară 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ă

Următoarea mișcare corectă nu este să activezi fiecare funcție pe care o poți găsi. Este să adaugi un strat controlat la o dată, astfel încât să știi întotdeauna care schimbare a introdus un risc nou sau o fricțiune nouă.

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

Sarcinile de urmărire bune sunt plictisitoare cu intenție: rezumă un README, explică un fișier de configurare, sau listează idei de curățare fără a schimba nimic. Acel tip de lucru este cu semnal înalt deoarece folosește același runtime pe care tocmai l-ai validat, dar nu te forțează în acces de scriere înainte să ai încredere în instrument. Dacă vrei un spațiu de lucru real mai bun pentru început, folosește o copie sigură a repo-ului, un director de note de staging, sau un mic folder de documente interne în loc de orice care se confruntă cu producția.

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

• indică ZeroClaw către o copie sigură a repo-ului sau un director de note
• încearcă o sarcină helper read-only
• compară furnizorii doar după ce fluxul de bază se simte stabil
• uită-te la servicii, canale, sau Docker mai târziu ca proiecte separate

Dacă vrei să compari furnizorii mai târziu, fă asta după ce fluxul de bază este stabil. Dacă vrei pasul următor de infrastructură după succesul CLI, acestea sunt comenzile care merită cunoscute:

zeroclaw service install
zeroclaw service start
zeroclaw service status

Acesta 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 lor ghiduri.

Dacă acest prim test de fum a fost util, un VPS Ubuntu de la AlexHost este un loc natural pentru a continua experimentarea cu un runtime agent ușor fără a transforma prima zi într-un proiect complet de platformă. Modul corect de a continua este spre exterior, nu lateral: folosește documentația oficială de configurare, serviciu, furnizor, și securitate când ești gata pentru următorul strat.

Concluzie: de la curios la operațional

Rezultatul important nu este că ZeroClaw s-a instalat. Rezultatul important este că a răspuns în siguranță dintr-o sesiune verificată pe VPS. Asta înseamnă că linia de bază Ubuntu a fost validată, instalatorul a rulat, “zeroclaw onboard” s-a finalizat, configurația și spațiul de lucru au fost create, verificările de sănătate arătau normal, și primul răspuns doar pentru citire a revenit ancorat în contextul real al spațiului de lucru.

Acesta este un punct de oprire semnificativ. Păstrați experimentele dvs. inițiale mici, supravegheate și observabile, apoi extindeți câte un strat la o dată către servicii, limite de securitate mai stricte sau integrări de canale atunci când chiar aveți nevoie. Pentru o pornire rapidă pe Ubuntu VPS, încrederea controlată este câștigul. Nu trebuie să plecați din acest articol cu o stivă completă de automatizare. Trebuie să plecați știind că runtime-ul funcționează, limita de siguranță este intactă, și pasul următor este alegerea dvs. în loc de o ghicire.