Как да инсталирате ZeroClaw: Начинаещо-приятелски Quickstart за лека OpenClaw алтернатива

Защо ZeroClaw си струва да се инсталира

Ако някога сте инсталирали AI инструмент, видели сте двоичния файл да се приземи в вашия “PATH”, и все още нямате доказателство, че може да достигне модел, да разбере вашето работно пространство или да отговори безопасно, вече разбирате проблема, който този наръчник решава. Завършена инсталация само доказва, че файловете са копирани. Не доказва, че агентният runtime е използваем.

Там ZeroClaw става интересен. Това е лек AI агентен runtime, построен около един Rust двоичен файл, с поддръжка за хостирани доставчици на модели вместо тежко локално хранилище от първия ден. На практика това означава, че е по-близо до “контролиран runtime за използване на инструменти” отколкото до “чатбот в терминал.” За читатели, които са любопитни относно ъгъла “OpenClaw алтернатива”, практическата привлекателност не е хайп или бенчмарки. Това е по-лека история на инсталация, по-нисък тегло на зависимостите и фактът, че тестването му на Ubuntu VPS се чувства управляемо вместо да се превърне в пълен инфраструктурен проект.

Тази статия остава плътно фокусирана върху един резултат: инсталирайте ZeroClaw, стартирайте “zeroclaw onboard”, проверете безопасна първа CLI сесия и напуснете с реалистична идея за това какво да опитате следващо. Това е правилния първи етап за начинаещ-приятелски VPS наръчник, защото “работещо” трябва да означава обоснован първи отговор, който можете да проверите, не дълга обиколка на функции.

📝 Забележка: Този наръчник доказва първо работещо CLI използване. Това не е наръчник за production deployment и не се опитва да покрие Docker, публични gateway-и или фонови услуги

Какво е ZeroClaw — на обикновен език

ZeroClaw е по-добре разбираемо като агентно време на изпълнение, отколкото като “AI чатбот”. Моделът е само една част от системата. ZeroClaw е слоят, който свързва акаунт на доставчик, избор на модел, профил на агент и ограничено работно пространство, така че инструментът да може да направи повече от отговор на един подсказ в изолация.

Четирите термина по-долу са най-важните в този урок:

Идеята за работното пространство е по-важна, отколкото звучи. В тази статия работното пространство е стаята, в която агентът е позволено да работи. Това е причината инсталирането на ZeroClaw да не е същото като конфигурирането на ZeroClaw: двоичният файл може да съществува на диска, докато доставчикът, моделът, псевдонимът и работното пространство все още липсват или са неправилно свързани.

📝 Забележка: Успешната инсталация е само половината от историята. Смисленият етап е работеща конфигурация под ~/.zeroclaw, която може да достигне доставчик и да работи в видимо работно пространство.

Това е също най-чистия начин да се обясни защо някои хора гледат на ZeroClaw като на алтернатива на OpenClaw без да налагат пълно сравнение. Стойността не е “OpenClaw преписан на Rust”, и това ръководство не го третира по този начин. Стойността е по-лека позиция за самостоятелен хостинг, гъвкавост на доставчика и еденствено-двоично време на изпълнение, което е лесно да се опита на VPS.

Добрите първи случаи на употреба са еднакво обосновани: обобщаване на безопасна копия на хранилище, обяснение на конфигурационен файл, справяне с помощна задача само за четене в работно пространство с нисък риск, или използване като ограничен асистент за операторите, които искат видимост преди да позволят каквито и да е реални промени.

Преди да инсталирате: Ubuntu базова конфигурация, предварителни условия и безопасност

Преди да стартирате инсталатора, отделете една минута, за да потвърдите, че VPS е наистина добър избор за пътя, който използва тази статия. Минималните изисквания са ясни: SSH достъп до Ubuntu VPS, curl, един хостинг акаунт с API ключ и нискорискова машина или работно пространство за първата сесия.

Първо изпълнете проверките по-долу. При валидирането, показано на снимките на екрана, те върнаха Ubuntu 24.04.4 LTS (Noble Numbat), x86_64 и /usr/bin/curl. Това е достатъчно, за да потвърдите базовата конфигурация на ръководството, без да претендирате, че всеки сървър ще върне идентичен резултат.

