ZeroClaw 🦀

Nulová režie. Nulové kompromisy. 100% Rust. 100% Agnostický.
⚡️ Beží 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!

Postaveno 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

Rychlý Start | Jedno-klikové nastavení | Dokumentační Centrum | Obsah Dokumentace

Rychlý přístup: Reference · Operace · Řešení problémů · Bezpečnost · Hardware · Příspívání

Rychlá, lehká a plně autonomní AI asistent infrastruktura
Nasazujte kdekoliv. Měňte cokoliv.

ZeroClaw je operační systém runtime pro workflow agentů — infrastruktura která abstrahuje modely, nástroje, paměť a provádění pro stavbu agentů jednou a spouštění kdekoliv.

Architektura založená na traitech · bezpečný runtime defaultně · vyměnitelný poskytovatel/kanál/nástroj · vše je připojitelné

📢 Oznámení

Použijte tuto tabulku pro důležitá oznámení (změny kompatibility, bezpečnostní upozornění, servisní okna a blokování verzí).

Datum (UTC)	Úroveň	Oznámení	Akce
2026-02-19	Kritické	Nejsme propojeni s `openagen/zeroclaw` nebo `zeroclaw.org`. Doména `zeroclaw.org` aktuálně směřuje na fork `openagen/zeroclaw`, a tato doména/repoziťář se vydává za náš oficiální web/projekt.	Nevěřte informacím, binárním souborům, fundraisingu nebo oznámením z těchto zdrojů. Používejte pouze tento repoziťář a naše ověřené sociální účty.
2026-02-21	Důležité	Náš oficiální web je nyní online: zeroclawlabs.ai. Děkujeme za trpělivost během čekání. Stále detekujeme pokusy o vydávání se: neúčastněte žádné investiční/fundraisingové aktivity ve jménu ZeroClaw pokud není publikována přes naše oficiální kanály.	Používejte tento repoziťář jako jediný zdroj pravdy. Sledujte X (@zeroclawlabs), Telegram (@zeroclawlabs), Facebook (skupina), Reddit (r/zeroclawlabs), a Xiaohongshu pro oficiální aktualizace.
2026-02-19	Důležité	Anthropic aktualizoval podmínky použití autentizace a přihlašovacích údajů dne 2026-02-19. OAuth autentizace (Free, Pro, Max) je výhradně pro Claude Code a Claude.ai; použití Claude Free/Pro/Max OAuth tokenů v jakémkoliv jiném produktu, nástroji nebo službě (včetně Agent SDK) není povoleno a může porušit Podmínky použití spotřebitele.	Prosím dočasně se vyhněte Claude Code OAuth integracím pro předcházení potenciálním ztrátám. Původní klauzule: Authentication and Credential Use.

✨ Funkce

🏎️ Lehký Runtime Defaultně: Běžné CLI workflowy a stavové příkazy běží v paměťovém prostoru několika megabytů v produkčních buildech.
💰 Cenově efektivní nasazení: Navrženo pro nízkonákladové desky a malé cloud instance bez těžkých runtime závislostí.
⚡ Rychlé studené starty: Single-binary Rust runtime udržuje start příkazů a daemonů téměř okamžitý pro denní operace.
🌍 Přenosná architektura: Single-binary workflow na ARM, x86 a RISC-V s vyměnitelným poskytovatelem/kanálem/nástrojem.

Proč týmy volí ZeroClaw

Lehký defaultně: malý Rust binary, rychlý start, nízká paměťová stopa.
Bezpečný designem: párování, striktní sandboxing, explicitní allowlisty, workspace scope.
Plně vyměnitelné: jádrové systémy jsou traity (poskytovatelé, kanály, nástroje, paměť, tunely).
Žádné vendor lock-in: OpenAI-kompatibilní podpora poskytovatele + připojitelné vlastní endpointy.

Benchmark Snapshot (ZeroClaw vs OpenClaw, Reprodukovatelné)

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

	OpenClaw	NanoBot	PicoClaw	ZeroClaw 🦀
Jazyk	TypeScript	Python	Go	Rust
RAM	> 1 GB	> 100 MB	< 10 MB	< 5 MB
Start (0.8 GHz jádro)	> 500s	> 30s	< 1s	< 10ms
Velikost Binary	~28 MB (dist)	N/A (Skripty)	~8 MB	3.4 MB
Náklady	Mac Mini $599	Linux SBC ~$50	Linux deska $10	Jakýkoliv hardware $10

