Przewodnik instalacji

Uruchom NanoClaw

Lekki rdzeń TypeScript, jedna ścieżka instalacji. Sklonuj, uruchom claude, użyj /setup.

checklist Wymagania systemowe

javascript Node.js

Node.js 20+ (zalecana wersja LTS)

computer OS

macOS lub Linux. Windows przez WSL2 może działać, ale nie jest oficjalnie obsługiwany.

memory RAM

512MB+ RAM. Lekkie środowisko uruchomieniowe, bez ciężkiej kompilacji.

hard_drive Disk

~50MB po instalacji (node_modules). Obraz kontenera dodaje ~500MB.

extension Optional

Wymagane: Apple Container (macOS) lub Docker (macOS/Linux). Wymagane: Claude Code CLI.

wifi Network

Wymagany internet do wywołań Anthropic API. Brak trybu offline.

Sklonuj repozytorium i rozpocznij z Claude CLI. Gotowe w kilka minut.

bolt

One-Liner

Requires Claude CLI. All platforms.

$ git clone https://github.com/qwibitai/NanoClaw.git && cd NanoClaw && claude
list_alt

Step-by-Step

Clone first, then configure. More control.

$ git clone https://github.com/qwibitai/NanoClaw.git
$ cd NanoClaw && npm install
$ # Run claude and use /setup for guided configuration
$ # Or edit .env and src/index.ts directly

verified Zweryfikuj instalację

Uruchom te polecenia, aby potwierdzić poprawną instalację NanoClaw.

1
$ node -e "console.log(require('./package.json').version)"

Powinno wyświetlić zainstalowany numer wersji.

2
$ npm test

Uruchamia zestaw testów (vitest), aby zweryfikować zależności i podstawową funkcjonalność.

3
$ claude

Otwiera Claude Code. Uruchom /setup w sesji, aby przeprowadzić konfigurację krok po kroku.

settings Konfiguracja początkowa

Claude Code obsługuje konfigurację przez /setup. Oto co konfiguruje.

1

Zainstaluj zależności

Claude Code uruchamia npm install i buduje obraz kontenera (nanoclaw-agent:latest) z preinstalowanym Chromium, agent-browser i Claude Code.

2

Uwierzytelnij

Ustaw ANTHROPIC_API_KEY w .env lub uwierzytelnij się przez Claude Code OAuth. Sekrety są przekazywane do kontenerów w czasie wykonania, nigdy ładowane do process.env.

3

Połącz WhatsApp

Uruchom 'npm run auth', aby sparować przez kod QR. WhatsApp to wbudowany kanał. Dodaj Telegram, Discord lub Slack później przez umiejętności (/add-telegram, /add-discord, /add-slack).

4

Uruchom agenta

Uruchom 'npm start', aby wystartować NanoClaw. Łączy się z WhatsApp, uruchamia pętlę odpytywania wiadomości i zaczyna przetwarzać wiadomości w izolowanych kontenerach.

.env — NanoClaw nie używa plików konfiguracyjnych. Aby wprowadzić zmiany, powiedz Claude Code, czego potrzebujesz. Kod źródłowy jest na tyle mały, że Claude może go bezpiecznie modyfikować.

system_update_alt Aktualizacja NanoClaw

Aktualizuj NanoClaw, aby korzystać z najnowszych funkcji, integracji i poprawek bezpieczeństwa.

Git + npm
$ cd NanoClaw && git pull && npm install
Docker
$ cd NanoClaw && git pull && docker compose up --build

Sprawdź dziennik zmian na github.com/qwibitai/nanoclaw/releases, aby zobaczyć nowości w każdej wersji.

build Rozwiązywanie problemów

Częste problemy i sposoby ich rozwiązania.

Potrzebujesz pomocy?

Dołącz do naszej społeczności, aby uzyskać wsparcie przy instalacji i rozwiązywaniu problemów.

Bądź na bieżąco

Otrzymuj informacje o nowych wydaniach, integracjach i rozwoju NanoClaw. Bez spamu, wypisz się w dowolnym momencie.