ZeroClaw — персональный AI-агент в одном бинарнике на Rust

· 6 мин чтения
ai-agents rust self-hosted mcp open-source
📂 Исходный код на GitHub

Персональный AI-ассистент в одном Rust-бинарнике: 30+ каналов, ~25 LLM-провайдеров, локальный запуск и многоуровневая безопасность.

ZeroClaw — персональный AI-агент в одном бинарнике на Rust

ZeroClaw — персональный AI-агент в одном бинарнике на Rust

ZeroClaw — это среда выполнения AI-агента с открытым кодом. На практике это один бинарник на Rust: вы настраиваете его и запускаете на своей машине, и он становится вашим личным ассистентом. Агент разговаривает с любыми LLM, принимает сообщения из 30+ каналов — Telegram, Discord, Matrix, email, CLI — и выполняет действия через инструменты: shell, браузер, HTTP-запросы и даже GPIO на одноплатных компьютерах.

Девиз проекта: «Вы владеете агентом. Вы владеете данными. Вы владеете машиной, на которой он работает». Всё выполняется локально: ваши ключи лежат в вашем конфиге, история разговоров — в вашей базе данных. У проекта около 33 тысяч звёзд на GitHub, лицензия двойная — MIT или Apache 2.0, на выбор.

Философия: четыре принципа

Авторы зафиксировали четыре мнения о том, каким должен быть агент, и выстроили их по приоритету.

  1. Вы владеете всем. Бинарник работает на вашей машине, вашем VPS или одноплатнике. Никакой телеметрии, никаких облачных подписок и лицензионных серверов. Выдернули шнур — агент остановился, и ничего больше не сломалось.
  2. Сначала безопасность. Агент, который умеет выполнять команды и писать файлы, — привилегированный процесс. По умолчанию уровень автономности supervised: действия среднего риска требуют подтверждения, действия высокого риска заблокированы.
  3. Минимализм. Небольшой бинарник, быстрый старт, минимум зависимостей. Бинарники релиза v0.8.5 занимают от ~33 МиБ на macOS до ~59 МиБ на x86_64 Linux. В промпте нет скрытых системных инструкций: модель видит ровно то, что вы настроили.
  4. Независимость от провайдера. «Мозг» агента меняется одной строкой конфига. У авторов есть мнение о качестве, но не о вендорах.

Не менее показателен список того, чем ZeroClaw не является:

  • Не SaaS. Нет hosted-версии, аккаунтов и биллинга.
  • Не фреймворк. Вы не строите приложения «на базе» ZeroClaw — вы настраиваете готового агента и подключаете каналы.
  • Не просто чат-интерфейс. Чат, веб-дашборд и терминальный интерфейс zerocode — лишь оболочки. Продукт — сам runtime.
  • Не игрушка. Конфигурации живут 24/7 на домашних серверах и VPS через systemd, launchctl или Windows Service.

Каналы, провайдеры, память

Одна и та же агентная петля обслуживает все подключённые каналы: входящие сообщения из Discord, Telegram, Matrix, Slack, email, вебхуков и CLI попадают в одну очередь. Список каналов и настройки — в обзоре каналов.

Поддерживаемые провайдеры: Anthropic, OpenAI, Ollama, Bedrock, Gemini, Azure, OpenRouter и любые OpenAI-совместимые эндпоинты — Groq, Mistral, xAI и ещё около двадцати других. Если основной провайдер начал сбоить, срабатывают цепочки резервов: запрос автоматически уходит к запасной модели. Маршрутизация по подсказкам позволяет гонять тяжёлые задачи рассуждений на одной модели, а дешёвый чат — на другой. Детали — в обзоре провайдеров.

Память агента хранится в SQLite. К разговорам добавляются эмбеддинги — векторные представления текста, — поэтому агент ищет по прошлым беседам не только по точному совпадению слов, но и по смыслу. Веб-дашборд позволяет просматривать память вручную.

Безопасность

Модель безопасности описана в обзоре безопасности: каждый вызов инструмента и каждое сообщение из канала проходят проверку политики во время выполнения. Уровни автономности — три: ReadOnly, Supervised (по умолчанию) и Full.

Что входит в контроль:

  • Границы рабочей области. Агент трогает только пути внутри настроенного workspace.
  • Списки разрешённых и запрещённых команд и проверка shell-политики.
  • Песочницы уровня ОС: Docker, Firejail, Bubblewrap и Landlock на Linux, Seatbelt на macOS.
  • Квитанции об инструментах. Каждое успешное действие инструмента получает криптографическую квитанцию с HMAC-подписью — это журнал аудита, который передаётся вместе с разговором.
  • Аварийный стоп командой zeroclaw estop и подтверждение опасных действий одноразовым кодом (OTP).