Poznámky: Výsledky ZeroClaw jsou měřeny na produkčních buildech pomocí /usr/bin/time -l. OpenClaw vyžaduje Node.js runtime (typicky ~390 MB dodatečného paměťového režijního nákladu), zatímco NanoBot vyžaduje Python runtime. PicoClaw a ZeroClaw jsou statická binaria. Výše uvedené RAM čísla jsou runtime paměť; build-time kompilační požadavky jsou vyšší.

Reprodukovatelné lokální měření

Benchmark tvrzení se mohou měnit jak se kód a toolchainy vyvíjejí, takže vždy měřte svůj aktuální build lokálně:

cargo build --release
ls -lh target/release/zeroclaw

/usr/bin/time -l target/release/zeroclaw --help
/usr/bin/time -l target/release/zeroclaw status

Ukázková vzorka (macOS arm64, měřeno 18. února 2026):

Velikost release binary: 8.8M
zeroclaw --help: reálný čas přibližně 0.02s, špičková paměťová stopa ~3.9 MB
zeroclaw status: reálný čas přibližně 0.01s, špičková paměťová stopa ~4.1 MB

Předpoklady

Windows

Windows — Vyžadováno

Visual Studio Build Tools (poskytuje MSVC linker a Windows SDK):
```
winget install Microsoft.VisualStudio.2022.BuildTools
```
Během instalace (nebo přes Visual Studio Installer), vyberte workload "Desktop development with C++".
Rust Toolchain:
```
winget install Rustlang.Rustup
```
Po instalaci otevřete nový terminál a spusťte rustup default stable pro zajištění, že stabilní toolchain je aktivní.
Ověřte že oba fungují:
```
rustc --version
cargo --version
```

Windows — Volitelné

Docker Desktop — vyžadováno pouze pokud používáte Docker sandboxed runtime (runtime.kind = "docker"). Nainstalujte přes winget install Docker.DockerDesktop.

Linux / macOS

Linux / macOS — Vyžadováno

Essenciální build nástroje:
- Linux (Debian/Ubuntu): sudo apt install build-essential pkg-config
- Linux (Fedora/RHEL): sudo dnf group install development-tools && sudo dnf install pkg-config
- macOS: Nainstalujte Xcode Command Line Tools: xcode-select --install

Rust Toolchain:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Viz rustup.rs pro detaily.

Ověřte:
```
rustc --version
cargo --version
```

Linux / macOS — Volitelné

Docker — vyžadováno pouze pokud používáte Docker sandboxed runtime (runtime.kind = "docker").
- Linux (Debian/Ubuntu): viz docs.docker.com
- Linux (Fedora/RHEL): viz docs.docker.com
- macOS: nainstalujte Docker Desktop přes docker.com/products/docker-desktop

Rychlý Start

Možnost 1: Automatické nastavení (doporučeno)

Skript bootstrap.sh nainstaluje Rust, naklonuje ZeroClaw, zkompiluje ho a nastaví vaše počáteční vývojové prostředí:

curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/bootstrap.sh | bash

Toto:

Nainstaluje Rust (pokud chybí)
Naklonuje ZeroClaw repoziťář
Zkompiluje ZeroClaw v release módu
Nainstaluje zeroclaw do ~/.cargo/bin/
Vytvoří výchozí workspace strukturu v ~/.zeroclaw/workspace/
Vygeneruje počáteční konfigurační soubor ~/.zeroclaw/workspace/config.toml

Po bootstrapu znovu načtěte váš shell nebo spusťte source ~/.cargo/env pro použití příkazu zeroclaw globálně.

Možnost 2: Manuální instalace

Klikněte pro zobrazení kroků manuální instalace

# 1. Naklonujte repoziťář
git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw

# 2. Zkompilujte v release
cargo build --release --locked

# 3. Nainstalujte binary
cargo install --path . --locked

# 4. Inicializujte workspace
zeroclaw init

# 5. Ověřte instalaci
zeroclaw --version
zeroclaw status

Po instalaci

Jakmile nainstalováno (přes bootstrap nebo manuálně), měli byste vidět:

~/.zeroclaw/workspace/
├── config.toml          # Hlavní konfigurace
├── .pairing             # Párovací tajemství (generováno při prvním spuštění)
├── logs/                # Daemon/agent logy
├── skills/              # Vlastní dovednosti
└── memory/              # Uložení konverzačního kontextu

