🦀 ZeroClaw — Osobisty Asystent AI

Zero narzutu. Zero kompromisów. 100% Rust. 100% Agnostyczny.
⚡️ Działa na sprzęcie za $10 z <5MB RAM: To 99% mniej pamięci niż OpenClaw i 98% taniej niż Mac mini!

Stworzone przez studentów i członków społeczności Harvard, MIT i Sundai.Club.

🌐 Języki: 🇺🇸 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 to osobisty asystent AI, który uruchamiasz na własnych urządzeniach. Odpowiada na kanałach, których już używasz (WhatsApp, Telegram, Slack, Discord, Signal, iMessage, Matrix, IRC, Email, Bluesky, Nostr, Mattermost, Nextcloud Talk, DingTalk, Lark, QQ, Reddit, LinkedIn, Twitter, MQTT, WeChat Work i więcej). Posiada panel webowy do kontroli w czasie rzeczywistym i może łączyć się z peryferiami sprzętowymi (ESP32, STM32, Arduino, Raspberry Pi). Gateway to tylko warstwa sterowania — produktem jest asystent.

Jeśli szukasz osobistego, jednoosobowego asystenta, który działa lokalnie, szybko i jest zawsze dostępny — to jest to.

Strona internetowa · Dokumentacja · Architektura · Rozpocznij · Migracja z OpenClaw · Rozwiązywanie problemów · Discord

Zalecana konfiguracja: uruchom zeroclaw onboard w terminalu. ZeroClaw Onboard prowadzi Cię krok po kroku przez konfigurację gateway, workspace, kanałów i dostawcy. Jest to zalecana ścieżka konfiguracji i działa na macOS, Linux i Windows (przez WSL2). Nowa instalacja? Zacznij tutaj: Rozpocznij

• OpenAI Codex (subskrypcja ChatGPT)
• Gemini (Google OAuth)
• Anthropic (klucz API lub token autoryzacyjny)

Uwaga dotycząca modeli: chociaż obsługiwanych jest wielu dostawców/modeli, dla najlepszego doświadczenia używaj najsilniejszego dostępnego modelu najnowszej generacji. Zobacz Onboarding.

Konfiguracja modeli + CLI: Dokumentacja dostawców Rotacja profili autoryzacyjnych (OAuth vs klucze API) + failover: Failover modeli

Środowisko uruchomieniowe: stabilny toolchain Rust. Pojedynczy plik binarny, brak zależności runtime.

brew install zeroclaw

git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw
./install.sh

zeroclaw onboard uruchamia się automatycznie po instalacji, aby skonfigurować workspace i dostawcę.

Pełny przewodnik dla początkujących (autoryzacja, parowanie, kanały): Rozpocznij

# Instalacja + onboarding
./install.sh --api-key "sk-..." --provider openrouter

# Uruchom gateway (serwer webhook + panel webowy)
zeroclaw gateway                # domyślnie: 127.0.0.1:42617
zeroclaw gateway --port 0       # losowy port (wzmocnione bezpieczeństwo)

# Porozmawiaj z asystentem
zeroclaw agent -m "Hello, ZeroClaw!"

# Tryb interaktywny
zeroclaw agent

# Uruchom pełne autonomiczne środowisko (gateway + kanały + cron + hands)
zeroclaw daemon

# Sprawdź status
zeroclaw status

# Uruchom diagnostykę
zeroclaw doctor

Aktualizujesz? Uruchom zeroclaw doctor po aktualizacji.

git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw

cargo build --release --locked
cargo install --path . --force --locked

zeroclaw onboard

Tryb deweloperski (bez globalnej instalacji): poprzedź komendy cargo run --release -- (przykład: cargo run --release -- status).

ZeroClaw może zaimportować Twój workspace, pamięć i konfigurację OpenClaw:

# Podgląd tego, co zostanie zmigrowane (bezpieczne, tylko odczyt)
zeroclaw migrate openclaw --dry-run

# Uruchom migrację
zeroclaw migrate openclaw

Migruje wpisy pamięci, pliki workspace i konfigurację z ~/.openclaw/ do ~/.zeroclaw/. Konfiguracja jest automatycznie konwertowana z JSON do TOML.

ZeroClaw łączy się z prawdziwymi platformami komunikacyjnymi. Traktuj przychodzące DM jako niezaufane dane wejściowe.

Pełny przewodnik bezpieczeństwa: SECURITY.md

Domyślne zachowanie na wszystkich kanałach:

• Parowanie DM (domyślne): nieznani nadawcy otrzymują krótki kod parowania i bot nie przetwarza ich wiadomości.
• Zatwierdź za pomocą: zeroclaw pairing approve <channel> <code> (wtedy nadawca jest dodawany do lokalnej listy dozwolonych).
• Publiczne przychodzące DM wymagają jawnej zgody w config.toml.
• Uruchom zeroclaw doctor, aby wykryć ryzykowne lub błędnie skonfigurowane polityki DM.

Poziomy autonomii:

Warstwy sandboxingu: izolacja workspace, blokowanie przechodzenia ścieżek, lista dozwolonych poleceń, zabronione ścieżki (/etc, /root, ~/.ssh), ograniczenie szybkości (maks. akcji/godzinę, limity kosztów/dzień).

Użyj tej tablicy do ważnych ogłoszeń (zmiany łamiące, porady bezpieczeństwa, okna serwisowe i blokery wydań).

• Lekkie środowisko uruchomieniowe domyślnie — typowe workflow CLI i statusu działają w kopercie pamięci kilku megabajtów na buildach release.
• Ekonomiczne wdrożenie — zaprojektowane dla płytek za $10 i małych instancji chmurowych, bez ciężkich zależności runtime.
• Szybki zimny start — jednoplikowe środowisko Rust utrzymuje start komend i demona niemal natychmiastowy.
• Przenośna architektura — jeden plik binarny na ARM, x86 i RISC-V z wymiennymi dostawcami/kanałami/narzędziami.
• Gateway lokalny — pojedyncza warstwa sterowania dla sesji, kanałów, narzędzi, cron, SOP i zdarzeń.
• Wielokanałowa skrzynka odbiorcza — WhatsApp, Telegram, Slack, Discord, Signal, iMessage, Matrix, IRC, Email, Bluesky, Nostr, Mattermost, Nextcloud Talk, DingTalk, Lark, QQ, Reddit, LinkedIn, Twitter, MQTT, WeChat Work, WebSocket i więcej.
• Orkiestracja wielu agentów (Hands) — autonomiczne roje agentów, które działają według harmonogramu i stają się inteligentniejsze z czasem.
• Standardowe Procedury Operacyjne (SOP) — automatyzacja workflow sterowana zdarzeniami z wyzwalaczami MQTT, webhook, cron i peryferiami.
• Panel webowy — interfejs React 19 + Vite z czatem w czasie rzeczywistym, przeglądarką pamięci, edytorem konfiguracji, menedżerem cron i inspektorem narzędzi.
• Peryferia sprzętowe — ESP32, STM32 Nucleo, Arduino, Raspberry Pi GPIO przez trait Peripheral.
• Narzędzia pierwszej klasy — shell, plik I/O, przeglądarka, git, web fetch/search, MCP, Jira, Notion, Google Workspace i 70+ więcej.
• Hooki cyklu życia — przechwytuj i modyfikuj wywołania LLM, wykonania narzędzi i wiadomości na każdym etapie.
• Platforma umiejętności — wbudowane, społecznościowe i workspace skills z audytem bezpieczeństwa.
• Obsługa tuneli — Cloudflare, Tailscale, ngrok, OpenVPN i niestandardowe tunele do zdalnego dostępu.

• Lekki domyślnie: mały plik binarny Rust, szybki start, niskie zużycie pamięci.
• Bezpieczny z założenia: parowanie, ścisły sandboxing, jawne listy dozwolonych, izolacja workspace.
• W pełni wymienny: podstawowe systemy to traity (dostawcy, kanały, narzędzia, pamięć, tunele).
• Brak vendor lock-in: obsługa dostawców kompatybilnych z OpenAI + podłączalne niestandardowe endpointy.

Szybki benchmark na maszynie lokalnej (macOS arm64, luty 2026) znormalizowany dla sprzętu edge 0.8GHz.

Uwagi: Wyniki ZeroClaw są mierzone na buildach release przy użyciu /usr/bin/time -l. OpenClaw wymaga środowiska Node.js (typowo ~390MB dodatkowego narzutu pamięci), natomiast NanoBot wymaga środowiska Python. PicoClaw i ZeroClaw to statyczne pliki binarne. Powyższe wartości RAM dotyczą pamięci runtime; wymagania kompilacji są wyższe.

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 warstwa sterowania z sesjami, obecnością, konfiguracją, cron, webhookami, panelem webowym i parowaniem.
• Interfejs CLI: gateway, agent, onboard, doctor, status, service, migrate, auth, cron, channel, skills.
• Pętla orkiestracji agenta z dispatchem narzędzi, konstrukcją promptów, klasyfikacją wiadomości i ładowaniem pamięci.
• Model sesji z egzekwowaniem polityki bezpieczeństwa, poziomami autonomii i bramkowaniem zatwierdzeń.
• Odporny wrapper dostawcy z failoverem, ponawianiem i routingiem modeli na 20+ backendach LLM.

