🦀 ZeroClaw — Персональный ИИ-ассистент

Нулевые накладные расходы. Нулевые компромиссы. 100% Rust. 100% Агностик.
⚡️ Работает на оборудовании за $10 с <5МБ ОЗУ: это на 99% меньше памяти, чем OpenClaw, и на 98% дешевле Mac mini!

Создано студентами и участниками сообществ Harvard, MIT и Sundai.Club.

🌐 Языки: 🇺🇸 English · 🇨🇳 简体中文 · 🇯🇵 日本語 · 🇰🇷 한국어 · 🇻🇳 Tiếng Việt · 🇵🇭 Tagalog · 🇪🇸 Español · 🇧🇷 Português · 🇮🇹 Italiano · 🇩🇪 Deutsch · 🇫🇷 Français · 🇸🇦 العربية · 🇮🇳 हिन्दी · 🇷🇺 Русский · 🇧🇩 বাংলা · 🇮🇱 עברית · 🇵🇱 Polski · 🇨🇿 Čeština · 🇳🇱 Nederlands · 🇹🇷 Türkçe · 🇺🇦 Українська · 🇮🇩 Bahasa Indonesia · 🇹🇭 ไทย · 🇵🇰 اردو · 🇷🇴 Română · 🇸🇪 Svenska · 🇬🇷 Ελληνικά · 🇭🇺 Magyar · 🇫🇮 Suomi · 🇩🇰 Dansk · 🇳🇴 Norsk

ZeroClaw — это персональный ИИ-ассистент, который вы запускаете на своих устройствах. Он отвечает вам в каналах, которые вы уже используете (WhatsApp, Telegram, Slack, Discord, Signal, iMessage, Matrix, IRC, Email, Bluesky, Nostr, Mattermost, Nextcloud Talk, DingTalk, Lark, QQ, Reddit, LinkedIn, Twitter, MQTT, WeChat Work и другие). У него есть веб-панель для управления в реальном времени, и он может подключаться к аппаратным периферийным устройствам (ESP32, STM32, Arduino, Raspberry Pi). Gateway — это просто панель управления, а продукт — это ассистент.

Если вам нужен персональный однопользовательский ассистент, который ощущается локальным, быстрым и всегда включённым — это он.

Веб-сайт · Документация · Архитектура · Начало работы · Миграция с OpenClaw · Устранение неполадок · Discord

Рекомендуемая настройка: выполните zeroclaw onboard в терминале. ZeroClaw Onboard пошагово проведёт вас через настройку gateway, рабочего пространства, каналов и провайдера. Это рекомендуемый путь настройки, работающий на macOS, Linux и Windows (через WSL2). Новая установка? Начните здесь: Начало работы

• OpenAI Codex (подписка ChatGPT)
• Gemini (Google OAuth)
• Anthropic (API-ключ или токен аутентификации)

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

Конфигурация моделей + CLI: Справочник провайдеров Ротация профилей аутентификации (OAuth vs API-ключи) + переключение при сбое: Переключение моделей при сбое

Среда выполнения: стабильный набор инструментов Rust. Один бинарный файл, без зависимостей времени выполнения.

brew install zeroclaw

git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw
./install.sh

zeroclaw onboard запускается автоматически после установки для настройки рабочего пространства и провайдера.

Полное руководство для начинающих (аутентификация, сопряжение, каналы): Начало работы

# Install + onboard
./install.sh --api-key "sk-..." --provider openrouter

# Start the gateway (webhook server + web dashboard)
zeroclaw gateway                # default: 127.0.0.1:42617
zeroclaw gateway --port 0       # random port (security hardened)

# Talk to the assistant
zeroclaw agent -m "Hello, ZeroClaw!"

# Interactive mode
zeroclaw agent

# Start full autonomous runtime (gateway + channels + cron + hands)
zeroclaw daemon

# Check status
zeroclaw status

# Run diagnostics
zeroclaw doctor

Обновляетесь? Выполните zeroclaw doctor после обновления.

git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw

cargo build --release --locked
cargo install --path . --force --locked

zeroclaw onboard

Альтернатива для разработки (без глобальной установки): добавляйте перед командами cargo run --release -- (пример: cargo run --release -- status).

ZeroClaw может импортировать ваше рабочее пространство, память и конфигурацию OpenClaw:

# Preview what will be migrated (safe, read-only)
zeroclaw migrate openclaw --dry-run

# Run the migration
zeroclaw migrate openclaw