Další kroky:

Nakonfigurujte své AI poskytovatele v ~/.zeroclaw/workspace/config.toml
Podívejte se na konfigurační referenci pro pokročilé možnosti
Spusťte agenta: zeroclaw agent start
Otestujte přes váš preferovaný kanál (viz kanálová reference)

Konfigurace

Upravte ~/.zeroclaw/workspace/config.toml pro konfiguraci poskytovatelů, kanálů a chování systému.

Rychlá konfigurační reference

[providers.anthropic]
api_key = "sk-ant-..."
model = "claude-sonnet-4-20250514"

[providers.openai]
api_key = "sk-..."
model = "gpt-4o"

[channels.telegram]
enabled = true
bot_token = "123456:ABC-DEF..."

[channels.matrix]
enabled = true
homeserver_url = "https://matrix.org"
username = "@bot:matrix.org"
password = "..."

[memory]
kind = "markdown"  # nebo "sqlite" nebo "none"

[runtime]
kind = "native"    # nebo "docker" (vyžaduje Docker)

Kompletní referenční dokumenty:

Konfigurační reference — všechna nastavení, validace, výchozí hodnoty
Poskytovatel reference — AI poskytovatel-specifické konfigurace
Kanálová reference — Telegram, Matrix, Slack, Discord a další
Operace — produkční monitoring, rotace tajemství, škálování

Aktuální Runtime Podpora

ZeroClaw podporuje dva backendy provádění kódu:

native (výchozí) — přímé provedení procesu, nejrychlejší cesta, ideální pro důvěryhodná prostředí
docker — plná kontejnerová izolace, zpřísněné bezpečnostní politiky, vyžaduje Docker

Použijte runtime.kind = "docker" pokud potřebujete striktní sandboxing nebo síťovou izolaci. Viz konfigurační reference pro úplné detaily.

Příkazy

# Správa workspace
zeroclaw init                # Inicializuje nový workspace
zeroclaw status              # Zobrazuje stav daemon/agent
zeroclaw config validate     # Ověřuje syntaxi a hodnoty config.toml

# Správa daemon
zeroclaw daemon start        # Spouští daemon na pozadí
zeroclaw daemon stop         # Zastavuje běžící daemon
zeroclaw daemon restart      # Restartuje daemon (znovunačtení config)
zeroclaw daemon logs         # Zobrazuje daemon logy

# Správa agent
zeroclaw agent start         # Spouští agenta (vyžaduje běžící daemon)
zeroclaw agent stop          # Zastavuje agenta
zeroclaw agent restart       # Restartuje agenta (znovunačtení config)

# Párovací operace
zeroclaw pairing init        # Generuje nové párovací tajemství
zeroclaw pairing rotate      # Rotuje existující párovací tajemství

# Tunneling (pro veřejnou expozici)
zeroclaw tunnel start        # Spouští tunnel k lokálnímu daemon
zeroclaw tunnel stop         # Zastavuje aktivní tunnel

# Diagnostika
zeroclaw doctor              # Spouští kontroly zdraví systému
zeroclaw version             # Zobrazuje verzi a build informace

Viz Příkazová reference pro kompletní možnosti a příklady.

Architektura

┌─────────────────────────────────────────────────────────────────┐
│                        Kanály (trait)                           │
│  Telegram │ Matrix │ Slack │ Discord │ Web │ CLI │ Custom       │
└─────────────────────────┬───────────────────────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────────────────┐
│                      Agent Orchestrátor                         │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐          │
│  │   Směrování  │  │   Kontext    │  │  Provedení   │          │
│  │   Zpráva     │  │   Paměť      │  │   Nástroj    │          │
│  └──────────────┘  └──────────────┘  └──────────────┘          │
└─────────────────────────┬───────────────────────────────────────┘
                          │
          ┌───────────────┼───────────────┐
          ▼               ▼               ▼
┌──────────────┐  ┌──────────────┐  ┌──────────────┐
│  Poskytovatel│  │   Paměť      │  │  Nástroje    │
│   (trait)    │  │   (trait)    │  │   (trait)    │
├──────────────┤  ├──────────────┤  ├──────────────┤
│  Anthropic   │  │   Markdown   │  │  Filesystem  │
│   OpenAI     │  │    SQLite    │  │     Bash     │
│   Gemini     │  │     None     │  │   Web Fetch  │
│   Ollama     │  │    Custom    │  │   Custom     │
│   Custom     │  └──────────────┘  └──────────────┘
└──────────────┘
          │
          ▼