Kanały: WhatsApp (natywny), 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.

Za bramkami feature: Matrix (channel-matrix), Lark (channel-lark), Nostr (channel-nostr).

Panel webowy React 19 + Vite 6 + Tailwind CSS 4 serwowany bezpośrednio z Gateway:

• Dashboard — przegląd systemu, status zdrowia, uptime, śledzenie kosztów
• Czat z agentem — interaktywny czat z agentem
• Pamięć — przeglądanie i zarządzanie wpisami pamięci
• Konfiguracja — podgląd i edycja konfiguracji
• Cron — zarządzanie zaplanowanymi zadaniami
• Narzędzia — przeglądanie dostępnych narzędzi
• Logi — podgląd logów aktywności agenta
• Koszty — użycie tokenów i śledzenie kosztów
• Doctor — diagnostyka zdrowia systemu
• Integracje — status i konfiguracja integracji
• Parowanie — zarządzanie parowaniem urządzeń

• Podstawowe: shell, odczyt/zapis/edycja plików, operacje git, wyszukiwanie glob, wyszukiwanie treści
• Web: sterowanie przeglądarką, web fetch, wyszukiwanie web, zrzut ekranu, info o obrazie, odczyt PDF
• Integracje: Jira, Notion, Google Workspace, Microsoft 365, LinkedIn, Composio, Pushover
• MCP: wrapper narzędzi Model Context Protocol + odroczone zestawy narzędzi
• Planowanie: cron add/remove/update/run, narzędzie planowania
• Pamięć: recall, store, forget, knowledge, project intel
• Zaawansowane: delegate (agent-to-agent), swarm, model switch/routing, security ops, cloud ops
• Sprzęt: board info, memory map, memory read (za bramką feature)

• Poziomy autonomii: ReadOnly, Supervised (domyślny), Full.
• Sandboxing: izolacja workspace, blokowanie przechodzenia ścieżek, listy dozwolonych poleceń, zabronione ścieżki, Landlock (Linux), Bubblewrap.
• Ograniczenie szybkości: maks. akcji na godzinę, maks. koszt na dzień (konfigurowalne).
• Bramkowanie zatwierdzeń: interaktywne zatwierdzanie operacji średniego/wysokiego ryzyka.
• E-stop: możliwość awaryjnego wyłączenia.
• 129+ testów bezpieczeństwa w automatycznym CI.

• Panel webowy serwowany bezpośrednio z Gateway.
• Obsługa tuneli: Cloudflare, Tailscale, ngrok, OpenVPN, niestandardowe polecenie.
• Adapter runtime Docker do konteneryzowanego wykonywania.
• CI/CD: beta (auto na push) → stable (ręczny dispatch) → Docker, crates.io, Scoop, AUR, Homebrew, tweet.
• Gotowe pliki binarne dla Linux (x86_64, aarch64, armv7), macOS (x86_64, aarch64), Windows (x86_64).

Minimalna ~/.zeroclaw/config.toml:

default_provider = "anthropic"
api_key = "sk-ant-..."

Pełna dokumentacja konfiguracji: 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"  # lub "tailscale", "ngrok", "openvpn", "custom", "none"

Szczegóły: Dokumentacja kanałów · Dokumentacja konfiguracji

• native (domyślny) — bezpośrednie wykonywanie procesów, najszybsza ścieżka, idealne dla zaufanych środowisk.
• docker — pełna izolacja kontenerowa, wymuszone polityki bezpieczeństwa, wymaga Docker.

Ustaw runtime.kind = "docker" dla ścisłego sandboxingu lub izolacji sieciowej.

ZeroClaw obsługuje natywne profile autoryzacyjne subskrypcji (wiele kont, szyfrowanie w spoczynku).

• Plik przechowywania: ~/.zeroclaw/auth-profiles.json
• Klucz szyfrowania: ~/.zeroclaw/.secret_key
• Format ID profilu: <provider>:<profile_name> (przykład: openai-codex:work)

# OpenAI Codex OAuth (subskrypcja 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

