NanoClaw

Ваш персональний AI-агент. Безпечний. Легкий. Ваш.

NanoClaw працює безпечно в контейнерах, створений для того, щоб ви могли його зрозуміти та налаштувати під свої потреби.

Почати Приєднатися до Discord

зірок на GitHub

Чому NanoClaw?

NanoClaw надає ту саму основну функціональність у кодовій базі, яку ви дійсно можете зрозуміти.

		OpenClaw
Файлів вихідного коду	15	3 680
Рядків коду	~3 900	434 453
Залежностей	<10	70
Файлів конфігурації	0	53
Час на розуміння	8 хвилин	1–2 тижні
Модель безпеки	Ізоляція на рівні ОС	Перевірки на рівні застосунку
Архітектура	Один процес + ізольовані контейнери	Один процес, спільна пам'ять

Що підтримується

Все, що NanoClaw підтримує з коробки, і нічого зайвого.

💬

Месенджери

WhatsApp, Telegram та інші. Надсилайте повідомлення вашому агенту NanoClaw з телефону через застосунки, якими ви вже користуєтесь.

🔒

Ізоляція контейнерів

Агенти працюють в Apple Container (macOS) або Docker. Вони бачать лише те, що ви явно підключаєте.

🐝

Рої агентів НОВЕ

NanoClaw може створювати команди спеціалізованих агентів, які співпрацюють над складними завданнями. Перший персональний AI з такою підтримкою.

🧠

Пам'ять для кожної групи

Кожна група має власну пам'ять CLAUDE.md, ізольовану файлову систему та працює у власній пісочниці контейнера.

⏰

Заплановані завдання

Повторювані завдання, які запускають Claude і надсилають вам відповідь. Ранкові брифінги, тижневі огляди та інше.

🧩

Система Skills

Розширюйте функціональність без надмірності. Додавайте Gmail, Telegram або власні можливості через skills.

✨

AI-нативне налаштування

Без майстрів установки. Claude Code керує всім: залежності, автентифікація, контейнери, сервіси.

🌐

Доступ до інтернету

NanoClaw може шукати в інтернеті, отримувати вміст та переглядати сторінки для дослідження будь-чого.

Архітектура

NanoClaw — це один процес Node.js. Агенти в ізольованих контейнерах. 15 файлів вихідного коду.

Вхідне повідомлення

WhatsApp / Telegram

SQLite

зберігання та дедуплікація

GroupQueue

FIFO для кожної групи

Контейнер

Claude Agent SDK

Відповідь

потокова передача

Один процес

Один процес Node.js опитує повідомлення, керує чергами, запускає контейнери та обробляє IPC. Без мікросервісів, без брокерів повідомлень.

Ізоляція для кожної групи

Кожна група отримує власний контейнер, файлову систему, простір імен IPC та сесію Claude. Групи не можуть отримати доступ до даних інших груп.

Контроль паралелізму

GroupQueue обмежує паралельні контейнери (за замовчуванням: 3). Порядок FIFO для кожної групи з повторними спробами при збоях з експоненціальною затримкою.

IPC через файлову систему

Контейнери спілкуються з хостом через JSON-файли в директоріях для кожної групи. Хост опитує, перевіряє авторизацію, виконує та очищує.

Ключові файли

index.ts — Оркестратор — цикл опитування, обробка повідомлень, виклик агента

container-runner.ts — Запускає контейнери з ізольованими підключеннями, передає вивід потоком

group-queue.ts — FIFO-черга для кожної групи з лімітами паралелізму та повторними спробами

ipc.ts — Обробляє IPC-запити контейнерів з перевірками авторизації

db.ts — SQLite — повідомлення, сесії, групи, завдання, стан маршрутизатора

task-scheduler.ts — Виконання запланованих завдань: cron, інтервали та одноразові

Філософія

Принципи, які формують кожне рішення в NanoClaw.

🔍

Достатньо малий, щоб зрозуміти

NanoClaw — це один процес, кілька файлів вихідного коду. Достатньо малий, щоб ви могли прочитати та зрозуміти всю кодову базу.

🛡️

Безпечний завдяки ізоляції

Агенти працюють у контейнерах Linux. Вони бачать лише те, що явно підключено. Bash безпечний, бо виконується всередині контейнера.

👤

Створений для одного користувача

NanoClaw — це не монолітний фреймворк. Це робоче програмне забезпечення, яке відповідає вашим потребам. Зробіть Fork, нехай Claude Code адаптує його під вас.

🤖

AI-нативний

Без майстра установки; Claude Code керує налаштуванням. Без дашборда; запитайте Claude. Без інструментів відладки; опишіть проблему.

🧩

Skills замість функцій

Контриб'ютори додають skills для Claude Code, як-от /add-telegram, які трансформують вашу інсталяцію. В результаті ви отримуєте чистий код, який робить саме те, що потрібно.

⚡

Найкраща оболонка, найкраща модель