┌─────────────────────────────────────────────────────────────────┐
│                   Runtime (trait)                               │
│                  Native │ Docker                                │
└─────────────────────────────────────────────────────────────────┘

Klíčové principy:

Vše je trait — poskytovatelé, kanály, nástroje, paměť, tunely
Kanály volají orchestrátor; orchestrátor volá poskytovatele + nástroje
Paměťový systém spravuje konverzační kontext (markdown, SQLite, nebo žádný)
Runtime abstrahuje provádění kódu (nativní nebo Docker)
Žádné vendor lock-in — vyměňujte Anthropic ↔ OpenAI ↔ Gemini ↔ Ollama beze změn kódu

Viz dokumentace architektury pro detailní diagramy a detaily implementace.

Příklady

Telegram Bot

[channels.telegram]
enabled = true
bot_token = "123456:ABC-DEF..."
allowed_users = [987654321]  # Vaše Telegram user ID

Spusťte daemon + agent, pak pošlete zprávu vašemu botovi na Telegram:

/start
Ahoj! Mohl bys mi pomoci napsat Python skript?

Bot odpoví AI-generovaným kódem, provede nástroje pokud požadováno a udržuje konverzační kontext.

Matrix (end-to-end šifrování)

[channels.matrix]
enabled = true
homeserver_url = "https://matrix.org"
username = "@zeroclaw:matrix.org"
password = "..."
device_name = "zeroclaw-prod"
e2ee_enabled = true

Pozvěte @zeroclaw:matrix.org do šifrované místnosti a bot odpoví s plným šifrováním. Viz Matrix E2EE Guide pro nastavení ověření zařízení.

Multi-Poskytovatel

[providers.anthropic]
enabled = true
api_key = "sk-ant-..."
model = "claude-sonnet-4-20250514"

[providers.openai]
enabled = true
api_key = "sk-..."
model = "gpt-4o"

[orchestrator]
default_provider = "anthropic"
fallback_providers = ["openai"]  # Failover při chybě poskytovatele

Pokud Anthropic selže nebo má rate-limit, orchestrátor automaticky přepne na OpenAI.

Vlastní Paměť

[memory]
kind = "sqlite"
path = "~/.zeroclaw/workspace/memory/conversations.db"
retention_days = 90  # Automatické čištění po 90 dnech

Nebo použijte Markdown pro lidsky čitelné ukládání:

[memory]
kind = "markdown"
path = "~/.zeroclaw/workspace/memory/"

Viz Konfigurační reference pro všechny možnosti paměti.

Podpora Poskytovatelů

Poskytovatel	Stav	API Klíč	Příklad Modelů
Anthropic	✅ Stabilní	`ANTHROPIC_API_KEY`	`claude-sonnet-4-20250514`, `claude-opus-4-20250514`
OpenAI	✅ Stabilní	`OPENAI_API_KEY`	`gpt-4o`, `gpt-4o-mini`, `o1`, `o1-mini`
Google Gemini	✅ Stabilní	`GOOGLE_API_KEY`	`gemini-2.0-flash-exp`, `gemini-exp-1206`
Ollama	✅ Stabilní	N/A (lokální)	`llama3.3`, `qwen2.5`, `phi4`
Cerebras	✅ Stabilní	`CEREBRAS_API_KEY`	`llama-3.3-70b`
Groq	✅ Stabilní	`GROQ_API_KEY`	`llama-3.3-70b-versatile`
Mistral	🚧 Plánováno	`MISTRAL_API_KEY`	TBD
Cohere	🚧 Plánováno	`COHERE_API_KEY`	TBD

Vlastní Endpointy

ZeroClaw podporuje OpenAI-kompatibilní endpointy:

[providers.custom]
enabled = true
api_key = "..."
base_url = "https://api.your-llm-provider.com/v1"
model = "your-model-name"

Příklad: použijte LiteLLM jako proxy pro přístup k jakémukoli LLM přes OpenAI rozhraní.

Viz Poskytovatel reference pro kompletní detaily konfigurace.

Podpora Kanálů

