NanoClaw

Twój osobisty agent AI. Bezpieczny. Lekki. Twój.

NanoClaw działa bezpiecznie w kontenerach, stworzony do zrozumienia i dostosowania do Twoich potrzeb.

gwiazdek na GitHub

Dlaczego NanoClaw?

NanoClaw dostarcza tę samą podstawową funkcjonalność w kodzie, który faktycznie możesz zrozumieć.

NanoClaw
OpenClaw
Pliki źródłowe 15 3 680
Linii kodu ~3 900 434 453
Zależności <10 70
Pliki konfiguracyjne 0 53
Czas na zrozumienie 8 minut 1–2 tygodnie
Model bezpieczeństwa Izolacja kontenerowa na poziomie OS Kontrole na poziomie aplikacji
Architektura Pojedynczy proces + izolowane kontenery Pojedynczy proces, współdzielona pamięć

Co Obsługuje

Wszystko, co NanoClaw obsługuje od razu, i nic, czego nie potrzebujesz.

💬

Komunikatory

WhatsApp, Telegram i więcej. Pisz do swojego agenta NanoClaw z telefonu przez aplikacje, których już używasz.

🔒

Izolacja Kontenerowa

Agenci działają w Apple Container (macOS) lub Docker. Widzą tylko to, co jawnie podmontujesz.

🐝

Roje Agentów NOWOŚĆ

NanoClaw może tworzyć zespoły wyspecjalizowanych agentów współpracujących nad złożonymi zadaniami. Pierwszy osobisty AI, który to obsługuje.

🧠

Pamięć Per-Grupa

Każda grupa ma własną pamięć CLAUDE.md, izolowany system plików i działa we własnym sandboxie kontenerowym.

Zaplanowane Zadania

Cykliczne zadania uruchamiające Claude i odsyłające Ci wiadomość. Poranne briefingi, cotygodniowe przeglądy i więcej.

🧩

System Umiejętności

Rozszerzaj funkcjonalność bez nadmiaru. Dodawaj Gmail, Telegram lub niestandardowe możliwości przez umiejętności.

Natywna Konfiguracja AI

Bez kreatorów instalacji. Claude Code prowadzi przez wszystko: zależności, uwierzytelnianie, kontenery, usługi.

🌐

Dostęp do Sieci

NanoClaw może przeszukiwać sieć, pobierać treści i przeglądać strony, aby badać dowolny temat.

Architektura

NanoClaw to pojedynczy proces Node.js. Agenci w izolowanych kontenerach. 15 plików źródłowych.

Wiadomość Przychodząca
WhatsApp / Telegram
SQLite
przechowuj i deduplikuj
Kolejka Grup
FIFO per-grupa
Kontener
Claude Agent SDK
Odpowiedź
strumieniowana z powrotem

Pojedynczy Proces

Jeden proces Node.js odpytuje wiadomości, zarządza kolejkami, uruchamia kontenery i obsługuje IPC. Bez mikroserwisów, bez brokerów wiadomości.

Izolacja Per-Grupa

Każda grupa otrzymuje własny kontener, system plików, przestrzeń nazw IPC i sesję Claude. Grupy nie mają dostępu do danych innych grup.

Kontrola Współbieżności

GroupQueue ogranicza liczbę jednoczesnych kontenerów (domyślnie: 3). Kolejkowanie FIFO per-grupa z ponownymi próbami przy niepowodzeniu z wykładniczym wycofywaniem.

IPC przez System Plików

Kontenery komunikują się z hostem przez pliki JSON w katalogach per-grupa. Host odpytuje, weryfikuje autoryzację, wykonuje i czyści.

Kluczowe Pliki

index.ts — Orkiestrator — pętla odpytywania, przetwarzanie wiadomości, wywoływanie agenta
container-runner.ts — Uruchamia kontenery z izolowanymi montowaniami, strumieniuje wyjście
group-queue.ts — Kolejka FIFO per-grupa z limitami współbieżności i wycofywaniem przy ponownych próbach
ipc.ts — Przetwarza żądania IPC kontenerów z kontrolami autoryzacji
db.ts — SQLite — wiadomości, sesje, grupy, zadania, stan routera
task-scheduler.ts — Wykonywanie zaplanowanych zadań: cron, interwałowe i jednorazowe

Filozofia

Zasady kształtujące każdą decyzję w NanoClaw.

🔍

Wystarczająco mały, by zrozumieć

NanoClaw to jeden proces, garść plików źródłowych. Wystarczająco mały, byś mógł przeczytać i zrozumieć całą bazę kodu.

🛡️

Bezpieczny przez izolację

Agenci działają w kontenerach Linux. Widzą tylko to, co jest jawnie podmontowane. Bash jest bezpieczny, ponieważ działa wewnątrz kontenera.

👤

Stworzony dla jednego użytkownika

NanoClaw nie jest monolitycznym frameworkiem. To działające oprogramowanie dopasowane do Twoich potrzeb. Sforkuj go, niech Claude Code dostosuje go do Ciebie.

🤖

Natywnie AI

Bez kreatora instalacji; Claude Code prowadzi konfigurację. Bez panelu; zapytaj Claude. Bez narzędzi do debugowania; opisz problem.

🧩

Umiejętności zamiast funkcji

Współtwórcy dodają umiejętności Claude Code, takie jak /add-telegram, które przekształcają Twoją instalację. Otrzymujesz czysty kod robiący dokładnie to, czego potrzebujesz.

Najlepszy silnik, najlepszy model

Działa na Claude Agent SDK, co oznacza, że uruchamiasz bezpośrednio Claude Code. Silnik ma znaczenie. Dobry silnik daje inteligentnym modelom supermoce.

