Як встановити ZeroClaw: Простий посібник для початківців для легкої альтернативи OpenClaw

Чому ZeroClaw варто встановлювати

Якщо ви коли-небудь встановлювали інструмент AI, спостерігали, як двійковий файл потрапляє у вашу “PATH”, і все ще не мали доказу того, що він може досягти моделі, зрозуміти свій робочий простір або безпечно відповідати, ви вже розумієте проблему, яку вирішує цей посібник. Завершене встановлення лише доводить, що файли були скопійовані. Це не доводить, що агентський runtime можна використовувати.

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

Ця стаття залишається суворо зосередженою на одному результаті: встановити ZeroClaw, запустити “zeroclaw onboard”, перевірити безпечний перший сеанс CLI і залишитися з реалістичною ідеєю того, що спробувати далі. Це правильна перша віха для посібника, дружнього до новачків на VPS, тому що “робочий” повинен означати обґрунтовану першу відповідь, яку ви можете перевірити, а не довгий тур функцій.

📝 Примітка: Цей посібник доводить перше робоче використання CLI. Це не посібник з розгортання в production, і він не намагається охопити Docker, публічні шлюзи або фонові сервіси

Що таке ZeroClaw — простою мовою

ZeroClaw краще розуміється як агентський runtime, ніж як “AI чатбот”. Модель – це лише одна частина системи. ZeroClaw – це шар, який з’єднує обліковий запис постачальника, вибір моделі, профіль агента та обмежений робочий простір, щоб інструмент міг робити більше, ніж відповідати на один запит ізольовано.

Чотири терміни нижче – це ті, що мають найбільше значення в цьому посібнику:

Ідея робочого простору має більше значення, ніж це звучить. У цій статті робочий простір – це кімната, в якій агенту дозволено працювати. Ось чому встановлення ZeroClaw не те саме, що конфігурація ZeroClaw: двійковий файл може існувати на диску, тоді як постачальник, модель, alias та робочий простір все ще відсутні або неправильно підключені.

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

Це також найчистіший спосіб пояснити, чому деякі люди розглядають ZeroClaw як альтернативу OpenClaw без примусового повного порівняння. Цінність – це не “OpenClaw переписаний на Rust”, і цей посібник не розглядає це так. Цінність – це легша позиція самостійного хостингу, гнучкість постачальника та single-binary 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, перевірив контрольну суму, встановив активи веб-панелі під ~/.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. Список набагато більший, ніж потребує посібник для новачків, що саме чому це допомагає вибрати один чистий розміщений шлях і дотримуватися його для першого запуску.

Вставте свій ключ API OpenRouter, коли його запитають. Введення приховано, і запит явно зазначає, що ZeroClaw зберігає секрет через ключ ОС, коли це можливо, замість того, щоб просити вас жорстко кодувати його у config.toml.

Список моделей OpenRouter довгий. У захопленому запуску була вибрана deepseek/deepseek-v4-pro. Ви можете вибрати іншу поточну модель OpenRouter, якщо віддаєте перевагу, але решта цього посібника дотримується цього точного вибору.

Коли майстер запитує про розширені налаштування, залишіть їх вимкненими для цього посібника. Їх включення призначене для цільових перевизначень, таких як температура, час очікування, базова URL-адреса або протокол передачі.

На екрані Channels виберіть Done без додавання Discord, Telegram, Slack або будь-якої іншої зовнішної поверхні. Це зберігає перший валідацію лише CLI. Ви можете додати канали пізніше, коли локальний шлях агента працює.

Для пам’яті виберіть SQLite з пошуком вектора (рекомендується). Це найсильніший стандартний варіант тут, оскільки він зберігає все локально, при цьому все ще надаючи вам гібридний пошук та підтримку вбудовування.

Залишіть auto-save встановленим на Так, щоб ваші власні запити були записані як історія розмови. Якщо ви пізніше захочете суворішого ручного контролю, ви можете вимкнути це і зберігати пам’ять лише явно.

Залишіть контроль обладнання вимкненим. Це налаштування VPS не потребує GPIO, USB-тетерованих плат або зондів налагодження.

Для постачальника публічного тунелю залишіть його на none. Це відповідає позиції безпеки цієї статті: без публічного доступу під час першого дымового тесту.

Коли крок Personality говорить, що він уже налаштований, залишіть Reconfigure? на No. Стандартна особистість достатня для валідації першого запуску.

Важливо тут не запам’ятовувати кожну панель майстра. Важливо – це шлях, який доводять скріншоти: один робочий простір, постачальник OpenRouter, приховане введення ключа API, конкретний вибір моделі, без розширених перевизначень, без додаткових каналів, локальна пам’ять SQLite, auto-save увімкнено, обладнання вимкнено, без публічного тунелю та без переписування особистості. Цього більш ніж достатньо для створення корисної першої конфігурації 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 був налаштований, стандартна модель була встановлена, а робочий простір існував і був придатним для запису.

Решта попередження та помилки не критичні для чату терміналу: “no channels configured” очікується, оскільки посібник навмисне пропустив Discord, Telegram та інші зовнішні канали; AGENTS.md not found (optional) явно не блокує; daemon_state.json not found означає лише те, що завжди включена демон-програма ще не запущена; і скарга OpenRouter на live-model-listing краще читається як обмеження зонду, ніж доказ того, що налаштування постачальника не вдалося, особливо тому, що вихід все ще повідомляє openrouter: 344 models.

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

Сигнал успіху тут операційний, а не косметичний. zeroclaw status – це найчистіше джерело істини для активного резюме runtime, zeroclaw doctor говорить вам, чи щось важливе зламане, а вихід grep краще розглядається як грубий поглід на записи конфігурації, пов’язані з постачальником/моделлю, ніж як ідеальна однорядкова валідація. Очікуйте, що формулювання та точні збіги будуть відрізнятися за версіями. Ви не шукаєте ідеальну стіну зеленого тексту. Ви шукаєте відсутність першого запуску блокерів та наявність реальних даних конфігурації.

📝 Примітка: config.toml може не показувати ваш ключ API у простому тексті. Це може бути нормально. У захопленому запуску онбордингу запит ключа API явно сказав, що секрет буде зберігатися через ключ ОС, коли це можливо, тому “немає видимого ключа у файлі 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, але тоді агент втратить найлегший спосіб відповісти на питання від реального стану файлової системи зам