Kanál	Stav	Autentizace	Poznámky
Telegram	✅ Stabilní	Bot Token	Plná podpora včetně souborů, obrázků, inline tlačítek
Matrix	✅ Stabilní	Heslo nebo Token	E2EE podpora s ověřením zařízení
Slack	🚧 Plánováno	OAuth nebo Bot Token	Vyžaduje workspace přístup
Discord	🚧 Plánováno	Bot Token	Vyžaduje guild oprávnění
WhatsApp	🚧 Plánováno	Twilio nebo oficiální API	Vyžaduje business účet
CLI	✅ Stabilní	Žádné	Přímé konverzační rozhraní
Web	🚧 Plánováno	API Klíč nebo OAuth	Prohlížečové chat rozhraní

Viz Kanálová reference pro kompletní instrukce konfigurace.

Podpora Nástrojů

ZeroClaw poskytuje vestavěné nástroje pro provádění kódu, přístup k souborovému systému a web retrieval:

Nástroj	Popis	Vyžadovaný Runtime
bash	Provádí shell příkazy	Nativní nebo Docker
python	Provádí Python skripty	Python 3.8+ (nativní) nebo Docker
javascript	Provádí Node.js kód	Node.js 18+ (nativní) nebo Docker
filesystem_read	Čte soubory	Nativní nebo Docker
filesystem_write	Zapisuje soubory	Nativní nebo Docker
web_fetch	Získává web obsah	Nativní nebo Docker

Bezpečnost Provedení

Nativní Runtime — běží jako uživatelský proces daemon, plný přístup k souborovému systému
Docker Runtime — plná kontejnerová izolace, oddělené souborové systémy a sítě

Nakonfigurujte politiku provedení v config.toml:

[runtime]
kind = "docker"
allowed_tools = ["bash", "python", "filesystem_read"]  # Explicitní allowlist

Viz Konfigurační reference pro kompletní možnosti bezpečnosti.

Nasazení

Lokální Nasazení (Vývoj)

zeroclaw daemon start
zeroclaw agent start

Serverové Nasazení (Produkce)

Použijte systemd pro správu daemon a agent jako služby:

# Nainstalujte binary
cargo install --path . --locked

# Nakonfigurujte workspace
zeroclaw init

# Vytvořte systemd servisní soubory
sudo cp deployment/systemd/zeroclaw-daemon.service /etc/systemd/system/
sudo cp deployment/systemd/zeroclaw-agent.service /etc/systemd/system/

# Povolte a spusťte služby
sudo systemctl enable zeroclaw-daemon zeroclaw-agent
sudo systemctl start zeroclaw-daemon zeroclaw-agent

# Ověřte stav
sudo systemctl status zeroclaw-daemon
sudo systemctl status zeroclaw-agent

Viz Průvodce síťovým nasazením pro kompletní instrukce produkčního nasazení.

Docker

# Sestavte image
docker build -t zeroclaw:latest .

# Spusťte kontejner
docker run -d \
  --name zeroclaw \
  -v ~/.zeroclaw/workspace:/workspace \
  -e ANTHROPIC_API_KEY=sk-ant-... \
  zeroclaw:latest

Viz Dockerfile pro detaily sestavení a konfigurační možnosti.

Edge Hardware

ZeroClaw je navržen pro běh na nízko-příkonovém hardwaru:

Raspberry Pi Zero 2 W — ~512 MB RAM, jedno ARMv8 jádro, < $5 hardwarové náklady
Raspberry Pi 4/5 — 1 GB+ RAM, vícejádrový, ideální pro souběžné úlohy
Orange Pi Zero 2 — ~512 MB RAM, čtyřjádrový ARMv8, ultra-nízké náklady
x86 SBCs (Intel N100) — 4-8 GB RAM, rychlé buildy, nativní Docker podpora

Viz Hardware Guide pro instrukce nastavení specifické pro zařízení.

Tunneling (Veřejná Expozice)

Exponujte svůj lokální ZeroClaw daemon do veřejné sítě přes bezpečné tunely:

zeroclaw tunnel start --provider cloudflare

Podporovaní tunnel poskytovatelé:

Cloudflare Tunnel — bezplatný HTTPS, bez expozice portů, multi-doména podpora
Ngrok — rychlé nastavení, vlastní domény (placený plán)
Tailscale — soukromá mesh síť, bez veřejného portu

Viz Konfigurační reference pro kompletní konfigurační možnosti.

Bezpečnost

ZeroClaw implementuje více vrstev bezpečnosti:

