FAQ NanoClaw Agent AI

NanoClaw to lekki, otwartoźródłowy osobisty asystent AI zbudowany na Anthropic Claude Agent SDK. Agenci działają w izolowanych kontenerach Linux (Apple Container na macOS, Docker na macOS/Linux). WhatsApp wbudowany, inne kanały przez umiejętności. Oferuje trwałą pamięć SQLite, zaplanowane zadania, dostęp do sieci, automatyzację przeglądarki i roje agentów.

Uruchom 'git clone https://github.com/qwibitai/NanoClaw.git && cd NanoClaw && claude' i użyj /setup w sesji Claude. Claude Code zajmie się zależnościami, uwierzytelnianiem, konfiguracją kontenerów i usługi. Wymaga Node.js 20+ i Claude Code.

NanoClaw jest na tyle mały, by go zrozumieć — jeden proces, kilka plików źródłowych, żadnych mikroserwisów. W przeciwieństwie do rozdętych frameworków, możesz przeczytać cały kod źródłowy. Agenci działają w prawdziwych kontenerach Linux z izolacją systemu plików, nie za kontrolą uprawnień na poziomie aplikacji.

NanoClaw działa wyłącznie na Anthropic Claude Agent SDK. Claude Code jest zainstalowany globalnie wewnątrz każdego kontenera i obsługuje wszystkie interakcje AI. SDK zarządza wyborem modelu wewnętrznie — NanoClaw z założenia korzysta z jednego dostawcy.

WhatsApp to wbudowany kanał (przez bibliotekę Baileys, parowanie kodem QR). Telegram, Discord i Slack można dodać przez umiejętności Claude Code — uruchom /add-telegram, /add-discord lub /add-slack. Umiejętności modyfikują kod źródłowy Twojego forka, dodając czystą, dedykowaną obsługę kanału.

Bezpieczeństwo to podstawowa zasada projektowa. Agenci działają w kontenerach Linux (Apple Container na macOS, Docker na macOS/Linux) z izolacją systemu plików — nie za kontrolą uprawnień na poziomie aplikacji. Sekrety są przekazywane przez stdin JSON i nigdy ładowane do process.env. Listy dozwolonych montowań z wykrywaniem ucieczki przez dowiązania symboliczne. Kontenery działają bez uprawnień root z montowaniem projektu tylko do odczytu.

NanoClaw używa SQLite (better-sqlite3) do trwałego przechowywania — wiadomości, grupy, sesje, zaplanowane zadania i stan routera. Każda grupa ma też własny plik CLAUDE.md jako pamięć per grupa, montowany do kontenera. Nie wymaga zewnętrznej bazy danych.

Tak. NanoClaw działa na macOS i Linux — wszędzie, gdzie działa Node.js 20+ i Docker. Lekki rdzeń TypeScript działa na urządzeniach o niskich zasobach, w tym Raspberry Pi. Wymaga środowiska kontenerowego (Apple Container lub Docker) i klucza Anthropic API.

Roje agentów pozwalają NanoClaw tworzyć zespoły wyspecjalizowanych agentów współpracujących nad złożonymi zadaniami. NanoClaw to pierwszy osobisty asystent AI wspierający roje agentów, zbudowany na funkcji agent-teams Claude Code.

Projekt jest otwartoźródłowy na licencji MIT na github.com/qwibitai/nanoclaw. Sprawdź README, aby poznać wytyczne dotyczące współtworzenia. Wszystkie kontrybucje są mile widziane.

Wbudowane narzędzia są dostarczane przez Claude Code działający wewnątrz kontenerów: polecenia powłoki, odczyt/zapis plików, wyszukiwanie w sieci, przeglądanie stron (Chromium) i delegowanie do agentów (roje). Proces hosta zapewnia zaplanowane zadania (cron), trwałą pamięć SQLite i komunikację WhatsApp. Rozszerzaj funkcjonalność, dodając umiejętności.

Tak. Każdy kontener agenta ma zainstalowany Chromium i agent-browser do automatyzacji przeglądarki. Claude Code może przeszukiwać sieć i przeglądać strony w celu uzyskania informacji w czasie rzeczywistym wewnątrz izolowanego kontenera.

Oficjalne i jedyne zaufane repozytorium to github.com/qwibitai/nanoclaw. Discord społeczności to discord.gg/VDdww8qS42.

macOS i Linux. Wymaga Node.js 20+ i środowiska kontenerowego — Apple Container na macOS lub Docker na macOS/Linux. Windows nie jest oficjalnie obsługiwany, ale może działać przez WSL2 z Docker.

NanoClaw korzysta wyłącznie z Anthropic Claude przez Claude Agent SDK. Ustaw ANTHROPIC_API_KEY w pliku .env lub uwierzytelnij się przez Claude Code OAuth. Nie ma obsługi wielu dostawców — SDK zarządza wyborem modelu wewnętrznie.

README w repozytorium GitHub (github.com/qwibitai/nanoclaw) to główne źródło dokumentacji. Katalog docs/ zawiera specyfikacje architektury, model bezpieczeństwa i listę kontrolną debugowania. Kod źródłowy jest na tyle mały, że możesz poprosić Claude Code o przeprowadzenie Cię przez niego.

Oficjalne kanały: Discord (discord.gg/VDdww8qS42) i GitHub (github.com/qwibitai/nanoclaw). Sprawdź README, aby poznać wszystkie linki społeczności.