# Sprawdź / odśwież / przełącz profil
zeroclaw auth status
zeroclaw auth refresh --provider openai-codex --profile default
zeroclaw auth use --provider openai-codex --profile work

# Uruchom agenta z autoryzacją subskrypcji
zeroclaw agent --provider openai-codex -m "hello"
zeroclaw agent --provider anthropic -m "hello"

Katalog główny workspace: ~/.zeroclaw/workspace/ (konfigurowalne przez config).

Wstrzykiwane pliki promptów:

• IDENTITY.md — osobowość i rola agenta
• USER.md — kontekst i preferencje użytkownika
• MEMORY.md — długoterminowe fakty i lekcje
• AGENTS.md — konwencje sesji i reguły inicjalizacji
• SOUL.md — podstawowa tożsamość i zasady działania

Umiejętności: ~/.zeroclaw/workspace/skills/<skill>/SKILL.md lub SKILL.toml.

# Lista zainstalowanych umiejętności
zeroclaw skills list

# Instalacja z git
zeroclaw skills install https://github.com/user/my-skill.git

# Audyt bezpieczeństwa przed instalacją
zeroclaw skills audit https://github.com/user/my-skill.git

# Usuń umiejętność
zeroclaw skills remove my-skill

# Zarządzanie workspace
zeroclaw onboard              # Kreator konfiguracji z przewodnikiem
zeroclaw status               # Pokaż status demona/agenta
zeroclaw doctor               # Uruchom diagnostykę systemu

# Gateway + demon
zeroclaw gateway              # Uruchom serwer gateway (127.0.0.1:42617)
zeroclaw daemon               # Uruchom pełne autonomiczne środowisko

# Agent
zeroclaw agent                # Tryb interaktywnego czatu
zeroclaw agent -m "message"   # Tryb pojedynczej wiadomości

# Zarządzanie usługami
zeroclaw service install      # Zainstaluj jako usługę OS (launchd/systemd)
zeroclaw service start|stop|restart|status

# Kanały
zeroclaw channel list         # Lista skonfigurowanych kanałów
zeroclaw channel doctor       # Sprawdź zdrowie kanałów
zeroclaw channel bind-telegram 123456789

# Cron + planowanie
zeroclaw cron list            # Lista zaplanowanych zadań
zeroclaw cron add "*/5 * * * *" --prompt "Check system health"
zeroclaw cron remove <id>

# Pamięć
zeroclaw memory list          # Lista wpisów pamięci
zeroclaw memory get <key>     # Pobierz wspomnienie
zeroclaw memory stats         # Statystyki pamięci

# Profile autoryzacyjne
zeroclaw auth login --provider <name>
zeroclaw auth status
zeroclaw auth use --provider <name> --profile <profile>

# Peryferia sprzętowe
zeroclaw hardware discover    # Skanuj podłączone urządzenia
zeroclaw peripheral list      # Lista podłączonych peryferiów
zeroclaw peripheral flash     # Flash firmware na urządzenie

# Migracja
zeroclaw migrate openclaw --dry-run
zeroclaw migrate openclaw

# Uzupełnianie powłoki
source <(zeroclaw completions bash)
zeroclaw completions zsh > ~/.zfunc/_zeroclaw

Pełna dokumentacja komend: 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

Zasoby wydań są publikowane dla:

• Linux: x86_64, aarch64, armv7
• macOS: x86_64, aarch64
• Windows: x86_64

Pobierz najnowsze zasoby z: https://github.com/zeroclaw-labs/zeroclaw/releases/latest

Używaj tych, gdy przeszedłeś już przez onboarding i chcesz głębszej dokumentacji.

• Zacznij od indeksu dokumentacji, aby zobaczyć nawigację i „co gdzie jest."
• Przeczytaj przegląd architektury, aby poznać pełny model systemu.
• Użyj dokumentacji konfiguracji, gdy potrzebujesz każdego klucza i przykładu.
• Uruchom Gateway zgodnie z podręcznikiem operacyjnym.
• Postępuj zgodnie z ZeroClaw Onboard dla konfiguracji z przewodnikiem.
• Debuguj typowe awarie z przewodnikiem rozwiązywania problemów.
• Przejrzyj wskazówki bezpieczeństwa przed wystawieniem czegokolwiek.

• Centrum dokumentacji: docs/README.md
• Ujednolicony spis treści: docs/SUMMARY.md
• Dokumentacja komend: docs/reference/cli/commands-reference.md
• Dokumentacja konfiguracji: docs/reference/api/config-reference.md
• Dokumentacja dostawców: docs/reference/api/providers-reference.md
• Dokumentacja kanałów: docs/reference/api/channels-reference.md
• Podręcznik operacyjny: docs/ops/operations-runbook.md
• Rozwiązywanie problemów: docs/ops/troubleshooting.md