Párování

Daemon generuje párovací tajemství při prvním spuštění uložené v ~/.zeroclaw/workspace/.pairing. Klienti (agent, CLI) musí předložit toto tajemství pro připojení.

zeroclaw pairing rotate  # Generuje nové tajemství a zneplatňuje staré

Sandboxing

Docker Runtime — plná kontejnerová izolace s oddělenými souborovými systémy a sítěmi
Nativní Runtime — běží jako uživatelský proces, scoped na workspace defaultně

Allowlisty

Kanály mohou omezit přístup podle user ID:

[channels.telegram]
enabled = true
allowed_users = [123456789, 987654321]  # Explicitní allowlist

Šifrování

Matrix E2EE — plné end-to-end šifrování s ověřením zařízení
TLS Transport — veškerý API a tunnel provoz používá HTTPS/TLS

Viz Bezpečnostní dokumentace pro kompletní politiky a praktiky.

Pozorovatelnost

ZeroClaw loguje do ~/.zeroclaw/workspace/logs/ defaultně. Logy jsou ukládány podle komponenty:

~/.zeroclaw/workspace/logs/
├── daemon.log           # Daemon logy (startup, API požadavky, chyby)
├── agent.log            # Agent logy (směrování zpráv, provedení nástrojů)
├── telegram.log         # Kanál-specifické logy (pokud povoleno)
└── matrix.log           # Kanál-specifické logy (pokud povoleno)

Konfigurace Logování

[logging]
level = "info"                           # debug, info, warn, error
path = "~/.zeroclaw/workspace/logs/"
rotation = "daily"                       # daily, hourly, size
max_size_mb = 100                        # Pro rotaci založenou na velikosti
retention_days = 30                      # Automatické čištění po N dnech

Viz Konfigurační reference pro všechny možnosti logování.

Metriky (Plánováno)

Podpora Prometheus metrik pro produkční monitoring již brzy. Sledování v #234.

Dovednosti

ZeroClaw podporuje vlastní dovednosti — opakovaně použitelné moduly rozšiřující schopnosti systému.

Definice Dovednosti

Dovednosti jsou uloženy v ~/.zeroclaw/workspace/skills/<skill-name>/ s touto strukturou:

skills/
└── my-skill/
    ├── skill.toml       # Metadata dovednosti (název, popis, závislosti)
    ├── prompt.md        # Systémový prompt pro AI
    └── tools/           # Volitelné vlastní nástroje
        └── my_tool.py

Příklad Dovednosti

# skills/web-research/skill.toml
[skill]
name = "web-research"
description = "Hledá na webu a shrnuje výsledky"
version = "1.0.0"

[dependencies]
tools = ["web_fetch", "bash"]

<!-- skills/web-research/prompt.md -->

Jste výzkumný asistent. Když požádáte o výzkum něčeho:

1. Použijte web_fetch pro získání obsahu
2. Shrňte výsledky v snadno čitelném formátu
3. Citujte zdroje s URL

Použití Dovedností

Dovednosti jsou automaticky načítány při startu agenta. Odkazujte na ně jménem v konverzacích:

Uživatel: Použij dovednost web-research k nalezení nejnovějších AI zpráv
Bot: [načte dovednost web-research, provede web_fetch, shrne výsledky]

Viz sekce Dovednosti pro kompletní instrukce tvorby dovedností.

Open Skills

ZeroClaw podporuje Open Skills — modulární a poskytovatel-agnostický systém pro rozšíření schopností AI agentů.

Povolit Open Skills

[skills]
open_skills_enabled = true
# open_skills_dir = "/path/to/open-skills"  # volitelné

Můžete také přepsat za běhu pomocí ZEROCLAW_OPEN_SKILLS_ENABLED a ZEROCLAW_OPEN_SKILLS_DIR.

Vývoj

cargo build              # Dev build
cargo build --release    # Release build (codegen-units=1, funguje na všech zařízeních včetně Raspberry Pi)
cargo build --profile release-fast    # Rychlejší build (codegen-units=8, vyžaduje 16 GB+ RAM)
cargo test               # Spustí plnou testovací sadu
cargo clippy --locked --all-targets -- -D clippy::correctness
cargo fmt                # Formátování

# Spusťte SQLite vs Markdown srovnávací benchmark
cargo test --test memory_comparison -- --nocapture

Pre-push hook