Это переносит ваши записи памяти, файлы рабочего пространства и конфигурацию из ~/.openclaw/ в ~/.zeroclaw/. Конфигурация автоматически конвертируется из JSON в TOML.

ZeroClaw подключается к реальным поверхностям обмена сообщениями. Относитесь к входящим ЛС как к ненадёжному вводу.

Полное руководство по безопасности: SECURITY.md

Поведение по умолчанию на всех каналах:

• Сопряжение ЛС (по умолчанию): неизвестные отправители получают короткий код сопряжения, и бот не обрабатывает их сообщение.
• Одобрение через: zeroclaw pairing approve <channel> <code> (затем отправитель добавляется в локальный список разрешённых).
• Публичные входящие ЛС требуют явного включения в config.toml.
• Выполните zeroclaw doctor для выявления рискованных или неправильно настроенных политик ЛС.

Уровни автономности:

Слои изоляции: изоляция рабочего пространства, блокировка обхода путей, списки разрешённых команд, запрещённые пути (/etc, /root, ~/.ssh), ограничение частоты (макс. действий/час, лимиты стоимости/день).

Используйте эту доску для важных уведомлений (критические изменения, рекомендации по безопасности, окна обслуживания и блокеры релизов).

• Лёгкая среда выполнения по умолчанию — типичные CLI и статусные рабочие процессы выполняются в оболочке памяти в несколько мегабайт на релизных сборках.
• Экономичное развёртывание — разработан для плат за $10 и небольших облачных инстансов, без тяжёлых зависимостей среды выполнения.
• Быстрый холодный старт — однобинарная среда выполнения Rust обеспечивает почти мгновенный запуск команд и демона.
• Портативная архитектура — один бинарный файл для ARM, x86 и RISC-V с заменяемыми провайдерами/каналами/инструментами.
• Локальный Gateway — единая панель управления для сессий, каналов, инструментов, cron, SOP и событий.
• Многоканальный почтовый ящик — WhatsApp, Telegram, Slack, Discord, Signal, iMessage, Matrix, IRC, Email, Bluesky, Nostr, Mattermost, Nextcloud Talk, DingTalk, Lark, QQ, Reddit, LinkedIn, Twitter, MQTT, WeChat Work, WebSocket и другие.
• Многоагентная оркестрация (Hands) — автономные рои агентов, работающие по расписанию и становящиеся умнее со временем.
• Стандартные операционные процедуры (SOPs) — событийная автоматизация рабочих процессов с MQTT, webhook, cron и триггерами периферийных устройств.
• Веб-панель — веб-интерфейс React 19 + Vite с чатом в реальном времени, браузером памяти, редактором конфигурации, менеджером cron и инспектором инструментов.
• Аппаратные периферийные устройства — ESP32, STM32 Nucleo, Arduino, Raspberry Pi GPIO через трейт Peripheral.
• Первоклассные инструменты — shell, файловый I/O, browser, git, web fetch/search, MCP, Jira, Notion, Google Workspace и 70+ других.
• Хуки жизненного цикла — перехват и модификация вызовов LLM, выполнения инструментов и сообщений на каждом этапе.
• Платформа навыков — встроенные, общественные и навыки рабочего пространства с аудитом безопасности.
• Поддержка туннелей — Cloudflare, Tailscale, ngrok, OpenVPN и пользовательские туннели для удалённого доступа.

• Лёгкий по умолчанию: маленький бинарный файл Rust, быстрый запуск, малый объём памяти.
• Безопасный по дизайну: сопряжение, строгая изоляция, явные списки разрешений, области рабочего пространства.
• Полностью заменяемый: основные системы — это трейты (провайдеры, каналы, инструменты, память, туннели).
• Без привязки к вендору: поддержка провайдеров, совместимых с OpenAI + подключаемые пользовательские эндпоинты.

Быстрый бенчмарк на локальной машине (macOS arm64, февраль 2026), нормализованный для edge-оборудования на 0.8 ГГц.

Примечания: результаты ZeroClaw измерены на релизных сборках с использованием /usr/bin/time -l. OpenClaw требует среду выполнения Node.js (обычно ~390 МБ дополнительных накладных расходов памяти), а NanoBot требует среду выполнения Python. PicoClaw и ZeroClaw — статические бинарные файлы. Показатели ОЗУ выше — это память времени выполнения; требования к компиляции при сборке выше.

cargo build --release
ls -lh target/release/zeroclaw

