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

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

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

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

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

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

Какво е ZeroClaw — на обикновен английски

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

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

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

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

Това е също така най-чистият начин да обясните защо някои хора гледат на ZeroClaw като на OpenClaw алтернатива без да налагат пълно сравнение. Стойността не е “OpenClaw преписан в Rust” и този водач не го третира по този начин. Стойността е по-лека поза за самостоятелен хостинг, гъвкавост на доставчика и един-двоичен runtime, който е лесен за опит на 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 издание 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” към вашия профил на обвивка и го преизтеглете с source ~/.bashrc (или отворете отново обвивката). Ако имате нужда само от временна поправка за текущата сесия, използвайте еднолинейния експорт, показан по-долу.

След като двоичният файл е на място, скриптът завършва с неинтерактивно потвърждение вместо да стартира настройката автоматично. При валидирането за този водач това затварящо съобщение сочеше към 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

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

zeroclaw --version

Ако това работи, самата инсталация е успешна. Ако обвивката казва 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. Списъкът е много по-голям, отколкото начинаещ водач има нужда, което е точно защо помага да изберете един чист хостиран път и да се придържате към него за първия пуск.

Поставете вашия OpenRouter API ключ, когато бъдете подсказан. Входът е скрит и подсказката изрично отбелязва, че ZeroClaw съхранява тайната чрез OS ключалката, когато е възможно, вместо да ви моли да я кодирате в 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 е най-ясният източник на истина за активния резюме на runtime, zeroclaw doctor ви казва дали нещо важно е счупено и резултатът на grep е най-добре третиран като груб поглед към записи, свързани с доставчик/модел, отколкото като перфектна еднолинейна валидация. Очаквайте формулировката и точните съвпадения да варират по версия. Не търсите перфектна стена от зелен текст. Търсите отсъствието на първи пуск блокери и присъствието на реални данни за конфигурация.

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

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

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

zeroclaw agent

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

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

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.

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

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

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

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

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

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