🦀 ZeroClaw — Osobní AI Asistent

Nulová režie. Nulový kompromis. 100% Rust. 100% Agnostický.
⚡️ Běží na hardwaru za $10 s <5MB RAM: To je o 99 % méně paměti než OpenClaw a o 98 % levnější než Mac mini!

Vytvořeno studenty a členy komunit Harvard, MIT a Sundai.Club.

🌐 Jazyky: 🇺🇸 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 je osobní AI asistent, který spouštíte na vlastních zařízeních. Odpovídá vám na kanálech, které již používáte (WhatsApp, Telegram, Slack, Discord, Signal, iMessage, Matrix, IRC, Email, Bluesky, Nostr, Mattermost, Nextcloud Talk, DingTalk, Lark, QQ, Reddit, LinkedIn, Twitter, MQTT, WeChat Work a další). Má webový panel pro řízení v reálném čase a může se připojit k hardwarovým periferiím (ESP32, STM32, Arduino, Raspberry Pi). Gateway je pouze řídicí rovina — produktem je asistent.

Pokud hledáte osobního jednouživatelského asistenta, který je lokální, rychlý a vždy dostupný — toto je ono.

Webové stránky · Dokumentace · Architektura · Začínáme · Migrace z OpenClaw · Řešení problémů · Discord

Doporučené nastavení: spusťte zeroclaw onboard ve vašem terminálu. ZeroClaw Onboard vás krok za krokem provede nastavením gateway, workspace, kanálů a poskytovatele. Je to doporučená cesta nastavení a funguje na macOS, Linux a Windows (přes WSL2). Nová instalace? Začněte zde: Začínáme

• OpenAI Codex (předplatné ChatGPT)
• Gemini (Google OAuth)
• Anthropic (API klíč nebo autorizační token)

Poznámka k modelům: ačkoli je podporováno mnoho poskytovatelů/modelů, pro nejlepší zážitek použijte nejsilnější dostupný model nejnovější generace. Viz Onboarding.

Konfigurace modelů + CLI: Reference poskytovatelů Rotace autorizačních profilů (OAuth vs API klíče) + failover: Failover modelů

Běhové prostředí: stabilní toolchain Rust. Jeden binární soubor, žádné runtime závislosti.

brew install zeroclaw

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

zeroclaw onboard se automaticky spustí po instalaci pro konfiguraci vašeho workspace a poskytovatele.

Kompletní průvodce pro začátečníky (autentizace, párování, kanály): Začínáme

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

# Spuštění gateway (webhook server + webový panel)
zeroclaw gateway                # výchozí: 127.0.0.1:42617
zeroclaw gateway --port 0       # náhodný port (posílené zabezpečení)

# Komunikace s asistentem
zeroclaw agent -m "Hello, ZeroClaw!"

# Interaktivní režim
zeroclaw agent

# Spuštění plného autonomního běhového prostředí (gateway + kanály + cron + hands)
zeroclaw daemon

# Kontrola stavu
zeroclaw status

# Spuštění diagnostiky
zeroclaw doctor

Aktualizujete? Spusťte zeroclaw doctor po aktualizaci.

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

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

zeroclaw onboard

Vývojářský fallback (bez globální instalace): předřaďte příkazy cargo run --release -- (příklad: cargo run --release -- status).

ZeroClaw může importovat váš workspace, paměť a konfiguraci OpenClaw:

# Náhled toho, co bude migrováno (bezpečné, pouze čtení)
zeroclaw migrate openclaw --dry-run

# Spuštění migrace
zeroclaw migrate openclaw

Migruje záznamy paměti, soubory workspace a konfiguraci z ~/.openclaw/ do ~/.zeroclaw/. Konfigurace je automaticky převedena z JSON do TOML.

ZeroClaw se připojuje k reálným komunikačním platformám. Zacházejte s příchozími DM jako s nedůvěryhodným vstupem.

Kompletní průvodce zabezpečením: SECURITY.md