Для доверенных машин разработки предусмотрен YOLO-режим: один пресет конфига отключает все предохранители. Режим громко назван, логируется и не является значением по умолчанию.

Архитектура

ZeroClaw — это слоистое рабочее пространство на Rust. Полное описание с диаграммами — в обзоре архитектуры. Основные крейты:

Крейт Роль
zeroclaw-runtime Агентная петля, политика безопасности, SOP-движок, cron, саб-агенты
zeroclaw-api Публичные трейты: ModelProvider, Channel, Tool, Memory, Peripheral — «kernel ABI» проекта
zeroclaw-providers Клиенты LLM: повторные попытки, cooldown, резервы, маршрутизация
zeroclaw-channels 30+ интеграций с мессенджерами и платформами
zeroclaw-gateway HTTP/WebSocket-шлюз и веб-дашборд
zeroclaw-tools Инструменты: браузер, HTTP, проверка железа
zeroclaw-memory Память на SQLite с эмбеддингами и векторным поиском
zeroclaw-plugins Изолированный хост WASM-плагинов (WIT component model)
zeroclaw-hardware Абстракция над GPIO, I2C, SPI, USB

Жизненный цикл запроса прост: сообщение приходит через канал, runtime отправляет его в LLM вместе со списком инструментов, модель возвращает вызов инструмента, политика безопасности одобряет или блокирует его, инструмент выполняется, результат уходит обратно в модель — и агент отвечает пользователю. Полная схема — в описании жизненного цикла.

Развитие идёт по пути микроядра (RFC #5574): ядро сжимается до агентной петли и проверки политики, а всё остальное уезжает за feature flags — вы собираете бинарник только с тем, что используете.

Установка и запуск

На Unix установка сводится к двум командам:

curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/install.sh | sh
"${CARGO_HOME:-$HOME/.cargo}/bin/zeroclaw" quickstart

На Windows есть путь с готовым бинарником и PowerShell-скриптом — Rust-тулчейн не нужен. Поддерживаемые платформы: Linux, macOS, Windows, FreeBSD, NixOS и Docker. Полное руководство — в quickstart.

Базовые команды:

zeroclaw quickstart        # мастер настройки: выбор провайдера и рабочий конфиг
zeroclaw agent -a <alias>  # интерактивный чат с агентом
zeroclaw service install   # регистрация в systemd / launchctl / Windows Service
zeroclaw service start     # постоянная работа в фоне

Есть и готовые сценарии авторизации через подписки. Для OpenAI Codex — импорт существующего профиля:

zeroclaw auth login --model-provider openai-codex --import ~/.codex/auth.json
zeroclaw quickstart --model-provider openai-codex --model gpt-5.4

Для Claude Max — токен из claude setup-token, который вставляется в приглашение quickstart при выборе setup_token.

Конфигурация

Весь ZeroClaw настраивается одним TOML-файлом: ~/.zeroclaw/config.toml. Файл начинается со строки schema_version = 4 (текущая версия схемы) и содержит минимум четыре секции вида тип.алиас — среди них обязательны запись провайдера, агент, который на неё ссылается, и профиль риска, по которому агент проверяет свои действия.

Пример записи провайдера:

[providers.models.openai.coding]   # тип openai, алиас coding
model = "gpt-5.4"
wire_api = "responses"
requires_openai_auth = true

Полный справочник по каждому ключу генерируется из живой схемы и живёт на docs.zeroclaw.com.

Чем ещё интересен проект

  • Железо. Через трейт Peripheral агент работает с GPIO, I2C, SPI и USB на Raspberry Pi, STM32, Arduino и ESP32 — ассистент, который физически щёлкает реле в вашем доме, вписан в архитектуру на уровне API. Подробнее — в обзоре hardware.
  • SOP-движок. Стандартные операционные процедуры запускаются событиями: MQTT, вебхуки, cron или сигнал с периферии. Шаги могут требовать подтверждения, а запуск можно возобновить после сбоя — детали в обзоре SOP.
  • ACP. Подключение к редактору или IDE по Agent Client Protocol — JSON-RPC 2.0 поверх stdio (см. описание ACP).
  • Расширяемость. Новые каналы, провайдеры, инструменты и плагины добавляются отдельными крейтами за контрактами zeroclaw-api; крупные изменения проходят через RFC-процесс. AI-ассистированные PR приветствуются.

Об уязвимостях авторы просят сообщать не в публичные issues, а на security@zeroclaw.dev — политика описана в SECURITY.md.

Источник: https://github.com/zeroclaw-labs/zeroclaw