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

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

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

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

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

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

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

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

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

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

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

Це також найчистіший спосіб пояснити, чому деякі люди розглядають ZeroClaw як альтернативу OpenClaw без необхідності робити повне порівняння. Цінність — це не “OpenClaw переписаний на Rust”, і цей посібник не розглядає це так. Цінність полягає в легшій позиції самостійного хостингу, гнучкості провайдера та однобінарному runtime, який легко спробувати на VPS.

Хороші перші варіанти використання однаково обґрунтовані: підсумовування безпечної копії репозиторію, пояснення файлу конфігурації, обробка допоміжного завдання лише для читання всередині низькоризикового workspace або використання його як обмеженого помічника для операторів, які хочуть мати видимість перед тим, як дозволити будь-які реальні зміни.

Перед встановленням: базова конфігурація 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, завантажив відповідний tarball випуску 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 далі. Це зберігає пояснення узгодженим з фактичною обіцянкою статті: перша робоча сесія агента в терміналі, а не спарювання панелі або постійний час виконання.

Якщо ви свідомо ставитеся до безпеки і віддаєте перевагу перевірити інсталятор перед його запуском, використовуйте цей альтернативний підхід:

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 з пошуком векторів (рекомендується). Це найсильніше значення за замовчуванням тут, оскільки воно зберігає все локально, одночасно надаючи вам гібридний пошук та підтримку вбудовування.

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

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

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

Коли крок Personality говорить, що він уже налаштований, залиште Перенастроїти? на Ні. Особистість за замовчуванням достатня для валідації першого запуску.

Важливо тут не запам’ятовувати кожну панель майстра. Важливо — це шлях, який доводять скріншоти: одна робоча область, постачальник 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 явно сказала, що секрет буде зберігатися через системний брелок ключів, коли це можливо, тому “немає видимого ключа в файлі 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.

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

Хороші наступні кроки в порядку виглядають так:

• спрямуйте ZeroClaw на безпечну копію репозиторію або каталог нотаток
• спробуйте одне допоміжне завдання лише для читання
• порівнюйте постачальників лише після того, як базовий робочий процес почне здаватися стабільним
• розглядайте сервіси, канали або Docker пізніше як окремі проекти

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

zeroclaw service install
zeroclaw service start
zeroclaw service status

Це точка, де ця стаття повинна зупинитися, а наступна тема повинна розпочатися. Управління сервісами, розгортання Docker, публічні шлюзи, канали обміну повідомленнями та глибше посилення безпеки заслуговують на власні пояснення.

Якщо цей перший тест диму був корисним, Ubuntu VPS від AlexHost — це природне місце для продовження експериментування з легким агентом виконання без перетворення першого дня на повноцінний проект платформи. Правильний спосіб продовження — це назовні, а не вбік: використовуйте офіційну установку, сервіс, постачальника та документацію безпеки, коли ви готові до наступного шару.

Висновок: від цікавого до операційного

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

Це значуща точка зупинки. Тримайте свої ранні експерименти невеликими, контрольованими та спостережуваними, потім розширюйте один шар за раз у напрямку служб, складніших меж безпеки або інтеграцій каналів, коли вони вам дійсно потрібні. Для першого швидкого старту Ubuntu VPS контрольована впевненість — це перемога. Вам не потрібно залишати цю статтю з повним стеком автоматизації. Вам потрібно залишити її, знаючи, що середовище виконання працює, межа безпеки залишається незайманою, а наступний крок — це ваш вибір, а не здогадка.