/usr/bin/time -l target/release/zeroclaw --help
/usr/bin/time -l target/release/zeroclaw status

• Gateway HTTP/WS/SSE панель управления с сессиями, присутствием, конфигурацией, cron, вебхуками, веб-панелью и сопряжением.
• CLI поверхность: gateway, agent, onboard, doctor, status, service, migrate, auth, cron, channel, skills.
• Цикл оркестрации агента с диспетчеризацией инструментов, построением промптов, классификацией сообщений и загрузкой памяти.
• Модель сессий с применением политики безопасности, уровнями автономности и шлюзом одобрения.
• Устойчивая обёртка провайдера с переключением при сбое, повторными попытками и маршрутизацией моделей через 20+ бэкендов LLM.

Каналы: WhatsApp (нативный), Telegram, Slack, Discord, Signal, iMessage, Matrix, IRC, Email, Bluesky, DingTalk, Lark, Mattermost, Nextcloud Talk, Nostr, QQ, Reddit, LinkedIn, Twitter, MQTT, WeChat Work, WATI, Mochat, Linq, Notion, WebSocket, ClawdTalk.

За feature-флагами: Matrix (channel-matrix), Lark (channel-lark), Nostr (channel-nostr).

Веб-панель React 19 + Vite 6 + Tailwind CSS 4, подаваемая непосредственно из Gateway:

• Панель управления — обзор системы, состояние здоровья, время безотказной работы, отслеживание стоимости
• Чат с агентом — интерактивный чат с агентом
• Память — просмотр и управление записями памяти
• Конфигурация — просмотр и редактирование конфигурации
• Cron — управление запланированными задачами
• Инструменты — просмотр доступных инструментов
• Логи — просмотр журналов активности агента
• Стоимость — использование токенов и отслеживание стоимости
• Доктор — диагностика здоровья системы
• Интеграции — статус интеграций и настройка
• Сопряжение — управление сопряжением устройств

• Основные: shell, чтение/запись/редактирование файлов, операции git, поиск glob, поиск по содержимому
• Веб: управление браузером, web fetch, web search, скриншоты, информация об изображении, чтение PDF
• Интеграции: Jira, Notion, Google Workspace, Microsoft 365, LinkedIn, Composio, Pushover
• MCP: обёртка инструментов Model Context Protocol + отложенные наборы инструментов
• Планирование: cron add/remove/update/run, инструмент расписания
• Память: recall, store, forget, knowledge, project intel
• Продвинутые: delegate (агент-агенту), swarm, переключение/маршрутизация моделей, операции безопасности, облачные операции
• Оборудование: информация о плате, карта памяти, чтение памяти (за feature-флагом)

• Уровни автономности: ReadOnly, Supervised (по умолчанию), Full.
• Изоляция: изоляция рабочего пространства, блокировка обхода путей, списки разрешённых команд, запрещённые пути, Landlock (Linux), Bubblewrap.
• Ограничение частоты: макс. действий в час, макс. стоимость в день (настраиваемые).
• Шлюз одобрения: интерактивное одобрение для операций среднего/высокого риска.
• Аварийная остановка: возможность экстренного отключения.
• 129+ тестов безопасности в автоматизированном CI.

• Веб-панель подаётся непосредственно из Gateway.
• Поддержка туннелей: Cloudflare, Tailscale, ngrok, OpenVPN, пользовательская команда.
• Docker-адаптер среды выполнения для контейнеризованного выполнения.
• CI/CD: бета (авто при push) → стабильный (ручной запуск) → Docker, crates.io, Scoop, AUR, Homebrew, твит.
• Предсобранные бинарные файлы для Linux (x86_64, aarch64, armv7), macOS (x86_64, aarch64), Windows (x86_64).

Минимальный ~/.zeroclaw/config.toml:

default_provider = "anthropic"
api_key = "sk-ant-..."

Полный справочник конфигурации: docs/reference/api/config-reference.md.

Telegram:

[channels.telegram]
bot_token = "123456:ABC-DEF..."

Discord:

[channels.discord]
token = "your-bot-token"

Slack:

[channels.slack]
bot_token = "xoxb-..."
app_token = "xapp-..."

WhatsApp:

[channels.whatsapp]
enabled = true

Matrix:

[channels.matrix]
homeserver_url = "https://matrix.org"
username = "@bot:matrix.org"
password = "..."

Signal:

[channels.signal]
phone_number = "+1234567890"

[tunnel]
kind = "cloudflare"  # or "tailscale", "ngrok", "openvpn", "custom", "none"

