<p align="center">
  <img src="zeroclaw.png" alt="ZeroClaw" width="200" />
</p>

<h1 align="center">ZeroClaw 🦀</h1>

<p align="center">
  <strong>Nulová režie. Nulové kompromisy. 100% Rust. 100% Agnostický.</strong><br>
  ⚡️ <strong>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!</strong>
</p>

<p align="center">
  <a href="LICENSE-APACHE"><img src="https://img.shields.io/badge/license-MIT%20OR%20Apache%202.0-blue.svg" alt="License: MIT OR Apache-2.0" /></a>
  <a href="NOTICE"><img src="https://img.shields.io/badge/contributors-27+-green.svg" alt="Contributors" /></a>
  <a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee" alt="Buy Me a Coffee" /></a>
  <a href="https://x.com/zeroclawlabs?s=21"><img src="https://img.shields.io/badge/X-%40zeroclawlabs-000000?style=flat&logo=x&logoColor=white" alt="X: @zeroclawlabs" /></a>
  <a href="https://zeroclawlabs.cn/group.jpg"><img src="https://img.shields.io/badge/WeChat-Group-B7D7A8?logo=wechat&logoColor=white" alt="WeChat Group" /></a>
  <a href="https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search"><img src="https://img.shields.io/badge/Xiaohongshu-Official-FF2442?style=flat" alt="Xiaohongshu: Official" /></a>
  <a href="https://t.me/zeroclawlabs"><img src="https://img.shields.io/badge/Telegram-%40zeroclawlabs-26A5E4?style=flat&logo=telegram&logoColor=white" alt="Telegram: @zeroclawlabs" /></a>
  <a href="https://www.facebook.com/groups/zeroclaw"><img src="https://img.shields.io/badge/Facebook-Group-1877F2?style=flat&logo=facebook&logoColor=white" alt="Facebook Group" /></a>
  <a href="https://www.reddit.com/r/zeroclawlabs/"><img src="https://img.shields.io/badge/Reddit-r%2Fzeroclawlabs-FF4500?style=flat&logo=reddit&logoColor=white" alt="Reddit: r/zeroclawlabs" /></a>
</p>
<p align="center">
Postaveno studenty a členy komunit Harvard, MIT a Sundai.Club.
</p>

<p align="center">
  🌐 <strong>Jazyky:</strong><a href="README.md">🇺🇸 English</a> ·
  <a href="README.zh-CN.md">🇨🇳 简体中文</a> ·
  <a href="README.ja.md">🇯🇵 日本語</a> ·
  <a href="README.ko.md">🇰🇷 한국어</a> ·
  <a href="README.vi.md">🇻🇳 Tiếng Việt</a> ·
  <a href="README.tl.md">🇵🇭 Tagalog</a> ·
  <a href="README.es.md">🇪🇸 Español</a> ·
  <a href="README.pt.md">🇧🇷 Português</a> ·
  <a href="README.it.md">🇮🇹 Italiano</a> ·
  <a href="README.de.md">🇩🇪 Deutsch</a> ·
  <a href="README.fr.md">🇫🇷 Français</a> ·
  <a href="README.ar.md">🇸🇦 العربية</a> ·
  <a href="README.hi.md">🇮🇳 हिन्दी</a> ·
  <a href="README.ru.md">🇷🇺 Русский</a> ·
  <a href="README.bn.md">🇧🇩 বাংলা</a> ·
  <a href="README.he.md">🇮🇱 עברית</a> ·
  <a href="README.pl.md">🇵🇱 Polski</a> ·
  <a href="README.cs.md">🇨🇿 Čeština</a> ·
  <a href="README.nl.md">🇳🇱 Nederlands</a> ·
  <a href="README.tr.md">🇹🇷 Türkçe</a> ·
  <a href="README.uk.md">🇺🇦 Українська</a> ·
  <a href="README.id.md">🇮🇩 Bahasa Indonesia</a> ·
  <a href="README.th.md">🇹🇭 ไทย</a> ·
  <a href="README.ur.md">🇵🇰 اردو</a> ·
  <a href="README.ro.md">🇷🇴 Română</a> ·
  <a href="README.sv.md">🇸🇪 Svenska</a> ·
  <a href="README.el.md">🇬🇷 Ελληνικά</a> ·
  <a href="README.hu.md">🇭🇺 Magyar</a> ·
  <a href="README.fi.md">🇫🇮 Suomi</a> ·
  <a href="README.da.md">🇩🇰 Dansk</a> ·
  <a href="README.nb.md">🇳🇴 Norsk</a>
