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

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

<p align="center">
  <strong>Zero narzutu. Zero kompromisów. 100% Rust. 100% Agnostyczny.</strong><br>
  ⚡️ <strong>Działa na sprzęcie za $10 z <5MB RAM: To 99% mniej pamięci niż OpenClaw i 98% taniej niż 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">
Zbudowany przez studentów i członków społeczności Harvard, MIT i Sundai.Club.
</p>

<p align="center">
  🌐 <strong>Języki:</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="#szybki-start">Szybki Start</a> |
  <a href="bootstrap.sh">Konfiguracja Jednym Kliknięciem</a> |
  <a href="docs/README.md">Centrum Dokumentacji</a> |
  <a href="docs/SUMMARY.md">Spis Treści Dokumentacji</a>
</p>

<p align="center">
  <strong>Szybki dostęp:</strong>
  <a href="docs/reference/README.md">Referencje</a> ·
  <a href="docs/operations/README.md">Operacje</a> ·
  <a href="docs/troubleshooting.md">Rozwiązywanie Problemów</a> ·
  <a href="docs/security/README.md">Bezpieczeństwo</a> ·
  <a href="docs/hardware/README.md">Sprzęt</a> ·
  <a href="docs/contributing/README.md">Wkład</a>
</p>

<p align="center">
  <strong>Szybka, lekka i w pełni autonomiczna infrastruktura asystenta AI</strong><br />
  Wdrażaj wszędzie. Zamieniaj cokolwiek.
</p>

<p align="center">
  ZeroClaw to <strong>system operacyjny runtime</strong> dla workflow agentów — infrastruktura abstrahująca modele, narzędzia, pamięć i wykonanie do budowania agentów raz i uruchamiania ich wszędzie.
</p>

<p align="center"><code>Architektura oparta na traitach · bezpieczny runtime domyślnie · wymienny dostawca/kanał/narzędzie · wszystko jest podłączalne</code></p>

<!-- BEGIN:WHATS_NEW -->

### 🚀 What's New in v0.2.2-beta.190 (March 2026)

| Area | Highlights |
|---|---|
| channels | comprehensive channel matrix tests + v0.2.2 |
| ci | auto-sync README What's New and Contributors on release |

<!-- END:WHATS_NEW -->

### 📢 Ogłoszenia

Użyj tej tabeli dla ważnych ogłoszeń (zmiany kompatybilności, powiadomienia bezpieczeństwa, okna serwisowe i blokady wersji).

