Skip to content

Latest commit

 

History

History
257 lines (192 loc) · 15 KB

File metadata and controls

257 lines (192 loc) · 15 KB

ZeroClaw

ZeroClaw 🦀(Русский)

Zero overhead. Zero compromise. 100% Rust. 100% Agnostic.

License: MIT OR Apache-2.0 Contributors Buy Me a Coffee X: @zeroclawlabs Facebook Group Discord TikTok: @zeroclawlabs RedNote Reddit: r/zeroclawlabs

🌐 Языки: 🇺🇸 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

Установка в 1 клик | Быстрый старт | Хаб документации | TOC docs

Быстрые маршруты: Справочники · Операции · Диагностика · Безопасность · Аппаратная часть · Вклад и CI

Этот файл — выверенный перевод README.md с акцентом на точность и читаемость (не дословный перевод).

Технические идентификаторы (команды, ключи конфигурации, API-пути, имена Trait) сохранены на английском.

Последняя синхронизация: 2026-02-19.

🚀 What's New in v0.3.1 (March 2026)

Area Highlights
ci add Termux (aarch64-linux-android) release target

📢 Доска объявлений

Публикуйте здесь важные уведомления (breaking changes, security advisories, окна обслуживания и блокеры релиза).

Дата (UTC) Уровень Объявление Действие
2026-02-19 Срочно Мы не аффилированы с openagen/zeroclaw и zeroclaw.org. Домен zeroclaw.org сейчас указывает на fork openagen/zeroclaw, и этот домен/репозиторий выдают себя за наш официальный сайт и проект. Не доверяйте информации, бинарникам, сборам средств и «официальным» объявлениям из этих источников. Используйте только этот репозиторий и наши верифицированные соцсети.
2026-02-21 Важно Наш официальный сайт уже запущен: zeroclawlabs.ai. Спасибо, что дождались запуска. При этом попытки выдавать себя за ZeroClaw продолжаются, поэтому не участвуйте в инвестициях, сборах средств и похожих активностях, если они не подтверждены через наши официальные каналы. Ориентируйтесь только на этот репозиторий; также следите за X (@zeroclawlabs), Telegram (@zeroclawlabs), Facebook (группа), Reddit (r/zeroclawlabs) и Xiaohongshu для официальных обновлений.
2026-02-19 Важно Anthropic обновил раздел Authentication and Credential Use 2026-02-19. В нем указано, что OAuth authentication (Free/Pro/Max) предназначена только для Claude Code и Claude.ai; использование OAuth-токенов, полученных через Claude Free/Pro/Max, в любых других продуктах, инструментах или сервисах (включая Agent SDK), не допускается и может считаться нарушением Consumer Terms of Service. Чтобы избежать потерь, временно не используйте Claude Code OAuth-интеграции. Оригинал: Authentication and Credential Use.

О проекте

ZeroClaw — это производительная и расширяемая инфраструктура автономного AI-агента. ZeroClaw — это операционная система времени выполнения для агентных рабочих процессов — инфраструктура, абстрагирующая модели, инструменты, память и выполнение, позволяя создавать агентов один раз и запускать где угодно.

  • Нативно на Rust, единый бинарник, переносимость между ARM / x86 / RISC-V
  • Архитектура на Trait (Provider, Channel, Tool, Memory и др.)
  • Безопасные значения по умолчанию: pairing, явные allowlist, sandbox и scope-ограничения

Почему выбирают ZeroClaw

  • Лёгкий runtime по умолчанию: Повседневные CLI-операции и status обычно укладываются в несколько МБ памяти.
  • Оптимизирован для недорогих сред: Подходит для бюджетных плат и небольших cloud-инстансов без тяжёлой runtime-обвязки.
  • Быстрый cold start: Архитектура одного Rust-бинарника ускоряет запуск основных команд и daemon-режима.
  • Портативная модель деплоя: Единый подход для ARM / x86 / RISC-V и возможность менять providers/channels/tools.

