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

Нуль накладних витрат. Нуль компромісів. 100% Rust. 100% Агностичний.
⚡️ Працює на обладнанні за $10 з <5MB RAM: це на 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 — це персональний AI-асистент, який ви запускаєте на власних пристроях. Він відповідає вам у каналах, які ви вже використовуєте (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.sh --api-key "sk-..." --provider openrouter

# Запуск gateway (вебхук-сервер + веб-панель)
zeroclaw gateway                # за замовчуванням: 127.0.0.1:42617
zeroclaw gateway --port 0       # випадковий порт (посилена безпека)

# Розмова з асистентом
zeroclaw agent -m "Hello, ZeroClaw!"

# Інтерактивний режим
zeroclaw agent

# Запуск повного автономного середовища (gateway + канали + cron + hands)
zeroclaw daemon

# Перевірка статусу
zeroclaw status

# Запуск діагностики
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:

# Попередній перегляд того, що буде мігровано (безпечно, лише читання)
zeroclaw migrate openclaw --dry-run

# Виконання міграції
zeroclaw migrate openclaw

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

ZeroClaw підключається до реальних платформ обміну повідомленнями. Розглядайте вхідні DM як ненадійний ввід.

Повний посібник з безпеки: SECURITY.md

Поведінка за замовчуванням на всіх каналах:

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

Рівні автономності:

Шари ізоляції: ізоляція робочого простору, блокування обходу шляху, списки дозволених команд, заборонені шляхи (/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, file 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 (зазвичай ~390MB додаткових накладних витрат пам'яті), тоді як NanoBot вимагає середовище Python. PicoClaw і ZeroClaw — це статичні бінарні файли. Наведені цифри RAM — це пам'ять часу виконання; вимоги до компіляції вищі.

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, file read/write/edit, git operations, glob search, content search
• Веб: browser control, web fetch, web search, screenshot, image info, PDF read
• Інтеграції: Jira, Notion, Google Workspace, Microsoft 365, LinkedIn, Composio, Pushover
• MCP: Model Context Protocol tool wrapper + відкладені набори інструментів
• Планування: cron add/remove/update/run, schedule tool
• Пам'ять: recall, store, forget, knowledge, project intel
• Розширені: delegate (агент-агенту), swarm, model switch/routing, security ops, cloud ops
• Апаратне забезпечення: board info, memory map, memory read (з feature-гейтом)

• Рівні автономності: ReadOnly, Supervised (за замовчуванням), Full.
• Ізоляція: ізоляція робочого простору, блокування обходу шляху, списки дозволених команд, заборонені шляхи, Landlock (Linux), Bubblewrap.
• Обмеження частоти: максимум дій на годину, максимум витрат на день (налаштовуване).
• Затвердження операцій: інтерактивне затвердження для операцій середнього/високого ризику.
• Екстрена зупинка: можливість екстреного вимкнення.
• 129+ тестів безпеки в автоматизованому CI.

• Веб-панель, що обслуговується безпосередньо з Gateway.
• Підтримка тунелів: Cloudflare, Tailscale, ngrok, OpenVPN, власна команда.
• Docker runtime adapter для контейнерного виконання.
• CI/CD: beta (автоматично при push) → stable (ручний запуск) → Docker, crates.io, Scoop, AUR, Homebrew, tweet.
• Попередньо зібрані бінарні файли для 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"  # або "tailscale", "ngrok", "openvpn", "custom", "none"

Деталі: Довідник каналів · Довідник конфігурації

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

Встановіть runtime.kind = "docker" для суворої ізоляції або мережевої ізоляції.

ZeroClaw підтримує профілі авторизації на основі підписки (мультиакаунт, шифрування в стані спокою).

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

# OpenAI Codex OAuth (підписка ChatGPT)
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

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

# Запуск агента з авторизацією підписки
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.

# Список встановлених навичок
zeroclaw skills list

# Встановлення з git
zeroclaw skills install https://github.com/user/my-skill.git

# Аудит безпеки перед встановленням
zeroclaw skills audit https://github.com/user/my-skill.git

# Видалення навички
zeroclaw skills remove my-skill

# Керування робочим простором
zeroclaw onboard              # Покроковий майстер налаштування
zeroclaw status               # Показати стан демона/агента
zeroclaw doctor               # Запустити діагностику системи

# Gateway + демон
zeroclaw gateway              # Запустити сервер gateway (127.0.0.1:42617)
zeroclaw daemon               # Запустити повне автономне середовище

# Агент
zeroclaw agent                # Інтерактивний режим чату
zeroclaw agent -m "message"   # Режим одного повідомлення

# Керування сервісом
zeroclaw service install      # Встановити як системний сервіс (launchd/systemd)
zeroclaw service start|stop|restart|status

# Канали
zeroclaw channel list         # Список налаштованих каналів
zeroclaw channel doctor       # Перевірка стану каналів
zeroclaw channel bind-telegram 123456789

# Cron + планування
zeroclaw cron list            # Список запланованих завдань
zeroclaw cron add "*/5 * * * *" --prompt "Check system health"
zeroclaw cron remove <id>

# Пам'ять
zeroclaw memory list          # Список записів пам'яті
zeroclaw memory get <key>     # Отримати запис пам'яті
zeroclaw memory stats         # Статистика пам'яті

# Профілі авторизації
zeroclaw auth login --provider <name>
zeroclaw auth status
zeroclaw auth use --provider <name> --profile <profile>

# Апаратні периферійні пристрої
zeroclaw hardware discover    # Сканування підключених пристроїв
zeroclaw peripheral list      # Список підключених периферійних пристроїв
zeroclaw peripheral flash     # Прошивка пристрою

# Міграція
zeroclaw migrate openclaw --dry-run
zeroclaw migrate openclaw

# Автодоповнення оболонки
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 🦀, швидкого та ефективного AI-асистента. Створений Argenis De La Rosa та спільнотою.

• zeroclawlabs.ai
• @zeroclawlabs

Якщо ZeroClaw допомагає вашій роботі і ви хочете підтримати подальшу розробку, ви можете зробити пожертву тут:

Щира подяка спільнотам та установам, які надихають та живлять цю відкриту роботу:

• Harvard University — за виховання інтелектуальної допитливості та розширення меж можливого.
• MIT — за підтримку відкритих знань, відкритого коду та переконання, що технології повинні бути доступними для кожного.
• Sundai Club — за спільноту, енергію та невпинне прагнення створювати речі, що мають значення.
• Світ та за його межами — кожному учаснику, мрійнику та творцю, які роблять відкритий код силою добра. Це для вас.

Ми будуємо відкрито, тому що найкращі ідеї приходять звідусіль. Якщо ви це читаєте, ви вже частина цього. Ласкаво просимо. 🦀

Новачок у ZeroClaw? Шукайте завдання з міткою good first issue — дивіться наш Посібник з внеску для початку. PR з AI-допомогою вітаються!

Дивіться 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 і оновлюється автоматично.