Výchozí chování na všech kanálech:

• Párování DM (výchozí): neznámí odesílatelé obdrží krátký párovací kód a bot nezpracovává jejich zprávu.
• Schvalte pomocí: zeroclaw pairing approve <channel> <code> (poté je odesílatel přidán na lokální allowlist).
• Veřejné příchozí DM vyžadují explicitní opt-in v config.toml.
• Spusťte zeroclaw doctor pro odhalení rizikových nebo špatně nakonfigurovaných DM politik.

Úrovně autonomie:

Vrstvy sandboxingu: izolace workspace, blokování procházení cest, allowlisty příkazů, zakázané cesty (/etc, /root, ~/.ssh), omezení rychlosti (max akcí/hodinu, denní limity nákladů).

Používejte tuto nástěnku pro důležitá oznámení (zlomové změny, bezpečnostní upozornění, okna údržby a blokátory vydání).

• Lehké běhové prostředí ve výchozím stavu — běžné CLI a statusové workflow běží v obálce paměti několika megabajtů na release buildech.
• Nákladově efektivní nasazení — navrženo pro desky za $10 a malé cloudové instance, žádné těžké runtime závislosti.
• Rychlé studené starty — jednobinární Rust runtime udržuje start příkazů a démona téměř okamžitý.
• Přenosná architektura — jeden binární soubor pro ARM, x86 a RISC-V s vyměnitelnými poskytovateli/kanály/nástroji.
• Lokální gateway — jednotná řídicí rovina pro relace, kanály, nástroje, cron, SOP a události.
• Vícekanálová schránka — WhatsApp, Telegram, Slack, Discord, Signal, iMessage, Matrix, IRC, Email, Bluesky, Nostr, Mattermost, Nextcloud Talk, DingTalk, Lark, QQ, Reddit, LinkedIn, Twitter, MQTT, WeChat Work, WebSocket a další.
• Orchestrace více agentů (Hands) — autonomní roje agentů, které běží podle plánu a časem se stávají chytřejšími.
• Standardní operační postupy (SOP) — automatizace workflow řízená událostmi s triggery MQTT, webhook, cron a periferiemi.
• Webový panel — rozhraní React 19 + Vite s chatem v reálném čase, prohlížečem paměti, editorem konfigurace, správcem cron a inspektorem nástrojů.
• Hardwarové periferie — ESP32, STM32 Nucleo, Arduino, Raspberry Pi GPIO přes trait Peripheral.
• Prvotřídní nástroje — shell, souborové I/O, prohlížeč, git, web fetch/search, MCP, Jira, Notion, Google Workspace a 70+ dalších.
• Lifecycle hooky — zachytávejte a upravujte volání LLM, spouštění nástrojů a zprávy v každé fázi.
• Platforma dovedností — vestavěné, komunitní a workspace dovednosti s bezpečnostním auditem.
• Podpora tunelů — Cloudflare, Tailscale, ngrok, OpenVPN a vlastní tunely pro vzdálený přístup.

• Lehký ve výchozím stavu: malý Rust binární soubor, rychlý start, nízká paměťová stopa.
• Bezpečný od návrhu: párování, přísný sandboxing, explicitní allowlisty, izolace workspace.
• Plně vyměnitelný: základní systémy jsou traity (poskytovatelé, kanály, nástroje, paměť, tunely).
• Žádný vendor lock-in: podpora poskytovatelů kompatibilních s OpenAI + připojitelné vlastní endpointy.

Rychlý benchmark na lokálním stroji (macOS arm64, únor 2026) normalizovaný pro edge hardware 0.8GHz.