Rozpocznij z NanoClaw w 3 Liniach

Sklonuj NanoClaw, wejdź do katalogu i pozwól Claude zająć się resztą.

Terminal
$ git clone https://github.com/qwibitai/nanoclaw.git
$ cd nanoclaw
$ claude

Następnie uruchom /setup Claude Code zajmuje się wszystkim: zależnościami, uwierzytelnianiem, konfiguracją kontenerów, konfiguracją usług.

Wymagania

macOS lub Linux Node.js 20+ Claude Code Apple Container (macOS) lub Docker

W Mediach

FAQ

Czym NanoClaw różni się od OpenClaw?

NanoClaw (znany również jako Nano Claw) przyjmuje fundamentalnie inne podejście. Podczas gdy OpenClaw to wielkoskalowy framework z tysiącami plików źródłowych i dziesiątkami zależności, NanoClaw to lekki, osobisty agent AI zbudowany wokół 15 plików źródłowych, które możesz przeczytać i zrozumieć w jednym posiedzeniu. NanoClaw używa izolacji kontenerowej na poziomie systemu operacyjnego (Docker lub Apple Container) do sandboxowania każdej sesji agenta, zamiast polegać na kontrolach uprawnień na poziomie aplikacji. Jeśli szukasz bezpiecznej, minimalnej alternatywy dla OpenClaw, którą możesz w pełni audytować i dostosowywać, NanoClaw jest zaprojektowany właśnie do tego.

Czy NanoClaw jest bezpieczny?

Bezpieczeństwo jest podstawową zasadą projektową. Każda sesja agenta działa wewnątrz izolowanego kontenera Linux z własnym systemem plików, przestrzenią nazw IPC i przestrzenią procesów. Agenci mogą uzyskać dostęp tylko do katalogów, które są jawnie podmontowane, i nie ma żadnego domyślnego dostępu do Twojego systemu. Ponieważ cała baza kodu to około 3 900 linii kodu w 15 plikach, możesz realistycznie audytować wszystko, co oprogramowanie robi. Ta kombinacja izolacji na poziomie kontenera i małej, audytowalnej bazy kodu czyni NanoClaw jednym z najbardziej przejrzystych i bezpiecznych sposobów uruchamiania agentów AI.

Jakie komunikatory obsługuje NanoClaw?

NanoClaw jest dostarczany z obsługą WhatsApp od razu i może być rozszerzony o Telegram, e-mail i inne kanały przez system umiejętności. Dodanie Telegram jest tak proste jak uruchomienie umiejętności /add-telegram, która przeprowadzi Cię przez pełną konfigurację. Architektura jest zaprojektowana tak, aby kanały komunikacyjne były modułowe, dzięki czemu możesz uruchamiać jeden lub wiele kanałów równolegle, każdy z własną konfiguracją.

Jakie środowiska uruchomieniowe kontenerów są obsługiwane?

NanoClaw obsługuje zarówno Apple Container, jak i Docker. Na macOS Apple Container zapewnia szybki, lekki sandboxing zoptymalizowany pod Apple silicon, podczas gdy Docker jest dostępny jako alternatywa. Na Linuxie Docker jest używany automatycznie. Podczas początkowego procesu /setup wybierasz środowisko uruchomieniowe na podstawie swojej platformy i preferencji.

Czy mogę uruchomić NanoClaw na Linuxie?

Tak. NanoClaw działa zarówno na macOS, jak i na Linuxie. Na Linuxie Docker jest używany jako środowisko uruchomieniowe kontenerów i jest konfigurowany automatycznie podczas instalacji. Wymagania systemowe to Node.js 20 lub nowszy, Claude Code i środowisko uruchomieniowe kontenerów (Docker na Linuxie). Umiejętność /setup obsługuje wszystkie kontrole zależności i konfigurację dla Twojej platformy.

Jak skonfigurować NanoClaw?

NanoClaw wykorzystuje natywny proces konfiguracji AI. Po sklonowaniu repozytorium i uruchomieniu Claude Code uruchamiasz umiejętność /setup, która przeprowadzi Cię przez instalację zależności, uwierzytelnianie kanałów komunikacyjnych, konfigurację środowiska uruchomieniowego kontenerów i uruchamianie usług w tle. Nie ma ręcznych plików konfiguracyjnych do edycji. Claude Code obsługuje całą konfigurację interaktywnie. W przypadku bieżących zmian możesz opisać, czego chcesz, a Claude Code wprowadzi modyfikacje bezpośrednio w bazie kodu.

Jak NanoClaw wypada na tle innych frameworków agentów AI?

Większość frameworków agentów AI jest zaprojektowana dla zespołów budujących produkty. Są duże, złożone i wymagają znacznych nakładów, aby je zrozumieć. NanoClaw jest zaprojektowany dla osób, które chcą osobistego asystenta AI, którego w pełni posiadają i kontrolują. Działa jako pojedynczy proces Node.js, używa prawdziwej izolacji kontenerowej zamiast sandboxingu na poziomie aplikacji i jest wystarczająco mały, by go całkowicie zrozumieć. Działa na Claude Agent SDK, dając bezpośredni dostęp do możliwości Claude bez warstw abstrakcji.

Czy NanoClaw jest open source?

Tak. Nano Claw jest w pełni open source na licencji MIT. Cała baza kodu jest dostępna na GitHub, a kontrybucje są mile widziane. Projekt zachęca do forkowania i dostosowywania. Filozofia jest taka, że Twój osobisty agent AI powinien być działającym oprogramowaniem dostosowanym do Twoich dokładnych potrzeb, a nie generycznym frameworkiem, który konfigurujesz.