• Przewodnik kontrybutora: CONTRIBUTING.md
• Polityka workflow PR: docs/contributing/pr-workflow.md
• Przewodnik workflow CI: docs/contributing/ci-map.md
• Podręcznik recenzenta: docs/contributing/reviewer-playbook.md
• Polityka ujawniania bezpieczeństwa: SECURITY.md
• Szablon dokumentacji: docs/contributing/doc-template.md

• Przewodnik wdrożenia sieciowego: docs/ops/network-deployment.md
• Podręcznik agenta proxy: docs/ops/proxy-agent-playbook.md
• Przewodniki sprzętowe: docs/hardware/README.md

ZeroClaw został zbudowany dla smooth crab 🦀, szybkiego i wydajnego asystenta AI. Stworzony przez Argenisa De La Rosę i społeczność.

• zeroclawlabs.ai
• @zeroclawlabs

Jeśli ZeroClaw pomaga w Twojej pracy i chcesz wesprzeć dalszy rozwój, możesz przekazać darowiznę tutaj:

Serdeczne podziękowania dla społeczności i instytucji, które inspirują i napędzają tę pracę open-source:

• Harvard University — za wspieranie ciekawości intelektualnej i przesuwanie granic tego, co możliwe.
• MIT — za promowanie otwartej wiedzy, open source i przekonania, że technologia powinna być dostępna dla wszystkich.
• Sundai Club — za społeczność, energię i nieustanny zapał do budowania rzeczy, które mają znaczenie.
• Świat i dalej 🌍✨ — dla każdego kontrybutora, marzyciela i twórcy, który sprawia, że open source jest siłą dobra. To dla Ciebie.

Budujemy w otwartości, ponieważ najlepsze pomysły pochodzą zewsząd. Jeśli to czytasz, jesteś tego częścią. Witaj. 🦀❤️

Nowy w ZeroClaw? Szukaj issues oznaczonych good first issue — zobacz nasz Przewodnik kontrybutora, aby dowiedzieć się jak zacząć. PR-y z AI/vibe-coded mile widziane! 🤖

Zobacz CONTRIBUTING.md i CLA.md. Zaimplementuj trait, wyślij PR:

• Przewodnik workflow CI: docs/contributing/ci-map.md
• Nowy Provider → src/providers/
• Nowy Channel → src/channels/
• Nowy Observer → src/observability/
• Nowy Tool → src/tools/
• Nowy Memory → src/memory/
• Nowy Tunnel → src/tunnel/
• Nowy Peripheral → src/peripherals/
• Nowy Skill → ~/.zeroclaw/workspace/skills/<name>/

To jest jedyne oficjalne repozytorium ZeroClaw:

https://github.com/zeroclaw-labs/zeroclaw

Każde inne repozytorium, organizacja, domena lub pakiet twierdzący, że jest "ZeroClaw" lub sugerujący powiązanie z ZeroClaw Labs jest nieautoryzowany i niepowiązany z tym projektem. Znane nieautoryzowane forki będą wymienione w TRADEMARK.md.

Jeśli napotkasz podszywanie się lub nadużycie znaku towarowego, proszę otwórz zgłoszenie.

ZeroClaw jest podwójnie licencjonowany dla maksymalnej otwartości i ochrony kontrybutorów:

Możesz wybrać dowolną licencję. Kontrybutorzy automatycznie udzielają praw na obie — zobacz CLA.md po pełną umowę kontrybutora.

Nazwa ZeroClaw i logo są znakami towarowymi ZeroClaw Labs. Ta licencja nie udziela pozwolenia na ich używanie w celu sugerowania poparcia lub powiązania. Zobacz TRADEMARK.md po dozwolone i zabronione użycia.

• Zachowujesz prawa autorskie do swoich wkładów
• Udzielenie patentu (Apache 2.0) chroni Cię przed roszczeniami patentowymi innych kontrybutorów
• Twoje wkłady są trwale przypisane w historii commitów i NOTICE
• Żadne prawa do znaku towarowego nie są przenoszone przez współtworzenie

ZeroClaw — Zero narzutu. Zero kompromisów. Wdrażaj wszędzie. Wymieniaj wszystko. 🦀

Ta lista jest generowana z grafu kontrybutorów GitHub i aktualizuje się automatycznie.