Git hook spouští cargo fmt --check, cargo clippy -- -D warnings, a cargo test před každým push. Povolte jej jednou:

git config core.hooksPath .githooks

Řešení problémů s Buildem (OpenSSL chyby na Linuxu)

Pokud narazíte na openssl-sys build chybu, synchronizujte závislosti a znovu zkompilujte s lockfile repoziťáře:

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

ZeroClaw je nakonfigurován pro použití rustls pro HTTP/TLS závislosti; --locked udržuje transitivní graf deterministický v čistých prostředích.

Pro přeskočení hooku když potřebujete rychlý push během vývoje:

git push --no-verify

Spolupráce & Docs

Začněte s dokumentačním centrem pro task-based mapu:

Dokumentační Centrum: docs/README.md
Sjednocený Docs TOC: docs/SUMMARY.md
Příkazová reference: docs/commands-reference.md
Konfigurační reference: docs/config-reference.md
Poskytovatel reference: docs/providers-reference.md
Kanálová reference: docs/channels-reference.md
Operations Runbook: docs/operations-runbook.md
Řešení problémů: docs/troubleshooting.md
Docs Inventář/Klasifikace: docs/docs-inventory.md
PR/Issue Triage Snapshot (k 18. únoru 2026): docs/project-triage-snapshot-2026-02-18.md

Hlavní spolupráční reference:

Dokumentační Centrum: docs/README.md
Šablona dokumentace: docs/doc-template.md
Checklist změn dokumentace: docs/README.md#4-documentation-change-checklist
Reference konfigurace kanálů: docs/channels-reference.md
Operace šifrovaných místností Matrix: docs/matrix-e2ee-guide.md
Průvodce příspíváním: CONTRIBUTING.md
PR Workflow politika: docs/pr-workflow.md
Reviewer Playbook (triage + hluboká recenze): docs/reviewer-playbook.md
Mapa vlastnictví a CI triage: docs/ci-map.md
Bezpečnostní disclosure politika: SECURITY.md

Pro nasazení a runtime operace:

Průvodce síťovým nasazením: docs/network-deployment.md
Proxy Agent Playbook: docs/proxy-agent-playbook.md

Podpořte ZeroClaw

Pokud ZeroClaw pomáhá vaší práci a chcete podpořit pokračující vývoj, můžete darovat zde:

🙏 Speciální Poděkování

Upřímné poděkování komunitám a institucím které inspirují a živí tuto open-source práci:

Harvard University — za podporu intelektuální zvídavosti a posouvání hranic toho co je možné.
MIT — za obhajobu otevřeného vědění, open source, a přesvědčení že technologie by měla být přístupná všem.
Sundai Club — za komunitu, energii, a neustálou vůli stavět věci které na něčem záleží.
Svět a Dál 🌍✨ — každému přispěvateli, snílkovi, a staviteli tam venku který dělá z open source sílu pro dobro. To je pro tebe.

Stavíme v open source protože nejlepší nápady přicházejí odkudkoliv. Pokud toto čtete, jste součástí toho. Vítejte. 🦀❤️

⚠️ Oficiální Repoziťář a Varování před Vydáváním se

Toto je jediný oficiální ZeroClaw repoziťář:

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

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

Pokud narazíte na vydávání se nebo zneužití ochranné známky, prosím otevřete issue.

Licence

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

Licence	Případy použití
MIT	Open-source, výzkum, akademické, osobní použití
Apache 2.0	Ochrana patentů, institucionální, komerční nasazení

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

Ochranná známka

Název ZeroClaw a logo jsou registrované ochranné známky ZeroClaw Labs. Tato licence neuděluje povolení je používat k naznačení schválení nebo afiliace. Viz TRADEMARK.md pro povolená a zakázaná použití.

Ochrany přispěvatelů

Si zachováváte autorská práva k vašim příspěvkům
Patentový grant (Apache 2.0) vás chrání před patentovými nároky ostatních přispěvatelů
Vaše příspěvky jsou trvale připsány v historii commitů a NOTICE
Žádná práva ochranné známky nejsou přenesena příspěvkem

Příspívání

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

Průvodce CI workflow: docs/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á Skill → ~/.zeroclaw/workspace/skills/<n>/

ZeroClaw — Nulová režie. Nulové kompromisy. Nasazujte kdekoliv. Měňte cokoliv. 🦀

FilesExpand file tree

README.cs.md

Latest commit

History