Снимок бенчмарка (ZeroClaw vs OpenClaw, воспроизводимо)

Ниже — быстрый локальный сравнительный срез (macOS arm64, февраль 2026), нормализованный под 0.8GHz edge CPU.

OpenClaw NanoBot PicoClaw ZeroClaw 🦀
Язык TypeScript Python Go Rust
RAM > 1GB > 100MB < 10MB < 5MB
Старт (ядро 0.8GHz) > 500s > 30s < 1s < 10ms
Размер бинарника ~28MB (dist) N/A (скрипты) ~8MB ~8.8 MB
Стоимость Mac Mini $599 Linux SBC ~$50 Linux-плата $10 Любое железо за $10

Примечание: результаты ZeroClaw получены на release-сборке с помощью /usr/bin/time -l. OpenClaw требует Node.js runtime; только этот runtime обычно добавляет около 390MB дополнительного потребления памяти. NanoBot требует Python runtime. PicoClaw и ZeroClaw — статические бинарники.

Сравнение ZeroClaw и OpenClaw

Локально воспроизводимое измерение

Метрики могут меняться вместе с кодом и toolchain, поэтому проверяйте результаты в своей среде:

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

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

Текущие примерные значения из README (macOS arm64, 2026-02-18):

  • Размер release-бинарника: 8.8M
  • zeroclaw --help: ~0.02s, пик памяти ~3.9MB
  • zeroclaw status: ~0.01s, пик памяти ~4.1MB

Установка в 1 клик

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

Для полной инициализации окружения: ./install.sh --install-system-deps --install-rust (для системных пакетов может потребоваться sudo).

Подробности: docs/setup-guides/one-click-bootstrap.md.

Быстрый старт

Homebrew (macOS/Linuxbrew)

brew install zeroclaw
git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw
cargo build --release --locked
cargo install --path . --force --locked

zeroclaw onboard --api-key sk-... --provider openrouter
zeroclaw onboard

zeroclaw agent -m "Hello, ZeroClaw!"

# default: 127.0.0.1:42617
zeroclaw gateway

zeroclaw daemon

Subscription Auth (OpenAI Codex / Claude Code)

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

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

OpenAI Codex OAuth (подписка ChatGPT):

# Рекомендуется для серверов/headless-окружений
zeroclaw auth login --provider openai-codex --device-code

# Браузерный/callback-поток с paste-фолбэком
zeroclaw auth login --provider openai-codex --profile default
zeroclaw auth paste-redirect --provider openai-codex --profile default

# Проверка / обновление / переключение профиля
zeroclaw auth status
zeroclaw auth refresh --provider openai-codex --profile default
zeroclaw auth use --provider openai-codex --profile work

Claude Code / Anthropic setup-token:

# Вставка subscription/setup token (режим Authorization header)
zeroclaw auth paste-token --provider anthropic --profile default --auth-kind authorization

# Команда-алиас
zeroclaw auth setup-token --provider anthropic --profile default

Запуск agent с subscription auth:

zeroclaw agent --provider openai-codex -m "hello"
zeroclaw agent --provider openai-codex --auth-profile openai-codex:work -m "hello"

# Anthropic поддерживает и API key, и auth token через переменные окружения:
# ANTHROPIC_AUTH_TOKEN, ANTHROPIC_OAUTH_TOKEN, ANTHROPIC_API_KEY
zeroclaw agent --provider anthropic -m "hello"

Вклад и лицензия

🌟 Recent Contributors (v0.3.1)

3 contributors shipped features, fixes, and improvements in this release cycle:

  • Argenis
  • argenis de la rosa
  • Claude Opus 4.6

Thank you to everyone who opened issues, reviewed PRs, translated docs, and helped test. Every contribution matters. 🦀


Для полной и исчерпывающей информации (архитектура, все команды, API, разработка) используйте основной английский документ: README.md.