zeroclaw/README.ru.md

ZeroClaw 🦀（Русский）

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

🌐 Языки: English · 简体中文 · 日本語 · Русский

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

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

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

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

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

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

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

Дата (UTC)	Уровень	Объявление	Действие
2026-02-19	Срочно	Мы не аффилированы с openagen/zeroclaw и zeroclaw.org. Домен zeroclaw.org сейчас указывает на fork openagen/zeroclaw, и этот домен/репозиторий выдают себя за наш официальный сайт и проект.	Не доверяйте информации, бинарникам, сборам средств и «официальным» объявлениям из этих источников. Используйте только этот репозиторий и наши верифицированные соцсети.
2026-02-19	Важно	Официальный сайт пока не запущен, и мы уже видим попытки выдавать себя за ZeroClaw. Пожалуйста, не участвуйте в инвестициях, сборах средств или похожих активностях от имени ZeroClaw.	Ориентируйтесь только на этот репозиторий; также следите за X (@zeroclawlabs), Reddit (r/zeroclawlabs), Telegram (@zeroclawlabs), Telegram CN (@zeroclawlabs_cn), Telegram RU (@zeroclawlabs_ru) и 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-агента:

• Нативно на 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	3.4 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 — статические бинарники.

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

Метрики могут меняться вместе с кодом и 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
./bootstrap.sh

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

Подробности: docs/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 --interactive

zeroclaw agent -m "Hello, ZeroClaw!"

# default: 127.0.0.1:3000
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"

Архитектура

Каждая подсистема — это Trait: меняйте реализации через конфигурацию, без изменения кода.

Подсистема	Trait	Встроенные реализации	Расширение
AI-модели	Provider	Каталог через zeroclaw providers (сейчас 28 встроенных + алиасы, плюс пользовательские endpoint)	custom:https://your-api.com (OpenAI-совместимый) или anthropic-custom:https://your-api.com
Каналы	Channel	CLI, Telegram, Discord, Slack, Mattermost, iMessage, Matrix, Signal, WhatsApp, Email, IRC, Lark, DingTalk, QQ, Webhook	Любой messaging API
Память	Memory	SQLite гибридный поиск, PostgreSQL-бэкенд, Lucid-мост, Markdown-файлы, явный none-бэкенд, snapshot/hydrate, опциональный кэш ответов	Любой persistence-бэкенд
Инструменты	Tool	shell/file/memory, cron/schedule, git, pushover, browser, http_request, screenshot/image_info, composio (opt-in), delegate, аппаратные инструменты	Любая функциональность
Наблюдаемость	Observer	Noop, Log, Multi	Prometheus, OTel
Runtime	RuntimeAdapter	Native, Docker (sandbox)	Через adapter; неподдерживаемые kind завершаются с ошибкой
Безопасность	SecurityPolicy	Gateway pairing, sandbox, allowlist, rate limits, scoping файловой системы, шифрование секретов	—
Идентификация	IdentityConfig	OpenClaw (markdown), AIEOS v1.1 (JSON)	Любой формат идентификации
Туннели	Tunnel	None, Cloudflare, Tailscale, ngrok, Custom	Любой tunnel-бинарник
Heartbeat	Engine	HEARTBEAT.md — периодические задачи	—
Навыки	Loader	TOML-манифесты + SKILL.md-инструкции	Пакеты навыков сообщества
Интеграции	Registry	70+ интеграций в 9 категориях	Плагинная система

Поддержка runtime (текущая)

• ✅ Поддерживается сейчас: runtime.kind = "native" или runtime.kind = "docker"
• 🚧 Запланировано, но ещё не реализовано: WASM / edge-runtime

При указании неподдерживаемого runtime.kind ZeroClaw завершается с явной ошибкой, а не молча откатывается к native.

Система памяти (полнофункциональный поисковый движок)

Полностью собственная реализация, ноль внешних зависимостей — без Pinecone, Elasticsearch, LangChain:

Уровень	Реализация
Векторная БД	Embeddings хранятся как BLOB в SQLite, поиск по косинусному сходству
Поиск по ключевым словам	Виртуальные таблицы FTS5 со скорингом BM25
Гибридное слияние	Пользовательская взвешенная функция слияния (vector.rs)
Embeddings	Trait EmbeddingProvider — OpenAI, пользовательский URL или noop
Чанкинг	Построчный Markdown-чанкер с сохранением заголовков
Кэширование	Таблица embedding_cache в SQLite с LRU-вытеснением
Безопасная переиндексация	Атомарная перестройка FTS5 + повторное встраивание отсутствующих векторов

Agent автоматически вспоминает, сохраняет и управляет памятью через инструменты.

[memory]
backend = "sqlite"             # "sqlite", "lucid", "postgres", "markdown", "none"
auto_save = true
embedding_provider = "none"    # "none", "openai", "custom:https://..."
vector_weight = 0.7
keyword_weight = 0.3

Важные security-дефолты

• Gateway по умолчанию: 127.0.0.1:3000
• Pairing обязателен по умолчанию: require_pairing = true
• Публичный bind запрещён по умолчанию: allow_public_bind = false
• Семантика allowlist каналов:
  • [] => deny-by-default
  • ["*"] => allow all (используйте осознанно)

Пример конфигурации

api_key = "sk-..."
default_provider = "openrouter"
default_model = "anthropic/claude-sonnet-4-6"
default_temperature = 0.7

[memory]
backend = "sqlite"
auto_save = true
embedding_provider = "none"

[gateway]
host = "127.0.0.1"
port = 3000
require_pairing = true
allow_public_bind = false

Навигация по документации

• Хаб документации (English): docs/README.md
• Единый TOC docs: docs/SUMMARY.md
• Хаб документации (Русский): docs/README.ru.md
• Справочник команд: docs/commands-reference.md
• Справочник конфигурации: docs/config-reference.md
• Справочник providers: docs/providers-reference.md
• Справочник channels: docs/channels-reference.md
• Операционный runbook: docs/operations-runbook.md
• Устранение неполадок: docs/troubleshooting.md
• Инвентарь и классификация docs: docs/docs-inventory.md
• Снимок triage проекта: docs/project-triage-snapshot-2026-02-18.md

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

• Contribution guide: CONTRIBUTING.md
• PR workflow: docs/pr-workflow.md
• Reviewer playbook: docs/reviewer-playbook.md
• License: MIT (LICENSE, NOTICE)

---

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