Как установить ZeroClaw: Руководство для начинающих по быстрому старту легкой альтернативы OpenClaw

Почему ZeroClaw стоит установить

Если вы когда-либо устанавливали инструмент AI, видели, как бинарный файл попадает в ваш “PATH”, и при этом не имели никаких доказательств того, что он может получить доступ к модели, понять рабочее пространство или ответить безопасно, вы уже понимаете проблему, которую решает это руководство. Завершенная установка только доказывает, что файлы были скопированы. Она не доказывает, что агент runtime пригоден к использованию.

Вот где ZeroClaw становится интересным. Это легкий AI agent runtime, построенный вокруг одного Rust бинарного файла, с поддержкой размещенных поставщиков моделей вместо тяжелого локального стека с первого дня. На практике это означает, что это ближе к “контролируемому tool-using runtime”, чем к “чатботу в терминале”. Для читателей, интересующихся углом “OpenClaw альтернатива”, практическая привлекательность заключается не в шумихе или бенчмарках. Это более легкая история установки, меньший вес зависимостей и тот факт, что тестирование его на Ubuntu VPS кажется управляемым вместо того, чтобы превратиться в полноценный проект инфраструктуры.

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

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

Что такое 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, проверил контрольную сумму, установил активы веб-панели в ~/.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. Если у вас нет веских причин его перемещать, примите значение по умолчанию. На учетной записи без прав администратора такой же макет будет находиться в вашем собственном домашнем каталоге.

Для этого руководства для начинающих по CLI оставьте профили многорабочих областей отключенными. Их включение создает отдельные каталоги памяти, секретов и аудита для каждого взаимодействия, что может быть полезно позже, но это добавляет дополнительные умственные затраты для первого теста дыма.

На экране поставщика выберите OpenRouter. Список намного больше, чем нужно для руководства для начинающих, что именно помогает выбрать один чистый размещенный путь и придерживаться его при первом запуске.

Вставьте ваш API ключ OpenRouter при появлении запроса. Ввод скрыт, и приглашение явно отмечает, что ZeroClaw хранит секрет через системный брелок ключей, когда это возможно, вместо того чтобы просить вас жестко кодировать его в 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 ключа явно сказало, что секрет будет сохранен через системный брелок ключей, когда это возможно, поэтому “нет видимого ключа в файле 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, объяснить файл конфигурации или перечислить идеи очистки без каких-либо изменений. Такая работа имеет высокий сигнал, потому что использует тот же runtime, который вы только что проверили, но не заставляет вас получать доступ на запись, пока вы не доверяете инструменту. Если вы хотите лучшее первое реальное рабочее пространство, используйте безопасную копию репозитория, директорию заметок для промежуточных результатов или небольшую папку внутренней документации вместо чего-либо, обращенного к production.

Хорошие следующие шаги по порядку выглядят так:

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

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

zeroclaw service install
zeroclaw service start
zeroclaw service status

На этом моменте эта статья должна закончиться и должна начаться следующая тема. Управление сервисами, развертывание Docker, публичные шлюзы, каналы обмена сообщениями и более глубокое усиление безопасности заслуживают собственных пошаговых инструкций.

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

Заключение: от любопытства к операционной готовности

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

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