Подробности: Справочник каналов · Справочник конфигурации

• native (по умолчанию) — прямое выполнение процесса, самый быстрый путь, идеально для доверенных сред.
• docker — полная контейнерная изоляция, принудительные политики безопасности, требуется Docker.

Установите runtime.kind = "docker" для строгой изоляции или сетевой изоляции.

ZeroClaw поддерживает нативные профили аутентификации по подписке (мультиаккаунт, шифрование в состоянии покоя).

• Файл хранилища: ~/.zeroclaw/auth-profiles.json
• Ключ шифрования: ~/.zeroclaw/.secret_key
• Формат id профиля: <provider>:<profile_name> (пример: openai-codex:work)

# OpenAI Codex OAuth (ChatGPT subscription)
zeroclaw auth login --provider openai-codex --device-code

# Gemini OAuth
zeroclaw auth login --provider gemini --profile default

# Anthropic setup-token
zeroclaw auth paste-token --provider anthropic --profile default --auth-kind authorization

# Check / refresh / switch profile
zeroclaw auth status
zeroclaw auth refresh --provider openai-codex --profile default
zeroclaw auth use --provider openai-codex --profile work

# Run the agent with subscription auth
zeroclaw agent --provider openai-codex -m "hello"
zeroclaw agent --provider anthropic -m "hello"

Корень рабочего пространства: ~/.zeroclaw/workspace/ (настраивается через конфигурацию).

Внедряемые файлы промптов:

• IDENTITY.md — личность и роль агента
• USER.md — контекст и предпочтения пользователя
• MEMORY.md — долгосрочные факты и уроки
• AGENTS.md — соглашения сессий и правила инициализации
• SOUL.md — основная идентичность и принципы работы

Навыки: ~/.zeroclaw/workspace/skills/<skill>/SKILL.md или SKILL.toml.

# List installed skills
zeroclaw skills list

# Install from git
zeroclaw skills install https://github.com/user/my-skill.git

# Security audit before install
zeroclaw skills audit https://github.com/user/my-skill.git

# Remove a skill
zeroclaw skills remove my-skill

# Workspace management
zeroclaw onboard              # Guided setup wizard
zeroclaw status               # Show daemon/agent status
zeroclaw doctor               # Run system diagnostics

# Gateway + daemon
zeroclaw gateway              # Start gateway server (127.0.0.1:42617)
zeroclaw daemon               # Start full autonomous runtime

# Agent
zeroclaw agent                # Interactive chat mode
zeroclaw agent -m "message"   # Single message mode

# Service management
zeroclaw service install      # Install as OS service (launchd/systemd)
zeroclaw service start|stop|restart|status

# Channels
zeroclaw channel list         # List configured channels
zeroclaw channel doctor       # Check channel health
zeroclaw channel bind-telegram 123456789

# Cron + scheduling
zeroclaw cron list            # List scheduled jobs
zeroclaw cron add "*/5 * * * *" --prompt "Check system health"
zeroclaw cron remove <id>

# Memory
zeroclaw memory list          # List memory entries
zeroclaw memory get <key>     # Retrieve a memory
zeroclaw memory stats         # Memory statistics

# Auth profiles
zeroclaw auth login --provider <name>
zeroclaw auth status
zeroclaw auth use --provider <name> --profile <profile>

# Hardware peripherals
zeroclaw hardware discover    # Scan for connected devices
zeroclaw peripheral list      # List connected peripherals
zeroclaw peripheral flash     # Flash firmware to device

# Migration
zeroclaw migrate openclaw --dry-run
zeroclaw migrate openclaw

# Shell completions
source <(zeroclaw completions bash)
zeroclaw completions zsh > ~/.zfunc/_zeroclaw

Полный справочник команд: docs/reference/cli/commands-reference.md

curl -LsSf https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/install.sh | bash

./install.sh --prefer-prebuilt

./install.sh --prebuilt-only

Артефакты релизов публикуются для:

• Linux: x86_64, aarch64, armv7
• macOS: x86_64, aarch64
• Windows: x86_64

Скачайте последние артефакты: https://github.com/zeroclaw-labs/zeroclaw/releases/latest

Используйте это, когда вы прошли онбординг и хотите более глубокий справочник.