cat /etc/os-release

uname -m
command -v curl

За примера с хостинг доставчик, OpenRouter е най-чистият избор по подразбиране, защото запазва VPS-ориентирания подход и избягва локална настройка на модела на сървъра. Ако вече използвате друг поддържан доставчик, това е добре, но имайте API ключа готов преди zeroclaw onboard да започне да задава въпроси. Целта тук е първи успех, не пазаруване на доставчици, така че един чист хостинг път е по-добър от опита да оцените всеки доставчик в същата сесия.

ZeroClaw поддържа както предварително събрани, така и инсталационни пътища от източник. Мислете за предварително събрания маршрут като за готов уред и маршрута от източник като за комплект за самостоятелна сборка. И двата са легитимни, но служат на различни читатели. За този бърз старт важното е да разберете разликата сега и да направите действителната препоръка в стъпката на инсталация.

⚠️ Внимание: Използвайте този контролен списък за първи път преди да продължите:

• останете в нискорискова работна среда
• запазете поведението по подразбиране под надзор
• избягвайте публично разкриване и производствени данни
• направете първата задача само за четене с цел

Инсталирайте ZeroClaw с официалния скрипт

След като завършите предварителната проверка, използвайте официалния инсталатор като основния път. Това е най-краткият поддържан маршрут за Ubuntu VPS бързо стартиране:

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

На този път на инсталация скриптът работи неинтерактивно и автоматично приема предварително изградения път на издаването. При валидационния тест за това ръководство той открива целевата Linux система, изтегля съответния GitHub release tarball, проверява контролната сума, инсталира активите на уеб табло под ~/.local/share/zeroclaw/web/dist и поставя двоичния файл zeroclaw в ~/.cargo/bin. Тъй като екранните снимки бяха направени от root акаунта, конкретните пътища, показани, са /root/.local/share/zeroclaw/web/dist, /root/.cargo/bin/zeroclaw и /root/.bashrc; на обикновен потребителски акаунт очаквайте същото оформление под вашата собствена начална директория.

Този бърз път не е пряк път или по-малко официална инсталация. Това е нормалният маршрут за бързо стартиране за аудиторията, за която е написано това ръководство: изтеглете съответното издание, проверете го и поставете двоичния файл в ~/.cargo/bin/zeroclaw. Ако умишлено искате изграждане от източник, вместо това използвайте пътя на клониране на хранилище по-долу, вместо да очаквате този поток на инсталатор да спре и да предложи отделен избор за изграждане.

💡 Съвет: На Linux най-честият проблем след инсталирането е PATH, не самата инсталация. Следвайте предложението на инсталатора да добавите export PATH=”$HOME/.cargo/bin:$PATH” към вашия профил на shell и го презаредете с source ~/.bashrc (или отворете отново shell). Ако имате нужда само от временно решение за текущата сесия, използвайте еднолинейния export показан по-долу.

След като двоичният файл е на място, скриптът завършва с неинтерактивно потвърждение вместо да стартира настройката автоматично. При валидационния тест за това ръководство това затварящо съобщение сочеше към zeroclaw quickstart, но инсталираният двоичен файл “v0.7.5” разкри onboard като действителната подкоманда за настройка в zeroclaw –help. Той също така посочва, че zeroclaw daemon е пътят за демона, който винаги е включен, плюс уеб табло, докато zeroclaw agent е еднократният CLI чат път.

За тази статия продължете със zeroclaw onboard по-нататък. Това поддържа преминаването на статията в съответствие с действителното й обещание: първа работеща сесия на агент в терминала, а не сдвояване на табло или винаги включен runtime.

Ако сте съсредоточени върху сигурността и предпочитате да проверите инсталатора преди да го стартирате, използвайте този алтернативен подход:

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

Преди да мислите за доставчици или подкани, проверете дали двоичният файл е извикваем в shell:

zeroclaw --version

Ако това работи, самата инсталация е успешна. Ако shell казва command not found, приложете временното решение за PATH по-долу и тестирайте отново:

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