</p>

<p align="center">
  <a href="#rychlý-start">Rychlý Start</a> |
  <a href="bootstrap.sh">Jedno-klikové nastavení</a> |
  <a href="docs/README.md">Dokumentační Centrum</a> |
  <a href="docs/SUMMARY.md">Obsah Dokumentace</a>
</p>

<p align="center">
  <strong>Rychlý přístup:</strong>
  <a href="docs/reference/README.md">Reference</a> ·
  <a href="docs/operations/README.md">Operace</a> ·
  <a href="docs/troubleshooting.md">Řešení problémů</a> ·
  <a href="docs/security/README.md">Bezpečnost</a> ·
  <a href="docs/hardware/README.md">Hardware</a> ·
  <a href="docs/contributing/README.md">Příspívání</a>
</p>

<p align="center">
  <strong>Rychlá, lehká a plně autonomní AI asistent infrastruktura</strong><br />
  Nasazujte kdekoliv. Měňte cokoliv.
</p>

<p align="center">
  ZeroClaw je <strong>operační systém runtime</strong> pro workflow agentů — infrastruktura která abstrahuje modely, nástroje, paměť a provádění pro stavbu agentů jednou a spouštění kdekoliv.
</p>

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

### 📢 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ťář](https://github.com/zeroclaw-labs/zeroclaw) a naše ověřené sociální účty.                                                                                                                                                                                                                                                                                                                                                          |
| 2026-02-21 | _Důležité_ | Náš oficiální web je nyní online: [zeroclawlabs.ai](https://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ťář](https://github.com/zeroclaw-labs/zeroclaw) jako jediný zdroj pravdy. Sledujte [X (@zeroclawlabs)](https://x.com/zeroclawlabs?s=21), [Telegram (@zeroclawlabs)](https://t.me/zeroclawlabs), [Facebook (skupina)](https://www.facebook.com/groups/zeroclaw), [Reddit (r/zeroclawlabs)](https://www.reddit.com/r/zeroclawlabs/), a [Xiaohongshu](https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search) 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](https://code.claude.com/docs/en/legal-and-compliance#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šší.

<p align="center">
  <img src="zero-claw.jpeg" alt="Porovnání ZeroClaw vs OpenClaw" width="800" />
</p>

### 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ě:

```bash
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

<details>
<summary><strong>Windows</strong></summary>

### Windows — Vyžadováno

1. **Visual Studio Build Tools** (poskytuje MSVC linker a Windows SDK):

    ```powershell
    winget install Microsoft.VisualStudio.2022.BuildTools
    ```

    Během instalace (nebo přes Visual Studio Installer), vyberte workload **"Desktop development with C++"**.

2. **Rust Toolchain:**

    ```powershell
    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í.

3. **Ověřte** že oba fungují:
    ```powershell
    rustc --version
    cargo --version
    ```

### Windows — Volitelné

- **Docker Desktop** — vyžadováno pouze pokud používáte [Docker sandboxed runtime](#aktuální-runtime-podpora) (`runtime.kind = "docker"`). Nainstalujte přes `winget install Docker.DockerDesktop`.

</details>

<details>
<summary><strong>Linux / macOS</strong></summary>

### Linux / macOS — Vyžadováno

1. **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`

2. **Rust Toolchain:**

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

    Viz [rustup.rs](https://rustup.rs) pro detaily.

3. **Ověřte:**
    ```bash
    rustc --version
    cargo --version
    ```

### Linux / macOS — Volitelné

- **Docker** — vyžadováno pouze pokud používáte [Docker sandboxed runtime](#aktuální-runtime-podpora) (`runtime.kind = "docker"`).
    - **Linux (Debian/Ubuntu):** viz [docs.docker.com](https://docs.docker.com/engine/install/ubuntu/)
    - **Linux (Fedora/RHEL):** viz [docs.docker.com](https://docs.docker.com/engine/install/fedora/)
    - **macOS:** nainstalujte Docker Desktop přes [docker.com/products/docker-desktop](https://www.docker.com/products/docker-desktop/)

</details>

## 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í:

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

Toto:

1. Nainstaluje Rust (pokud chybí)
2. Naklonuje ZeroClaw repoziťář
3. Zkompiluje ZeroClaw v release módu
4. Nainstaluje `zeroclaw` do `~/.cargo/bin/`
5. Vytvoří výchozí workspace strukturu v `~/.zeroclaw/workspace/`
6. 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

<details>
<summary><strong>Klikněte pro zobrazení kroků manuální instalace</strong></summary>

```bash
# 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
```

</details>

### 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:**

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

## Konfigurace

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

### Rychlá konfigurační reference

```toml
[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](docs/config-reference.md) — všechna nastavení, validace, výchozí hodnoty
- [Poskytovatel reference](docs/providers-reference.md) — AI poskytovatel-specifické konfigurace
- [Kanálová reference](docs/channels-reference.md) — Telegram, Matrix, Slack, Discord a další
- [Operace](docs/operations-runbook.md) — 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](docs/config-reference.md#runtime) pro úplné detaily.

## Příkazy

```bash
# 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](docs/commands-reference.md) 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](docs/architecture.svg) pro detailní diagramy a detaily implementace.

## Příklady

### Telegram Bot

```toml
[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í)

```toml
[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](docs/matrix-e2ee-guide.md) pro nastavení ověření zařízení.

### Multi-Poskytovatel

```toml
[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ěť

```toml
[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í:

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

Viz [Konfigurační reference](docs/config-reference.md#memory) 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:

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

Příklad: použijte [LiteLLM](https://github.com/BerriAI/litellm) jako proxy pro přístup k jakémukoli LLM přes OpenAI rozhraní.

Viz [Poskytovatel reference](docs/providers-reference.md) 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](docs/channels-reference.md) 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`:

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

Viz [Konfigurační reference](docs/config-reference.md#runtime) pro kompletní možnosti bezpečnosti.

## Nasazení

### Lokální Nasazení (Vývoj)

```bash
zeroclaw daemon start
zeroclaw agent start
```

### Serverové Nasazení (Produkce)

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

```bash
# 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](docs/network-deployment.md) pro kompletní instrukce produkčního nasazení.

### Docker

```bash
# 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`](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](docs/hardware/README.md) 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:

```bash
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](docs/config-reference.md#tunnel) 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í.

```bash
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:

```toml
[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](docs/security/README.md) 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í

```toml
[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](docs/config-reference.md#logging) pro všechny možnosti logování.

### Metriky (Plánováno)

Podpora Prometheus metrik pro produkční monitoring již brzy. Sledování v [#234](https://github.com/zeroclaw-labs/zeroclaw/issues/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

```toml
# 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"]
```

```markdown
<!-- 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](#dovednosti) pro kompletní instrukce tvorby dovedností.

## Open Skills

ZeroClaw podporuje [Open Skills](https://github.com/openagents-com/open-skills) — modulární a poskytovatel-agnostický systém pro rozšíření schopností AI agentů.

### Povolit Open Skills

```toml
[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

```bash
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:

```bash
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:

```bash
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:

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

Hlavní spolupráční reference:

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

Pro nasazení a runtime operace:

- Průvodce síťovým nasazením: [docs/network-deployment.md](docs/network-deployment.md)
- Proxy Agent Playbook: [docs/proxy-agent-playbook.md](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:

<a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=for-the-badge&logo=buy-me-a-coffee" alt="Kup Mi Kávu" /></a>

### 🙏 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](TRADEMARK.md).

Pokud narazíte na vydávání se nebo zneužití ochranné známky, prosím [otevřete issue](https://github.com/zeroclaw-labs/zeroclaw/issues).

---

## Licence

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

| Licence                      | Případy použití                                            |
| ---------------------------- | ------------------------------------------------------------ |
| [MIT](LICENSE-MIT)               | Open-source, výzkum, akademické, osobní použití          |
| [Apache 2.0](LICENSE-APACHE) | 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](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](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](NOTICE)
- Žádná práva ochranné známky nejsou přenesena příspěvkem

## Příspívání

Viz [CONTRIBUTING.md](CONTRIBUTING.md) a [CLA.md](CLA.md). Implementujte trait, odešlete PR:

- Průvodce CI workflow: [docs/ci-map.md](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. 🦀

## Historie Hvězd

<p align="center">
  <a href="https://www.star-history.com/#zeroclaw-labs/zeroclaw&type=date&legend=top-left">
    <picture>
     <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&theme=dark&legend=top-left" />
     <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&legend=top-left" />
     <img alt="Graf Historie Hvězd" src="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&legend=top-left" />
    </picture>
  </a>
</p>
