Upozornění na neoficiální fork:
Autoři projektu uvádějí, že nemají žádnou afiliaci s openagen/zeroclaw, zeroclaw.org ani zeroclaw.net. Tyto zdroje aktuálně odkazují na neoficiální fork vydávající se za originální projekt. Doporučení je používat pouze oficiální repozitář a ověřené kanály.

ZeroClaw je runtime pro agentní systémy, který abstrahuje modely, nástroje, paměť a exekuci do jednoho kompaktního běhového prostředí. Cílem je umožnit vytvořit agenta jednou a provozovat ho napříč různými prostředími bez změny architektury.

Klíčová vlastnost: celý systém je distribuován jako single native binary (~8.8 MB) s paměťovou náročností pod 5 MB.

Architektura: trait-driven design

ZeroClaw staví na modulární architektuře založené na tzv. traits (v Rust terminologii). Každá klíčová část runtime je definovaná jako rozhraní, které lze zaměnit bez zásahu do zbytku systému.

Základní komponenty:

• Provider – napojení na LLM backend (OpenAI, Anthropic, Ollama, atd.)
• Channel – komunikační vrstva (Telegram, Slack, HTTP webhook…)
• Tools – akce, které agent může vykonávat
• Memory – perzistence a retrieval
• Tunnel – síťová expozice (např. ngrok, Cloudflare)

Tento přístup eliminuje vendor lock-in a umožňuje dynamické přepínání backendů během běhu.

Runtime model a orchestrace

ZeroClaw implementuje vlastní agentní smyčku (agent loop), která zahrnuje:

1. příjem zprávy
2. klasifikaci (intent, typ vstupu)
3. konstrukci promptu
4. načtení paměti
5. dispatch nástrojů
6. generování odpovědi
7. post-processing (logování, cost tracking)

Součástí runtime je i:

• retry logika
• fallback mezi modely
• routing napříč providery

To vše běží v rámci jednoho procesu bez externí orchestrace.

Výkon a resource footprint

ZeroClaw cílí na scénáře s omezenými zdroji.

Srovnání:

Nízký overhead umožňuje nasazení na edge hardware (např. ARM SBC) bez nutnosti optimalizací.

Paměťový subsystém

ZeroClaw obsahuje vestavěný memory engine bez závislosti na externích službách.

Komponenty:

• SQLite backend
• FTS5 (BM25) pro fulltext
• vector embeddings uložené jako BLOB
• hybridní scoring (vector + keyword)

Konfigurovatelné parametry:

[memory]
backend = "sqlite"
vector_weight = 0.7
keyword_weight = 0.3

Výhodou je nulová infrastruktura navíc. Nevýhodou je omezená škálovatelnost oproti specializovaným vector DB.

Bezpečnostní model

ZeroClaw implementuje vícevrstvý bezpečnostní model:

Runtime omezení

• max počet akcí za časové okno
• max finanční limit (API cost)
• emergency stop (více úrovní)

Sandbox

• izolace workspace
• blokace path traversal
• allowlist příkazů
• Linux: Landlock / Bubblewrap

Síť

• gateway bind na localhost
• přístup přes OTP pairing
• token-based autentizace

Defaultní konfigurace je „deny-by-default“.

Channels a integrace

ZeroClaw podporuje více než 25 komunikačních kanálů:

• messaging (Telegram, Discord, Slack)
• sociální sítě (LinkedIn, Reddit, Twitter)
• infrastruktura (MQTT, WebSocket)
• enterprise nástroje (Notion, Jira)

Každý channel implementuje jednotné API a používá allowlist přístup.

Tools a execution model

Nástroje jsou sandboxované a workspace-scoped.

Kategorie:

• filesystem (read/write/edit)
• shell execution
• web (fetch, search, browser)
• integrace (Google Workspace, Jira…)
• scheduling (cron)
• memory operations

ZeroClaw podporuje:

• synchronní i asynchronní tool execution
• chaining nástrojů
• agent-to-agent delegaci

Skills a rozšiřitelnost

Skills jsou distribuovatelné balíčky funkcionality:

• deklarativní (TOML + instrukce)
• binární (WASM moduly)

WASM varianta běží v sandboxu (Extism runtime), což umožňuje bezpečné rozšíření bez přímého přístupu k host systému.

Instalace:

zeroclaw skill install namespace/name

Deployment model

ZeroClaw podporuje široké spektrum prostředí:

• ARM (Raspberry Pi)
• x86 servery
• RISC-V
• kontejnery (Docker)
• edge zařízení (ESP32 – omezeně)

Distribuce:

• prebuilt binárky
• Homebrew
• Cargo (Rust)
• Docker image

Gateway a daemon

Runtime se dělí na dvě hlavní části:

• gateway – HTTP server pro webhooky
• daemon – dlouhodobý běh (cron, channels, heartbeat)

API endpointy:

• /health
• /pair
• /webhook

Gateway běží defaultně na 127.0.0.1:42617.

Use cases

Typické scénáře:

• lokální agenti bez cloud dependency
• edge AI (IoT zařízení)
• multi-provider orchestrace
• experimentální agentní systémy

Méně vhodné:

• high-scale distribuované systémy
• heavy data pipelines
• enterprise orchestrace přes Kubernetes

Shrnutí

ZeroClaw reprezentuje přístup orientovaný na minimalismus a kontrolu nad runtime. Kombinuje nízké nároky na zdroje s modulární architekturou a integrovanými subsystémy (memory, tools, orchestrace).

Tento design umožňuje provoz agentních workflow bez závislosti na externích službách, což je relevantní zejména pro edge a self-hosted scénáře.

Zdroje

• https://github.com/zeroclaw-labs/zeroclaw
• https://github.com/zeroclaw-labs/zeroclaw/blob/master/docs/README.md
• https://www.zeroclawlabs.ai/
• https://www.zeroclawlabs.ai/docs
• https://www.zeroclawlabs.ai/skills
• https://github.com/zeroclaw-labs/zeroclaw/blob/master/docs/reference/cli/commands-reference.md
• https://github.com/zeroclaw-labs/zeroclaw/blob/master/docs/reference/api/config-reference.md
• https://github.com/zeroclaw-labs/zeroclaw/blob/master/docs/reference/api/providers-reference.md
• https://github.com/zeroclaw-labs/zeroclaw/blob/master/docs/reference/api/channels-reference.md
• https://github.com/zeroclaw-labs/zeroclaw/blob/master/docs/ops/operations-runbook.md
• https://github.com/zeroclaw-labs/zeroclaw/blob/master/docs/ops/troubleshooting.md