Разделянето на този етап от конфигурацията е важно. Работещ zeroclaw –version ви казва, че проблемът с инсталатора е решен, преди да започнете да отстранявате настройката на доставчика.

Стартирайте zeroclaw onboard и проверете какво е създал

Това е точката, където “инсталиран” трябва да стане “конфигуриран”. На пътя на неинтерактивната инсталация, използван по-горе, скриптът явно пропуска подсказката за настройка. Ако съобщението на инсталатора споменава zeroclaw quickstart, но бинарният файл го не разпознава, доверете се на zeroclaw –help и стартирайте първоначалния съветник с:

zeroclaw onboard

Съветникът се отваря на екрана на работното пространство. В заснетото изпълнение пътят на работното пространство по подразбиране беше /root/.zeroclaw/workspace. Освен ако нямате силна причина да го преместите, приемете подразбиранието. На акаунт, който не е root, същото оформление ще живее в собствената ви домашна директория.

За този начинаещ CLI преглед оставете профилите на многократно работно пространство деактивирани. Включването им създава отделни памет, тайни и директории за одит за всяко ангажиране, което може да бъде полезно по-късно, но добавя допълнителен умствен товар за първи тест на дима.

На екрана на доставчика изберете OpenRouter. Списъкът е много по-голям, отколкото начинаещо ръководство трябва, което е точно защо помага да изберете един чист хостван път и да се придържате към него за първото изпълнение.

Поставете вашия API ключ на OpenRouter, когато бъдете подсказани. Входът е скрит, а подсказката явно отбелязва, че ZeroClaw съхранява тайната чрез OS keyring, когато е възможно, вместо да ви моли да я кодирате в config.toml.

Списъкът на модели на OpenRouter е дълъг. В заснетото изпълнение беше избран deepseek/deepseek-v4-pro. Можете да изберете друг текущ модел на OpenRouter, ако предпочитате, но останалата част от този преглед следва точно този избор.

Когато съветникът попита за разширени настройки, оставете ги изключени за това ръководство. Включването им е за целеви замени, като температура, време на изчакване, базов URL или протокол на жица.

На екрана на каналите изберете Готово, без да добавяте Discord, Telegram, Slack или някоя друга външна повърхност. Това поддържа първото валидиране само на CLI. Можете да добавите канали по-късно, когато локалният път на агента работи.

За памет изберете SQLite с векторно търсене (препоръчано). Това е най-силното подразбиране тук, защото поддържа всичко локално, докато все още ви дава хибридно търсене и поддръжка на вграждане.

Оставете автоматично запазване зададено на Да, така че вашите собствени подсказки да бъдат записани като история на разговора. Ако по-късно искате по-строг ръчен контрол, можете да го изключите и да запазите памет само явно.

Оставете управлението на хардуера деактивирано. Тази VPS настройка не се нуждае от GPIO, USB-свързани платки или сонди за отстраняване на грешки.

За доставчика на публичен тунел, го поддържайте на никой. Това съответства на позицията на безопасност на тази статия: без публично излагане по време на първия тест на дима.

Когато стъпката на личност казва, че вече е конфигурирана, оставете Преконфигуриране? на Не. Личността по подразбиране е достатъчна за валидиране при първо изпълнение.

Важното тук не е запомнянето на всеки панел на съветника. Важното е пътят, който скриншотите доказват: единично работно пространство, доставчик OpenRouter, скрит вход на API ключ, конкретен избор на модел, без разширени замени, без допълнителни канали, локална памет SQLite, автоматично запазване включено, хардуер изключен, без публичен тунел и без преписване на личност. Това е повече от достатъчно, за да се произведе използваема първа CLI конфигурация под ~/.zeroclaw.

След завършване на бордирането потвърдете, че главната директория на конфигурацията и работното пространство съществуват:

Ако изпълнението на бордирането завърши чисто, трябва да се върнете към обвивката със съобщение за зареждане на конфигурация като това по-долу:

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

В заснетото изпълнение ~/.zeroclaw съдържаше config.toml и workspace/, а самото работно пространство показа IDENTITY.md и SOUL.md.