| Data (UTC) | Poziom      | Ogłoszenie                                                                                                                                                                                                                                                                                                                                                                                                              | Działanie                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ---------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |   |
| 2026-02-19 | _Krytyczny_  | **Nie jesteśmy powiązani** z `openagen/zeroclaw` lub `zeroclaw.org`. Domena `zeroclaw.org` obecnie wskazuje na fork `openagen/zeroclaw`, i ta domena/repozytorium podszywa się pod naszą oficjalną stronę/projekt.                                                                                                                                                                                 | Nie ufaj informacjom, plikom binarnym, zbiórkom funduszy lub ogłoszeniom z tych źródeł. Używaj tylko [tego repozytorium](https://github.com/zeroclaw-labs/zeroclaw) i naszych zweryfikowanych kont społecznościowych.                                                                                                                                                                                                                                                                                                                                                          |
| 2026-02-21 | _Ważne_ | Nasza oficjalna strona jest teraz online: [zeroclawlabs.ai](https://zeroclawlabs.ai). Dziękujemy za cierpliwość podczas oczekiwania. Nadal wykrywamy próby podszywania się: nie uczestnicz w żadnej działalności inwestycyjnej/finansowej w imieniu ZeroClaw jeśli nie jest opublikowana przez nasze oficjalne kanały.                                                                                                                   | Używaj [tego repozytorium](https://github.com/zeroclaw-labs/zeroclaw) jako jedynego źródła prawdy. Śledź [X (@zeroclawlabs)](https://x.com/zeroclawlabs?s=21), [Telegram (@zeroclawlabs)](https://t.me/zeroclawlabs), [Facebook (grupa)](https://www.facebook.com/groups/zeroclaw), [Reddit (r/zeroclawlabs)](https://www.reddit.com/r/zeroclawlabs/), i [Xiaohongshu](https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search) dla oficjalnych aktualizacji. |
| 2026-02-19 | _Ważne_ | Anthropic zaktualizował warunki używania uwierzytelniania i poświadczeń 2026-02-19. Uwierzytelnianie OAuth (Free, Pro, Max) jest wyłącznie dla Claude Code i Claude.ai; używanie tokenów OAuth Claude Free/Pro/Max w jakimkolwiek innym produkcie, narzędziu lub usłudze (w tym Agent SDK) nie jest dozwolone i może naruszać Warunki Użytkowania Konsumenta. | Prosimy tymczasowo unikać integracji OAuth Claude Code aby zapobiec potencjalnym stratom. Oryginalna klauzula: [Authentication and Credential Use](https://code.claude.com/docs/en/legal-and-compliance#authentication-and-credential-use).                                                                                                                                                                                                                                                                                                                      |

### ✨ Funkcje

- 🏎️ **Lekki Runtime Domyślnie:** Typowe workflow CLI i komendy statusu działają w przestrzeni pamięci kilku megabajtów w buildach produkcyjnych.
- 💰 **Ekonomiczne Wdrażanie:** Zaprojektowane dla tanich płytek i małych instancji chmurowych bez ciężkich zależności runtime.
- ⚡ **Szybkie Zimne Starty:** Runtime Rust pojedynczego binarium utrzymuje start komend i daemonów niemal natychmiastowy dla codziennych operacji.
- 🌍 **Przenośna Architektura:** Pojedynczy workflow binarium na ARM, x86 i RISC-V z wymiennym dostawcą/kanałem/narzędziem.

### Dlaczego zespoły wybierają ZeroClaw

- **Lekki domyślnie:** mały binarium Rust, szybki start, niski ślad pamięci.
- **Bezpieczny przez design:** parowanie, ścisłe sandboxowanie, jawne listy dozwolone, zakres workspace.
- **Całkowicie wymienny:** systemy rdzenne to trait-y (dostawcy, kanały, narzędzia, pamięć, tunele).
- **Brak blokady dostawcy:** wsparcie dostawcy kompatybilnego z OpenAI + podłączalne własne endpointy.

## Snapshot Benchmark (ZeroClaw vs OpenClaw, Reprodukowalne)

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

|                              | OpenClaw      | NanoBot        | PicoClaw        | ZeroClaw 🦀           |
| ---------------------------- | ------------- | -------------- | --------------- | --------------------- |
| **Język**                  | TypeScript    | Python         | Go              | **Rust**              |
| **RAM**                      | > 1 GB        | > 100 MB       | < 10 MB         | **< 5 MB**            |
| **Start (rdzeń 0.8 GHz)** | > 500s        | > 30s          | < 1s            | **< 10ms**            |
| **Rozmiar Binarny**           | ~28 MB (dist) | N/A (Skrypty)  | ~8 MB           | **3.4 MB**            |
| **Koszt**                     | Mac Mini $599 | Linux SBC ~$50 | Płytka Linux $10 | **Dowolny sprzęt $10** |

> Uwagi: Wyniki ZeroClaw są mierzone na buildach produkcyjnych używając `/usr/bin/time -l`. OpenClaw wymaga runtime Node.js (typowo ~390 MB dodatkowego narzutu pamięci), podczas gdy NanoBot wymaga runtime Python. PicoClaw i ZeroClaw to statyczne binaria. Powyższe liczby RAM to pamięć runtime; wymagania kompilacji w czasie build są wyższe.

<p align="center">
  <img src="zero-claw.jpeg" alt="Porównanie ZeroClaw vs OpenClaw" width="800" />
</p>

### Reprodukowalny Pomiar Lokalny

Twierdzenia benchmark mogą się zmieniać wraz z ewolucją kodu i toolchainów, więc zawsze mierz swój aktualny build lokalnie:

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

Przykładowa próbka (macOS arm64, zmierzone 18 lutego 2026):

- Rozmiar binarium release: `8.8M`
- `zeroclaw --help`: czas rzeczywisty ok. `0.02s`, szczytowy ślad pamięci ~`3.9 MB`
- `zeroclaw status`: czas rzeczywisty ok. `0.01s`, szczytowy ślad pamięci ~`4.1 MB`

## Wymagania Wstępne

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

### Windows — Wymagane

1. **Visual Studio Build Tools** (dostarcza linker MSVC i Windows SDK):

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

    Podczas instalacji (lub przez Visual Studio Installer), wybierz obciążenie **"Desktop development with C++"**.

2. **Toolchain Rust:**

    ```powershell
    winget install Rustlang.Rustup
    ```

    Po instalacji, otwórz nowy terminal i uruchom `rustup default stable` aby upewnić się, że stabilny toolchain jest aktywny.

3. **Zweryfikuj** że oba działają:
    ```powershell
    rustc --version
    cargo --version
    ```

### Windows — Opcjonalne

- **Docker Desktop** — wymagany tylko jeśli używasz [Docker sandboxed runtime](#aktualne-wsparcie-runtime) (`runtime.kind = "docker"`). Zainstaluj przez `winget install Docker.DockerDesktop`.

</details>

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

### Linux / macOS — Wymagane

1. **Niezbędne narzędzia build:**
    - **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:** Zainstaluj Xcode Command Line Tools: `xcode-select --install`

2. **Toolchain Rust:**

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

    Zobacz [rustup.rs](https://rustup.rs) dla szczegółów.

3. **Zweryfikuj:**
    ```bash
    rustc --version
    cargo --version
    ```

### Linux / macOS — Opcjonalne

- **Docker** — wymagany tylko jeśli używasz [Docker sandboxed runtime](#aktualne-wsparcie-runtime) (`runtime.kind = "docker"`).
    - **Linux (Debian/Ubuntu):** zobacz [docs.docker.com](https://docs.docker.com/engine/install/ubuntu/)
    - **Linux (Fedora/RHEL):** zobacz [docs.docker.com](https://docs.docker.com/engine/install/fedora/)
    - **macOS:** zainstaluj Docker Desktop przez [docker.com/products/docker-desktop](https://www.docker.com/products/docker-desktop/)

</details>

## Szybki Start

### Opcja 1: Automatyczna konfiguracja (zalecana)

Skrypt `bootstrap.sh` instaluje Rust, klonuje ZeroClaw, kompiluje go i konfiguruje twoje początkowe środowisko deweloperskie:

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

To:

1. Zainstaluje Rust (jeśli nieobecny)
2. Sklonuje repozytorium ZeroClaw
3. Skompiluje ZeroClaw w trybie release
4. Zainstaluje `zeroclaw` w `~/.cargo/bin/`
5. Utworzy domyślną strukturę workspace w `~/.zeroclaw/workspace/`
6. Wygeneruje początkowy plik konfiguracyjny `~/.zeroclaw/workspace/config.toml`

Po bootstrap, przeładuj swój shell lub uruchom `source ~/.cargo/env` aby używać komendy `zeroclaw` globalnie.

### Opcja 2: Ręczna instalacja

<details>
<summary><strong>Kliknij aby zobaczyć kroki ręcznej instalacji</strong></summary>

```bash
# 1. Sklonuj repozytorium
git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw

# 2. Skompiluj w release
cargo build --release --locked

# 3. Zainstaluj binarium
cargo install --path . --locked

# 4. Zinicjuj workspace
zeroclaw init

# 5. Zweryfikuj instalację
zeroclaw --version
zeroclaw status
```

</details>

### Po Instalacji

Po zainstalowaniu (przez bootstrap lub ręcznie), powinieneś widzieć:

```
~/.zeroclaw/workspace/
├── config.toml          # Główna konfiguracja
├── .pairing             # Sekrety parowania (generowane przy pierwszym uruchomieniu)
├── logs/                # Logi daemon/agent
├── skills/              # Własne umiejętności
└── memory/              # Przechowywanie kontekstu konwersacji
```

**Następne kroki:**

1. Skonfiguruj swoich dostawców AI w `~/.zeroclaw/workspace/config.toml`
2. Sprawdź [referencje konfiguracji](docs/config-reference.md) dla opcji zaawansowanych
3. Uruchom agenta: `zeroclaw agent start`
4. Testuj przez preferowany kanał (zobacz [referencje kanałów](docs/channels-reference.md))

## Konfiguracja

Edytuj `~/.zeroclaw/workspace/config.toml` aby skonfigurować dostawców, kanały i zachowanie systemu.

### Szybka Referencja Konfiguracji

```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"  # lub "sqlite" lub "none"

[runtime]
kind = "native"    # lub "docker" (wymaga Docker)
```

**Pełne dokumenty referencyjne:**

- [Referencje Konfiguracji](docs/config-reference.md) — wszystkie ustawienia, walidacje, wartości domyślne
- [Referencje Dostawców](docs/providers-reference.md) — konfiguracje specyficzne dla dostawców AI
- [Referencje Kanałów](docs/channels-reference.md) — Telegram, Matrix, Slack, Discord i więcej
- [Operacje](docs/operations-runbook.md) — monitoring produkcyjny, rotacja sekretów, skalowanie

### Aktualne Wsparcie Runtime

ZeroClaw wspiera dwa backendy wykonania kodu:

- **`native`** (domyślnie) — bezpośrednie wykonanie procesu, najszybsza ścieżka, idealna dla zaufanych środowisk
- **`docker`** — pełna izolacja kontenera, wzmocnione polityki bezpieczeństwa, wymaga Docker

Użyj `runtime.kind = "docker"` jeśli potrzebujesz ścisłego sandboxowania lub izolacji sieciowej. Zobacz [referencje konfiguracji](docs/config-reference.md#runtime) dla pełnych szczegółów.

## Komendy

```bash
# Zarządzanie workspace
zeroclaw init                # Inicjuje nowy workspace
zeroclaw status              # Pokazuje status daemon/agent
zeroclaw config validate     # Weryfikuje składnię i wartości config.toml

# Zarządzanie daemon
zeroclaw daemon start        # Uruchamia daemon w tle
zeroclaw daemon stop         # Zatrzymuje działający daemon
zeroclaw daemon restart      # Restartuje daemon (przeładowanie config)
zeroclaw daemon logs         # Pokazuje logi daemon

# Zarządzanie agent
zeroclaw agent start         # Uruchamia agenta (wymaga działającego daemon)
zeroclaw agent stop          # Zatrzymuje agenta
zeroclaw agent restart       # Restartuje agenta (przeładowanie config)

# Operacje parowania
zeroclaw pairing init        # Generuje nowy sekret parowania
zeroclaw pairing rotate      # Rotuje istniejący sekret parowania

# Tunneling (dla publicznej ekspozycji)
zeroclaw tunnel start        # Uruchamia tunnel do lokalnego daemon
zeroclaw tunnel stop         # Zatrzymuje aktywny tunnel

# Diagnostyka
zeroclaw doctor              # Uruchamia sprawdzenia zdrowia systemu
zeroclaw version             # Pokazuje wersję i informacje o build
```

Zobacz [Referencje Komend](docs/commands-reference.md) dla pełnych opcji i przykładów.

## Współpraca i Docs

Zacznij od centrum dokumentacji dla mapy opartej na zadaniach:

- Centrum Dokumentacji: [`docs/README.md`](docs/README.md)
- Zunifikowany Spis Treści Docs: [`docs/SUMMARY.md`](docs/SUMMARY.md)
- Referencje Komend: [`docs/commands-reference.md`](docs/commands-reference.md)
- Referencje Konfiguracji: [`docs/config-reference.md`](docs/config-reference.md)
- Referencje Dostawców: [`docs/providers-reference.md`](docs/providers-reference.md)
- Referencje Kanałów: [`docs/channels-reference.md`](docs/channels-reference.md)
- Runbook Operacji: [`docs/operations-runbook.md`](docs/operations-runbook.md)
- Rozwiązywanie Problemów: [`docs/troubleshooting.md`](docs/troubleshooting.md)
- Inwentarz/Klasyfikacja Docs: [`docs/docs-inventory.md`](docs/docs-inventory.md)
- Snapshot Triages PR/Issue (stan na 18 lutego 2026): [`docs/project-triage-snapshot-2026-02-18.md`](docs/project-triage-snapshot-2026-02-18.md)

Główne referencje współpracy:

- Centrum Dokumentacji: [docs/README.md](docs/README.md)
- Szablon Dokumentacji: [docs/doc-template.md](docs/doc-template.md)
- Checklist Zmiany Dokumentacji: [docs/README.md#4-documentation-change-checklist](docs/README.md#4-documentation-change-checklist)
- Referencje Konfiguracji Kanałów: [docs/channels-reference.md](docs/channels-reference.md)
- Operacje Zaszyfrowanych Pokoi Matrix: [docs/matrix-e2ee-guide.md](docs/matrix-e2ee-guide.md)
- Przewodnik Wkładu: [CONTRIBUTING.md](CONTRIBUTING.md)
- Polityka Workflow PR: [docs/pr-workflow.md](docs/pr-workflow.md)
- Playbook Recenzenta (triage + głęboka recenzja): [docs/reviewer-playbook.md](docs/reviewer-playbook.md)
- Mapa Własności i Triages CI: [docs/ci-map.md](docs/ci-map.md)
- Polityka Ujawnienia Bezpieczeństwa: [SECURITY.md](SECURITY.md)

Dla wdrażania i operacji runtime:

- Przewodnik Wdrażania Sieciowego: [docs/network-deployment.md](docs/network-deployment.md)
- Playbook Proxy Agent: [docs/proxy-agent-playbook.md](docs/proxy-agent-playbook.md)

## Wspieraj ZeroClaw

Jeśli ZeroClaw pomaga twojej pracy i chcesz wspierać ciągły rozwój, możesz przekazać darowiznę tutaj:

<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 Kawę" /></a>

### 🙏 Specjalne Podziękowania

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

- **Harvard University** — za promowanie intelektualnej ciekawości i przesuwanie granic tego co możliwe.
- **MIT** — za obronę otwartej wiedzy, open source, i przekonania że technologia powinna być dostępna dla wszystkich.
- **Sundai Club** — za społeczność, energię, i nieustanną wolę budowania rzeczy które mają znaczenie.
- **Świat i Dalej** 🌍✨ — dla każdego kontrybutora, marzyciela, i budowniczego tam na zewnątrz który czyni open source siłą dla dobra. To dla ciebie.

Budujemy w open source ponieważ najlepsze pomysły przychodzą zewsząd. Jeśli to czytasz, jesteś tego częścią. Witamy. 🦀❤️

<!-- BEGIN:RECENT_CONTRIBUTORS -->

### 🌟 Recent Contributors (v0.2.2-beta.190)

3 contributors shipped features, fixes, and improvements in this release cycle:

- **Argenis**
- **argenis de la rosa**
- **Claude Opus 4.6**

Thank you to everyone who opened issues, reviewed PRs, translated docs, and helped test. Every contribution matters. 🦀

<!-- END:RECENT_CONTRIBUTORS -->

## ⚠️ Oficjalne Repozytorium i Ostrzeżenie o Podszywaniu Się

**To jest jedyne oficjalne repozytorium ZeroClaw:**

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

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

Jeśli napotkasz podszywanie się lub nadużycie znaku towarowego, proszę [otwórz issue](https://github.com/zeroclaw-labs/zeroclaw/issues).

---

## Licencja

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

| Licencja                      | Przypadki Użycia                                            |
| ---------------------------- | ------------------------------------------------------------ |
| [MIT](LICENSE-MIT)               | Open-source, badania, akademicki, użycie osobiste          |
| [Apache 2.0](LICENSE-APACHE) | Ochrona patentowa, instytucjonalne, wdrożenie komercyjne |

Możesz wybrać jedną z licencji. **Kontrybutorzy automatycznie przyznają prawa pod obiema** — zobacz [CLA.md](CLA.md) dla pełnej umowy kontrybutora.

### Znak Towarowy

Nazwa **ZeroClaw** i logo są zarejestrowanymi znakami towarowymi ZeroClaw Labs. Ta licencja nie przyznaje pozwolenia na ich używanie do sugerowania poparcia lub powiązania. Zobacz [TRADEMARK.md](TRADEMARK.md) dla dozwolonych i zabronionych użyć.

### Ochrony Kontrybutorów

- **Zachowuj prawa autorskie** swoich wkładów
- **Grant patentowy** (Apache 2.0) chroni cię przed roszczeniami patentowymi innych kontrybutorów
- Twoje wkłady są **trwale przypisane** w historii commitów i [NOTICE](NOTICE)
- Żadne prawa znaku towarowego nie są przenoszone przez kontrybucję

## Wkład

Zobacz [CONTRIBUTING.md](CONTRIBUTING.md) i [CLA.md](CLA.md). Zaimplementuj trait, prześlij PR:

- Przewodnik workflow CI: [docs/ci-map.md](docs/ci-map.md)
- Nowy `Provider` → `src/providers/`
- Nowy `Channel` → `src/channels/`
- Nowy `Observer` → `src/observability/`
- Nowe `Tool` → `src/tools/`
- Nowa `Memory` → `src/memory/`
- Nowy `Tunnel` → `src/tunnel/`
- Nowa `Skill` → `~/.zeroclaw/workspace/skills/<n>/`

---

**ZeroClaw** — Zero narzutu. Zero kompromisów. Wdrażaj wszędzie. Zamieniaj cokolwiek. 🦀

## Historia Gwiazdek

<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="Wykres Historii Gwiazdek" src="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&legend=top-left" />
    </picture>
  </a>
</p>
