Руководство по установке

Запусти ZeroClaw

Один бинарник на Rust, несколько способов установки. Выбери подходящий.

checklist Системные требования

build Rust

Rust toolchain (stable) через rustup.rs — нужен только для сборки из исходников

computer OS

Linux (x86_64, aarch64, armv7), macOS (x86_64, aarch64), Windows (x86_64)

memory RAM

Runtime: <5 МБ RAM. Сборка из исходников: 2 ГБ+ RAM, рекомендуется 4 ГБ

hard_drive Disk

Бинарник: ~8.8 МБ. Сборка из исходников: 6 ГБ свободного места, рекомендуется 10 ГБ

extension Optional

Опционально: Docker (для изолированного runtime), Git (для сборки из исходников)

wifi Network

Интернет для вызовов AI API. Локальные модели через Ollama работают полностью офлайн.

Однострочные скрипты, которые сделают всё за тебя. Рекомендуется для большинства пользователей.

bolt

Remote One-Liner

macOS / Linux. Single command.

$ curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/bootstrap.sh | bash
rocket_launch

Local Bootstrap

Clone first, then bootstrap. More options.

$ git clone https://github.com/zeroclaw-labs/zeroclaw.git
$ cd zeroclaw && ./bootstrap.sh
$ # With system deps + Rust: ./bootstrap.sh --install-system-deps --install-rust
$ # With onboarding: ./bootstrap.sh --onboard --api-key "sk-..." --provider openrouter

verified Проверка установки

Выполни эти команды, чтобы убедиться, что ZeroClaw установлен правильно.

1
$ zeroclaw --version

Должна вывести установленную версию. Выполняется за ~0.02 с с пиковым потреблением ~3.9 МБ.

2
$ zeroclaw doctor

Запускает системную диагностику: версия Rust, конфиг-файлы, подключение к провайдерам, состояние каналов.

3
$ zeroclaw onboard --interactive

Интерактивный мастер настройки API-ключей, выбора провайдера и конфигурации каналов.

settings Начальная конфигурация

После установки мастер onboard проведёт тебя через настройку. Вот что делает каждый шаг.

1

Выбери AI-провайдера

Выбери из каталога провайдеров: OpenAI, Anthropic, Google Gemini, xAI, Mistral, DeepSeek, OpenRouter (100+ моделей) или любой OpenAI-совместимый endpoint, включая Ollama для локальных моделей.

2

Добавь API-ключ

Вставь свой API-ключ. Ключи хранятся локально в config.toml — никуда не отправляются, кроме AI-провайдера. Также поддерживается подписочная авторизация (OpenAI Codex, Anthropic) с зашифрованными профилями.

3

Подключи канал

Подключи Telegram (вставь токен бота), Discord (вставь токен бота), Slack (приложение workspace), WhatsApp (QR-код) или любой из 17+ поддерживаемых каналов. Политика deny-by-default allowlist.

4

Запусти агента

Выполни 'zeroclaw agent -m "Привет!"' для быстрого теста, 'zeroclaw daemon' для полного автономного runtime или 'zeroclaw service install' для фонового сервиса.

.env — Вся конфигурация хранится в ~/.zeroclaw/config.toml. Редактируй напрямую для изменения провайдеров, каналов, бэкендов памяти, туннелей и настроек безопасности. Полный справочник в docs/reference/README.md.

system_update_alt Обновление ZeroClaw

Обновляй ZeroClaw, чтобы получать новые функции, интеграции и патчи безопасности.

Homebrew
$ brew upgrade zeroclaw
Cargo
$ cargo install zeroclaw --force
Git
$ cd zeroclaw && git pull && cargo build --release --locked
Docker
$ ./bootstrap.sh --docker --skip-build

Смотри список изменений на github.com/zeroclaw-labs/zeroclaw/releases — что нового в каждой версии.

build Устранение неполадок

Частые проблемы и способы их решения.

Нужна помощь?

Присоединяйся к сообществу для помощи с установкой и устранением неполадок.

Будь в курсе

Получай обновления о новых релизах, интеграциях и инфраструктуре AI-агентов на Rust. Без спама, отписка в любой момент.