Това вече е достатъчно, за да докаже, че ZeroClaw сега има операционна зала, не само инсталиран бинарен файл. Това е също причината аналогията на работното пространство да е полезна: проверявате, че стаята съществува, че агентът има контекст вътре в нея, и че настройката надвишава “инсталаторът завърши.” Файлове като IDENTITY.md и SOUL.md не са декоративни. Те са част от контекста, който ZeroClaw използва, за да разбере как трябва да се държи вътре в това работно пространство.

Преди първата жива подсказка стартирайте компактна проверка на здравето:

zeroclaw status

zeroclaw doctor

За този първи тест на дима само на CLI, не паникувайте, ако zeroclaw doctor не е перфектно чист. В заснетото изпълнение важните проверки преминаха: файлът на конфигурацията беше намерен, доставчикът openrouter беше валиден, API ключът беше конфигуриран, моделът по подразбиране беше зададен и работното пространство съществуваше и беше записуемо.

Останалите предупреждения и грешки не са критични за терминален чат: “никакви канали не са конфигурирани” се очаква, защото преглеждът намерено пропусна Discord, Telegram и други външни канали; AGENTS.md не е намерен (по желание) е явно неблокиращ; daemon_state.json не е намерен означава само, че демонът, който винаги работи, все още не е стартиран; и оплаката на OpenRouter за живо-модел-листинг е по-добре да се чете като ограничение на сондата, отколкото доказателство, че настройката на доставчика е неудачна, особено защото резултатът все още докладва openrouter: 344 модела.

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

Сигналът за успех тук е оперативен, не козметичен. zeroclaw status е най-ясният източник на истина за активното резюме на времето на изпълнение, zeroclaw doctor ви казва дали нещо важно е счупено, и резултатът grep е най-добре да се третира като груб поглед в записите, свързани с доставчик/модел, отколкото перфектен един-редов. Очаквайте формулировката и точните съвпадения да варират по версия. Не търсите перфектна стена от зелен текст. Търсите отсъствието на първоначални блокери и присъствието на реални данни за конфигурация.

📝 Забележка: config.toml може да не показва вашия API ключ в обикновен текст. Това може да е нормално. В заснетото изпълнение на бордирането подсказката за API ключ явно каза, че тайната ще бъде съхранена чрез OS keyring, когато е възможно, така че “няма видим ключ в TOML файла” не е същото като “настройката е неудачна.”

Стартирайте първия безопасен CLI чат

С конфигурацията и работното пространство на място, стартирайте агента в интерактивен режим:

zeroclaw agent

В заснетото изпълнение ZeroClaw зареди конфигурацията, инициализира SQLite-подкрепена памет, отпечата банера на интерактивния режим и се спусна към > подсказката. Целта не е да стартирате впечатляваща демонстрация. Целта е да докажете end-to-end свързаност, валидна конфигурация и осведоменост за работното пространство в един нискорисков етап. Тест само за четене ви дава далеч по-полезен сигнал на този етап, отколкото подсказка с възможност за запис “вижте какво може да направи”.

За първата подсказка използвайте точно този тест само за четене:

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.

Тъй като времето на изпълнение е в контролиран режим, първият полезен отговор може да изисква одобрение на инструмент. В заснетото изпълнение ZeroClaw попита да изпълни команда само за четене: “pwd && echo “—-” && ls -la”

Това е точно видът на команда, която искате за този тест на дим: отпечатва пътя на работното пространство и изброява съдържанието на най-горното ниво без промяна на нищо. Одобрете го с Y за еднократен “да”. Можете също да го отхвърлите с N, но тогава агентът би загубил най-лесния начин да отговори на въпроса от реално състояние на файловата система вместо да гадае.

📝 Забележка:Може също да видите предупреждение за проследяване на разходите за избрания модел OpenRouter преди подсказката за одобрение. В заснетото изпълнение ZeroClaw предупреди, че няма дефинирана запис за цени за openrouter/deepseek/deepseek-v4-pro. Това не блокира самия чат. Това означава само, че използването на токени може да бъде записано с нулева цена, докато не дефинирате цените на модела явно.