• Начните с индекса документации для навигации и «что где».
• Прочитайте обзор архитектуры для полной модели системы.
• Используйте справочник конфигурации, когда вам нужен каждый ключ и пример.
• Управляйте Gateway по инструкции с операционным руководством.
• Следуйте ZeroClaw Onboard для управляемой настройки.
• Устраняйте типичные сбои с помощью руководства по устранению неполадок.
• Ознакомьтесь с руководством по безопасности перед открытием чего-либо.

• Хаб документации: docs/README.md
• Единое оглавление: docs/SUMMARY.md
• Справочник команд: docs/reference/cli/commands-reference.md
• Справочник конфигурации: docs/reference/api/config-reference.md
• Справочник провайдеров: docs/reference/api/providers-reference.md
• Справочник каналов: docs/reference/api/channels-reference.md
• Операционное руководство: docs/ops/operations-runbook.md
• Устранение неполадок: docs/ops/troubleshooting.md

• Руководство по участию: CONTRIBUTING.md
• Политика рабочего процесса PR: docs/contributing/pr-workflow.md
• Руководство по CI-процессу: docs/contributing/ci-map.md
• Руководство рецензента: docs/contributing/reviewer-playbook.md
• Политика раскрытия уязвимостей: SECURITY.md
• Шаблон документации: docs/contributing/doc-template.md

• Руководство по сетевому развёртыванию: docs/ops/network-deployment.md
• Руководство по прокси-агенту: docs/ops/proxy-agent-playbook.md
• Руководства по оборудованию: docs/hardware/README.md

ZeroClaw был создан для smooth crab 🦀 — быстрого и эффективного ИИ-ассистента. Создан Argenis De La Rosa и сообществом.

• zeroclawlabs.ai
• @zeroclawlabs

Если ZeroClaw помогает вашей работе и вы хотите поддержать дальнейшую разработку, вы можете пожертвовать здесь:

Сердечная благодарность сообществам и институтам, которые вдохновляют и питают эту работу с открытым исходным кодом:

• Harvard University — за развитие интеллектуального любопытства и расширение границ возможного.
• MIT — за продвижение открытых знаний, открытого кода и веры в то, что технологии должны быть доступны каждому.
• Sundai Club — за сообщество, энергию и неустанное стремление создавать вещи, которые имеют значение.
• Мир и далее 🌍✨ — каждому участнику, мечтателю и создателю, делающему открытый код силой добра. Это для вас.

Мы строим открыто, потому что лучшие идеи приходят отовсюду. Если вы это читаете, вы часть этого. Добро пожаловать. 🦀❤️

Новичок в ZeroClaw? Ищите задачи с меткой good first issue — см. наше Руководство по участию для начала. AI/vibe-coded PR приветствуются! 🤖

См. CONTRIBUTING.md и CLA.md. Реализуйте трейт, отправьте PR:

• Руководство по CI-процессу: docs/contributing/ci-map.md
• Новый Provider → src/providers/
• Новый Channel → src/channels/
• Новый Observer → src/observability/
• Новый Tool → src/tools/
• Новый Memory → src/memory/
• Новый Tunnel → src/tunnel/
• Новый Peripheral → src/peripherals/
• Новый Skill → ~/.zeroclaw/workspace/skills/<name>/

Это единственный официальный репозиторий ZeroClaw:

https://github.com/zeroclaw-labs/zeroclaw

Любой другой репозиторий, организация, домен или пакет, претендующий на звание «ZeroClaw» или подразумевающий связь с ZeroClaw Labs, является неавторизованным и не связанным с этим проектом. Известные неавторизованные форки будут перечислены в TRADEMARK.md.

Если вы столкнётесь с имитацией или неправомерным использованием товарного знака, пожалуйста, откройте issue.

ZeroClaw распространяется под двойной лицензией для максимальной открытости и защиты участников:

Вы можете выбрать любую лицензию. Участники автоматически предоставляют права по обеим — см. CLA.md для полного соглашения участника.

Название и логотип ZeroClaw являются товарными знаками ZeroClaw Labs. Эта лицензия не предоставляет разрешения на их использование для подразумевания одобрения или принадлежности. См. TRADEMARK.md для разрешённых и запрещённых использований.

• Вы сохраняете авторские права на свои вклады
• Патентное предоставление (Apache 2.0) защищает вас от патентных претензий других участников
• Ваши вклады постоянно атрибутированы в истории коммитов и NOTICE
• Никакие права на товарный знак не передаются при участии

ZeroClaw — Нулевые накладные расходы. Нулевые компромиссы. Развёртывайте где угодно. Заменяйте что угодно. 🦀

Этот список генерируется из графа участников GitHub и обновляется автоматически.