Працює на Claude Agent SDK, а це означає, що ви запускаєте Claude Code напряму. Оболонка має значення. Хороша оболонка надає розумним моделям суперсили.

Почніть з NanoClaw за 3 рядки

Клонуйте NanoClaw, перейдіть у директорію та дозвольте Claude зробити решту.

Термінал
 $ git clone https://github.com/qwibitai/nanoclaw.git
 $ cd nanoclaw
 $ claude 

Потім запустіть /setup Claude Code бере на себе все: залежності, автентифікацію, налаштування контейнерів, конфігурацію сервісів.

Вимоги

macOS або Linux Node.js 20+ Claude Code Apple Container (macOS) або Docker

У новинах

Питання та відповіді

Чим NanoClaw відрізняється від OpenClaw?

NanoClaw (також відомий як Nano Claw) використовує принципово інший підхід. Тоді як OpenClaw — це масштабний фреймворк з тисячами файлів вихідного коду та десятками залежностей, NanoClaw — це легкий персональний AI-агент, побудований навколо 15 файлів вихідного коду, які можна прочитати та зрозуміти за один присід. NanoClaw використовує ізоляцію контейнерів на рівні ОС (Docker або Apple Container) для ізоляції кожної сесії агента, замість того щоб покладатися на перевірки дозволів на рівні застосунку. Якщо ви шукаєте безпечну, мінімальну альтернативу OpenClaw, яку можна повністю перевірити та налаштувати, NanoClaw створений саме для цього.

Чи безпечний NanoClaw?

Безпека — це основний принцип проєктування. Кожна сесія агента працює всередині ізольованого контейнера Linux з власною файловою системою, простором імен IPC та простором процесів. Агенти мають доступ лише до директорій, які явно підключені, і немає фонового доступу до вашої системи. Оскільки вся кодова база — це приблизно 3 900 рядків коду в 15 файлах, ви реально можете перевірити все, що робить програма. Поєднання ізоляції на рівні контейнерів та невеликої кодової бази, яку можна перевірити, робить NanoClaw одним з найпрозоріших та найбезпечніших способів запуску AI-агентів.

Які месенджери підтримує NanoClaw?

NanoClaw з коробки підтримує WhatsApp і може бути розширений для роботи з Telegram, електронною поштою та іншими каналами через систему skills. Додати Telegram так само просто, як запустити skill /add-telegram, який проведе вас через повне налаштування. Архітектура спроєктована так, що канали обміну повідомленнями є модульними, тому ви можете запускати один або кілька каналів паралельно, кожен зі своєю конфігурацією.

Які середовища виконання контейнерів підтримуються?

NanoClaw підтримує як Apple Container, так і Docker. На macOS Apple Container забезпечує швидку та легку ізоляцію, оптимізовану для Apple silicon, тоді як Docker доступний як альтернатива. На Linux Docker використовується автоматично. Під час початкового процесу /setup ви обираєте, яке середовище виконання використовувати, виходячи з вашої платформи та уподобань.

Чи можна запустити NanoClaw на Linux?

Так. NanoClaw працює як на macOS, так і на Linux. На Linux Docker використовується як середовище виконання контейнерів і налаштовується автоматично під час встановлення. Системні вимоги — Node.js 20 або новіше, Claude Code та середовище виконання контейнерів (Docker на Linux). Skill /setup виконує всі перевірки залежностей та налаштування для вашої платформи.

Як налаштувати NanoClaw?

NanoClaw використовує AI-нативний процес налаштування. Після клонування репозиторію та запуску Claude Code ви запускаєте skill /setup, який проведе вас через встановлення залежностей, автентифікацію каналів обміну повідомленнями, налаштування середовища виконання контейнерів та запуск фонових сервісів. Немає файлів конфігурації для ручного редагування. Claude Code виконує все налаштування в інтерактивному режимі. Для подальших змін ви можете описати, що хочете, і Claude Code внесе зміни безпосередньо в кодову базу.

Як NanoClaw порівнюється з іншими AI-агентними фреймворками?

Більшість AI-агентних фреймворків розроблені для команд, що створюють продукти. Вони великі, складні та потребують значних зусиль для розуміння. NanoClaw створений для окремих користувачів, які хочуть мати персонального AI-асистента, яким вони повністю володіють та керують. Він працює як один процес Node.js, використовує справжню ізоляцію контейнерів замість ізоляції на рівні застосунку, і достатньо малий, щоб його повністю зрозуміти. Він працює на Claude Agent SDK, що дає вам прямий доступ до можливостей Claude без шарів абстракції.

Чи є NanoClaw відкритим програмним забезпеченням?

Так. Nano Claw — це повністю відкрите програмне забезпечення під ліцензією MIT. Вся кодова база доступна на GitHub, і внески вітаються. Проєкт заохочує Fork та налаштування. Філософія полягає в тому, що ваш персональний AI-агент має бути робочим програмним забезпеченням, адаптованим до ваших точних потреб, а не універсальним фреймворком для налаштування.