Тази подсказка е силна, защото тества три неща наведнъж. Първо, ZeroClaw трябва да достигне доставчика и да получи отговор. Второ, агентът трябва да разбере конфигурираното работно пространство. Трето, отговорът трябва да бъде достатъчно специфичен, за да можете да го сравните с това, което действително е на диска. С други думи, това доказва, че агентът остава в стаята, която му беше дадена.

Добрият първи отговор трябва да отговаря на четири условия:

• без грешки при удостоверяване или доставчик
• без “конфигурация не намерена” или неуспешни модели
• правилният път на работното пространство се появява в отговора
• реални файлове на най-горното ниво са наименувани, без твърдение, че нещо е променено

Ако искате различен начин да извикате агента, можете да изпратите същата подсказка като еднократна команда вместо да останете в интерактивната сесия. Третирайте това като опционално, не като основния преглед. Интерактивният път е все още по-добрия първи опит, защото прави времето на изпълнение наблюдаемо вместо магическо.

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."

Какво да направите след като ZeroClaw работи

Правилният следващ ход не е да включите всяка функция, която намерите. Това е да добавите един контролиран слой наведнъж, така че винаги да знаете кой промяна е въвела нов риск или ново триене.

💡 Съвет: След като първия безопасен чат работи, запазете същата дисциплина за следващата фаза. Преместете се първо в безопасна копия на хранилище или директория с бележки, запазете задачите само за четене, където е възможно, и разширете привилегиите само след като базовият работен процес се почувства предсказуем.

Добрите последващи задачи са скучни с цел: обобщете README, обяснете конфигурационен файл или изброите идеи за почистване без да променяте нищо. Този вид работа е висок сигнал, защото използва същия runtime, който току-що валидирахте, но не ви принуждава да влезете в достъп за писане преди да доверите инструмента. Ако искате по-добро първо реално работно пространство, използвайте безопасна копия на хранилище, директория със сценични бележки или малка вътрешна папка с документи, а не нищо, което е обърнато към производство.

Добрите следващи стъпки, по ред, изглеждат така:

• насочете ZeroClaw към безопасна копия на хранилище или директория с бележки
• опитайте една задача за четене
• сравнете доставчиците само след като базовият работен процес се почувства стабилен
• разгледайте услуги, канали или Docker по-късно като отделни проекти

Ако искате да сравните доставчиците по-късно, направете това след като базовият работен процес е стабилен. Ако искате следващата стъпка на инфраструктурата след успеха на CLI, това са командите, които си струва да знаете:

zeroclaw service install
zeroclaw service start
zeroclaw service status

Това е точката, където тази статия трябва да спре и следващата тема трябва да начне. Управлението на услугите, развертыванието на Docker, публичните шлюзове, каналите за съобщения и по-дълбокото укрепване на сигурността заслужават свои собствени ръководства.

Ако този първи тест на дима беше полезен, Ubuntu VPS от AlexHost е естествено място, където да продължите да експериментирате с лек agent runtime без да превръщате първия ден в пълен платформен проект. Правилният начин да продължите е навън, не встрани: използвайте официалната настройка, услугата, доставчика и документите за сигурност, когато сте готови за следващия слой.

Заключение: от любопитен към оперативен

Важният резултат не е, че ZeroClaw се инсталира. Важният резултат е, че той отговори безопасно от проверена първа сесия на VPS. Това означава, че Ubuntu базовата линия е проверена, инсталаторът работи, “zeroclaw onboard” е завършен, конфигурацията и работното пространство са създадени, проверките на здравето изглеждат разумни, и първият отговор само за четене дойде обоснован в реален контекст на работното пространство.

Това е смислена спирка. Держите ранните си експерименти малки, надзирани и наблюдаеми, след това разширявайте един слой наведнъж към услуги, по-трудни граници на сигурност или интеграции на канали, когато наистина ви трябват. За първи Ubuntu VPS quickstart, контролираната увереност е победата. Не е необходимо да напуснете тази статия с пълен стек за автоматизация. Трябва да напуснете, знаейки, че runtime работи, границата на безопасност е интактна, и следващата стъпка е ваш избор вместо предположение.