Poznámky: Výsledky ZeroClaw jsou měřeny na release buildech pomocí /usr/bin/time -l. OpenClaw vyžaduje běhové prostředí Node.js (typicky ~390MB dodatečné paměťové režie), zatímco NanoBot vyžaduje běhové prostředí Python. PicoClaw a ZeroClaw jsou statické binárky. Výše uvedené hodnoty RAM jsou runtime paměť; požadavky kompilace jsou vyšší.

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 řídicí rovina s relacemi, přítomností, konfigurací, cron, webhooky, webovým panelem a párováním.
• CLI rozhraní: gateway, agent, onboard, doctor, status, service, migrate, auth, cron, channel, skills.
• Orchestrační smyčka agenta s dispatchem nástrojů, konstrukcí promptů, klasifikací zpráv a načítáním paměti.
• Model relací s vynucováním bezpečnostní politiky, úrovněmi autonomie a schvalovacím gatováním.
• Odolný wrapper poskytovatele s failoverem, opakováním a routingem modelů napříč 20+ LLM backendy.

Kanály: WhatsApp (nativní), 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 feature gate: Matrix (channel-matrix), Lark (channel-lark), Nostr (channel-nostr).

Webový panel React 19 + Vite 6 + Tailwind CSS 4 servírovaný přímo z Gateway:

• Dashboard — přehled systému, stav zdraví, uptime, sledování nákladů
• Chat s agentem — interaktivní chat s agentem
• Paměť — prohlížení a správa záznamů paměti
• Konfigurace — zobrazení a úprava konfigurace
• Cron — správa naplánovaných úloh
• Nástroje — prohlížení dostupných nástrojů
• Logy — zobrazení logů aktivity agenta
• Náklady — využití tokenů a sledování nákladů
• Doctor — diagnostika zdraví systému
• Integrace — stav a nastavení integrací
• Párování — správa párování zařízení

• Základní: shell, čtení/zápis/editace souborů, operace git, glob vyhledávání, vyhledávání obsahu
• Web: ovládání prohlížeče, web fetch, webové vyhledávání, snímek obrazovky, info o obrázku, čtení PDF
• Integrace: Jira, Notion, Google Workspace, Microsoft 365, LinkedIn, Composio, Pushover
• MCP: wrapper nástrojů Model Context Protocol + odložené sady nástrojů
• Plánování: cron add/remove/update/run, nástroj plánování
• Paměť: recall, store, forget, knowledge, project intel
• Pokročilé: delegate (agent-to-agent), swarm, model switch/routing, security ops, cloud ops
• Hardware: board info, memory map, memory read (za feature gate)

• Úrovně autonomie: ReadOnly, Supervised (výchozí), Full.
• Sandboxing: izolace workspace, blokování procházení cest, allowlisty příkazů, zakázané cesty, Landlock (Linux), Bubblewrap.
• Omezení rychlosti: max akcí za hodinu, max nákladů za den (konfigurovatelné).
• Schvalovací gatování: interaktivní schvalování operací se středním/vysokým rizikem.
• E-stop: schopnost nouzového vypnutí.
• 129+ bezpečnostních testů v automatizovaném CI.

• Webový panel servírovaný přímo z Gateway.
• Podpora tunelů: Cloudflare, Tailscale, ngrok, OpenVPN, vlastní příkaz.
• Docker runtime adaptér pro kontejnerizované spouštění.
• CI/CD: beta (auto na push) → stable (ruční dispatch) → Docker, crates.io, Scoop, AUR, Homebrew, tweet.
• Předpřipravené binárky pro Linux (x86_64, aarch64, armv7), macOS (x86_64, aarch64), Windows (x86_64).

Minimální ~/.zeroclaw/config.toml:

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

Kompletní reference konfigurace: 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"  # nebo "tailscale", "ngrok", "openvpn", "custom", "none"

Podrobnosti: Reference kanálů · Reference konfigurace

• native (výchozí) — přímé spouštění procesů, nejrychlejší cesta, ideální pro důvěryhodná prostředí.
• docker — plná kontejnerová izolace, vynucené bezpečnostní politiky, vyžaduje Docker.

Nastavte runtime.kind = "docker" pro přísný sandboxing nebo síťovou izolaci.

ZeroClaw podporuje nativní autorizační profily předplatného (více účtů, šifrování v klidu).

