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

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

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

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

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

📝 Примечание: Это руководство доказывает первое рабочее использование CLI. Это не руководство по развертыванию в производстве, и оно не пытается охватить 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/.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 models.

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 должен достичь поставщика и получить ответ. Во-вторых, агент должен понять настроенное рабочее пространство. В-третьих, ответ должен быть достаточно конкретным, чтобы вы могли сравнить его с тем, что действительно находится на диске. Другими словами, это доказывает, что агент остается в комнате, которая ему была дана.

Хороший первый ответ должен соответствов