• Soubor úložiště: ~/.zeroclaw/auth-profiles.json
• Šifrovací klíč: ~/.zeroclaw/.secret_key
• Formát ID profilu: <provider>:<profile_name> (příklad: openai-codex:work)

# OpenAI Codex OAuth (předplatné 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

# Kontrola / obnovení / přepnutí profilu
zeroclaw auth status
zeroclaw auth refresh --provider openai-codex --profile default
zeroclaw auth use --provider openai-codex --profile work

# Spuštění agenta s autentizací předplatného
zeroclaw agent --provider openai-codex -m "hello"
zeroclaw agent --provider anthropic -m "hello"

Kořenový adresář workspace: ~/.zeroclaw/workspace/ (konfigurovatelné přes config).

Injektované soubory promptů:

• IDENTITY.md — osobnost a role agenta
• USER.md — kontext a preference uživatele
• MEMORY.md — dlouhodobá fakta a poučení
• AGENTS.md — konvence relací a inicializační pravidla
• SOUL.md — základní identita a provozní principy

Dovednosti: ~/.zeroclaw/workspace/skills/<skill>/SKILL.md nebo SKILL.toml.

# Seznam nainstalovaných dovedností
zeroclaw skills list

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

# Bezpečnostní audit před instalací
zeroclaw skills audit https://github.com/user/my-skill.git

# Odebrání dovednosti
zeroclaw skills remove my-skill

# Správa workspace
zeroclaw onboard              # Průvodce nastavením
zeroclaw status               # Zobrazení stavu démona/agenta
zeroclaw doctor               # Spuštění diagnostiky systému

# Gateway + démon
zeroclaw gateway              # Spuštění gateway serveru (127.0.0.1:42617)
zeroclaw daemon               # Spuštění plného autonomního runtime

# Agent
zeroclaw agent                # Interaktivní režim chatu
zeroclaw agent -m "message"   # Režim jedné zprávy

# Správa služeb
zeroclaw service install      # Instalace jako služba OS (launchd/systemd)
zeroclaw service start|stop|restart|status

# Kanály
zeroclaw channel list         # Seznam konfigurovaných kanálů
zeroclaw channel doctor       # Kontrola zdraví kanálů
zeroclaw channel bind-telegram 123456789

# Cron + plánování
zeroclaw cron list            # Seznam naplánovaných úloh
zeroclaw cron add "*/5 * * * *" --prompt "Check system health"
zeroclaw cron remove <id>

# Paměť
zeroclaw memory list          # Seznam záznamů paměti
zeroclaw memory get <key>     # Získání záznamu
zeroclaw memory stats         # Statistiky paměti

# Autorizační profily
zeroclaw auth login --provider <name>
zeroclaw auth status
zeroclaw auth use --provider <name> --profile <profile>

# Hardwarové periferie
zeroclaw hardware discover    # Skenování připojených zařízení
zeroclaw peripheral list      # Seznam připojených periferií
zeroclaw peripheral flash     # Flash firmwaru na zařízení

# Migrace
zeroclaw migrate openclaw --dry-run
zeroclaw migrate openclaw

# Doplňování shellu
source <(zeroclaw completions bash)
zeroclaw completions zsh > ~/.zfunc/_zeroclaw

Kompletní reference příkazů: 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

Vydané assety jsou publikovány pro:

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

Stáhněte nejnovější assety z: https://github.com/zeroclaw-labs/zeroclaw/releases/latest

Používejte tyto, když jste prošli onboardingem a chcete hlubší referenci.

• Začněte s indexem dokumentace pro navigaci a „co je kde."
• Přečtěte si přehled architektury pro úplný model systému.
• Použijte referenci konfigurace, když potřebujete každý klíč a příklad.
• Provozujte Gateway podle provozní příručky.
• Následujte ZeroClaw Onboard pro průvodce nastavením.
• Odlaďte běžné chyby s průvodcem řešením problémů.
• Projděte bezpečnostní pokyny před vystavením čehokoli.

• Centrum dokumentace: docs/README.md
• Ujednocený obsah: docs/SUMMARY.md
• Reference příkazů: docs/reference/cli/commands-reference.md
• Reference konfigurace: docs/reference/api/config-reference.md
• Reference poskytovatelů: docs/reference/api/providers-reference.md
• Reference kanálů: docs/reference/api/channels-reference.md
• Provozní příručka: docs/ops/operations-runbook.md
• Řešení problémů: docs/ops/troubleshooting.md

• Průvodce přispíváním: CONTRIBUTING.md
• Politika PR workflow: docs/contributing/pr-workflow.md
• Průvodce CI workflow: docs/contributing/ci-map.md
• Příručka recenzenta: docs/contributing/reviewer-playbook.md
• Politika bezpečnostního zveřejnění: SECURITY.md
• Šablona dokumentace: docs/contributing/doc-template.md

• Průvodce síťovým nasazením: docs/ops/network-deployment.md
• Příručka proxy agenta: docs/ops/proxy-agent-playbook.md
• Hardwarové průvodce: docs/hardware/README.md

ZeroClaw byl vytvořen pro smooth crab 🦀, rychlého a efektivního AI asistenta. Vytvořil Argenis De La Rosa a komunita.

• zeroclawlabs.ai
• @zeroclawlabs

Pokud vám ZeroClaw pomáhá v práci a chcete podpořit další vývoj, můžete přispět zde:

Srdečné poděkování komunitám a institucím, které inspirují a pohánějí tuto open-source práci:

• Harvard University — za podporu intelektuální zvědavosti a posouvání hranic toho, co je možné.
• MIT — za prosazování otevřených znalostí, open source a víry, že technologie by měla být dostupná všem.
• Sundai Club — za komunitu, energii a neúnavný drive budovat věci, na kterých záleží.
• Svět a dále 🌍✨ — každému přispěvateli, snílkovi a tvůrci, kteří dělají z open source sílu dobra. Toto je pro vás.

Stavíme otevřeně, protože nejlepší nápady přicházejí odevšad. Pokud toto čtete, jste toho součástí. Vítejte. 🦀❤️

Jste v ZeroClaw noví? Hledejte issues označené good first issue — podívejte se na náš Průvodce přispíváním, jak začít. AI/vibe-coded PR vítány! 🤖

Viz CONTRIBUTING.md a CLA.md. Implementujte trait, odešlete PR:

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

Toto je jediný oficiální repozitář ZeroClaw:

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

Jakýkoli jiný repozitář, organizace, doména nebo balíček tvrdící, že je „ZeroClaw" nebo naznačující spojení se ZeroClaw Labs je neautorizovaný a není spojen s tímto projektem. Známé neautorizované forky budou uvedeny v TRADEMARK.md.

Pokud narazíte na podvržení identity nebo zneužití ochranné známky, prosím otevřete issue.

ZeroClaw je dvojitě licencován pro maximální otevřenost a ochranu přispěvatelů:

Můžete si vybrat kteroukoli licenci. Přispěvatelé automaticky udělují práva pod oběma — viz CLA.md pro úplnou dohodu přispěvatele.

Název ZeroClaw a logo jsou ochranné známky ZeroClaw Labs. Tato licence neuděluje povolení k jejich použití pro naznačení podpory nebo spojení. Viz TRADEMARK.md pro povolená a zakázaná použití.

• Zachováváte si autorská práva ke svým příspěvkům
• Udělení patentu (Apache 2.0) vás chrání před patentovými nároky jiných přispěvatelů
• Vaše příspěvky jsou trvale připsány v historii commitů a NOTICE
• Přispíváním se nepřevádějí žádná práva k ochranné známce

ZeroClaw — Nulová režie. Nulový kompromis. Nasaďte kdekoli. Vyměňte cokoli. 🦀

Tento seznam je generován z grafu přispěvatelů GitHub a aktualizuje se automaticky.