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

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

<p align="center">
  <strong>Sıfırı aşırı yok. Sıfır ödün ver yok. %100 Rust. %100 Agnostik.</strong><br>
  ⚡️ <strong>$10 donanımla <5MB RAM ile çalışır: OpenClaw'dan %99 daha az bellek ve Mac mini'den %98 daha ucuz!</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">
Harvard, MIT ve Sundai.Club topluluklarının öğrencileri ve üyeleri tarafından inşa edilmiştir.
</p>

<p align="center">
  🌐 <strong>Diller:</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="#hızlı-başlangıç">Hızlı Başlangıç</a> |
  <a href="bootstrap.sh">Tek Tıklama Kurulumu</a> |
  <a href="docs/README.md">Dokümantasyon Merkezi</a> |
  <a href="docs/SUMMARY.md">Dokümantasyon İçindekiler</a>
</p>

<p align="center">
  <strong>Hızlı erişim:</strong>
  <a href="docs/reference/README.md">Referans</a> ·
  <a href="docs/operations/README.md">Operasyonlar</a> ·
  <a href="docs/troubleshooting.md">Sorun Giderme</a> ·
  <a href="docs/security/README.md">Güvenlik</a> ·
  <a href="docs/hardware/README.md">Donanım</a> ·
  <a href="docs/contributing/README.md">Katkıda Bulunma</a>
</p>

<p align="center">
  <strong>Hızlı, hafif ve tamamen otonom AI asistan altyapısı</strong><br />
  Her yerde dağıtın. Her şeyi değiştirin.
</p>

<p align="center">
  ZeroClaw, ajan iş akışları için <strong>çalışma zamanı işletim sistemidir</strong> — modelleri, araçları, belleği ve yürütmeyi soyutlayan, ajanları bir kez oluşturup ve her yerde çalıştıran bir altyapıdır.
</p>

<p align="center"><code>Trait tabanlı mimari · varsayılan olarak güvenli çalışma zamanı · değiştirilebilir sağlayıcı/kanal/araç · her şey eklenebilir</code></p>

### 📢 Duyurular

Önemli duyurular için bu tabloyu kullanın (uyumluluk değişiklikleri, güvenlik bildirimleri, bakım pencereleri ve sürüm engellemeleri).

| Tarih (UTC) | Seviye      | Duyuru                                                                                                                                                                                                                                                                                                                                                                                                              | Eylem                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ---------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 2026-02-19 | _Kritik_  | **`openagen/zeroclaw` veya `zeroclaw.org` ile bağlantılı değiliz.** `zeroclaw.org` alanı şu anda `openagen/zeroclaw` fork'una işaret ediyor ve bu alan/depo taklitçiliğini yapıyor.                                                                                                                                                                                 | Bu kaynaklardan bilgi, ikili dosyalar, bağış toplama veya duyurulara güvenmeyin. Sadece [bu depoyu](https://github.com/zeroclaw-labs/zeroclaw) ve doğrulanmış sosyal medya hesaplarımızı kullanın.                                                                                                                                                                                                                                                                                                                                                          |
| 2026-02-21 | _Önemli_ | Resmi web sitemiz artık çevrimiçi: [zeroclawlabs.ai](https://zeroclawlabs.ai). Bekleme sürecinde sabırlarınız için teşekkürler. Hala taklit girişimleri tespit ediyoruz: ZeroClaw adına resmi kanallarımız aracılığıyla yayınlanmayan herhangi bir yatırım/bağış faaliyetine katılmayın.                                                                                                                   | [Bu depoyu](https://github.com/zeroclaw-labs/zeroclaw) tek doğruluk kaynağı olarak kullanın. Resmi güncellemeler için [X (@zeroclawlabs)](https://x.com/zeroclawlabs?s=21), [Telegram (@zeroclawlabs)](https://t.me/zeroclawlabs), [Facebook (grup)](https://www.facebook.com/groups/zeroclaw), [Reddit (r/zeroclawlabs)](https://www.reddit.com/r/zeroclawlabs/) ve [Xiaohongshu](https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search)'u takip edin. |
| 2026-02-19 | _Önemli_ | Anthropic, 2026-02-19 tarihinde kimlik doğrulama ve kimlik bilgileri kullanım şartlarını güncelledi. OAuth kimlik doğrulaması (Free, Pro, Max) yalnızca Claude Code ve Claude.ai içindir; Claude Free/Pro/Max OAuth belirteçlerini başka herhangi bir ürün, araç veya hizmette (Agent SDK dahil) kullanmak yasaktır ve Tüketici Kullanım Şartlarını ihlal edebilir. | Olası kayıpları önlemek için lütfen geçici olarak Claude Code OAuth entegrasyonlarından kaçının. Orijinal madde: [Authentication and Credential Use](https://code.claude.com/docs/en/legal-and-compliance#authentication-and-credential-use).                                                                                                                                                                                                                                                                                                                      |

### ✨ Özellikler

- 🏎️ **Varsayılan Hafif Çalışma Zamanı:** Yaygın CLI iş akışları ve durum komutları üretim derlemelerinde birkaç megabaytlık bellek alanında çalışır.
- 💰 **Maliyet Etkin Dağıtım:** Ağır çalışma zamanı bağımlılıkları olmadan düşük maliyetli kartlar ve küçük bulut örnekleri için tasarlanmıştır.
- 💡 **Hızlı Soğuk Başlangıçlar:** Tek ikili Rust çalışma zamanı, komut ve arka plan programı başlatmalarını günlük operasyonlar için neredeyse anlık tutar.
- 🌍 **Taşınabilir Mimari:** Değiştirilebilir sağlayıcı/kanal/araç ile ARM, x86 ve RISC-V üzerinde tek ikili iş akışı.

### Neden ekipler ZeroClaw'ı seçiyor

- **Varsayılan hafif:** küçük Rust ikilisi, hızlı başlangıç, düşük bellek ayak izi.
- **Tasarıma göre güvenli:** eşleştirme, katı kum alanı, açık izin listeleri, çalışma alanı kapsamı.
- **Tamamen değiştirilebilir:** çekirdek sistemler trait'tir (sağlayıcılar, kanallar, araçlar, bellek, tüneller).
- **Satıcı kilitlenmesi yok:** OpenAI uyumlu sağlayıcı desteği + eklenebilir özel uç noktalar.

## Kıyaslama Anlık Görüntüsü (ZeroClaw vs OpenClaw, Tekrarlanabilir)

Yerel makinede hızlı kıyaslama (macOS arm64, Şub. 2026) 0.8 GHz uç donanımı için normalize edilmiş.

|                              | OpenClaw      | NanoBot        | PicoClaw        | ZeroClaw 🦀           |
| ---------------------------- | ------------- | -------------- | --------------- | --------------------- |
| **Dil**                  | TypeScript    | Python         | Go              | **Rust**              |
| **RAM**                      | > 1 GB        | > 100 MB       | < 10 MB         | **< 5 MB**            |
| **Başlangıç (0.8 GHz çekirdek)** | > 500s        | > 30s          | < 1s            | **< 10ms**            |
| **İkili Boyut**           | ~28 MB (dist) | Yok (Betikler)  | ~8 MB           | **3.4 MB**            |
| **Maliyet**                     | Mac Mini $599 | Linux SBC ~$50 | Linux kart $10 | **Herhangi bir donanım $10** |

> Notlar: ZeroClaw sonuçları `/usr/bin/time -l` kullanılarak üretim derlemelerinde ölçülür. OpenClaw Node.js çalışma zamanı gerektirir (tipik olarak ~390 MB ek bellek yükü), NanoBot ise Python çalışma zamanı gerektirir. PicoClaw ve ZeroClaw statik ikililerdir. Yukarıdaki RAM rakamları çalışma zamanı belleğidir; derleme zamanı derleme gereksinimleri daha yüksektir.

<p align="center">
  <img src="zero-claw.jpeg" alt="ZeroClaw vs OpenClaw Karşılaştırması" width="800" />
</p>

### Tekrarlanabilir Yerel Ölçüm

Kıyaslama iddiaları kod ve araç zincirleri geliştikçe değişebilir, bu yüzden her zaman mevcut derlemenizi yerel olarak ölçün:

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

Örnek numune (macOS arm64, 18 Şubat 2026'da ölçüldü):

- Sürüm ikili boyutu: `8.8M`
- `zeroclaw --help`: gerçek süre yaklaşık `0.02s`, en büyük bellek ayak izi ~`3.9 MB`
- `zeroclaw status`: gerçek süre yaklaşık `0.01s`, en büyük bellek ayak izi ~`4.1 MB`

## Ön Koşullar

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

### Windows — Gerekli

1. **Visual Studio Build Tools** (MSVC bağlayıcısını ve Windows SDK'yı sağlar):

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

    Kurulum sırasında (veya Visual Studio Installer aracılığıyla), **"C++ ile Masaüstü Geliştirme"** iş yükünü seçin.

2. **Rust Araç Zinciri:**

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

    Kurulumdan sonra, yeni bir terminal açın ve kararlı araç zincirinin aktif olduğundan emin olmak için `rustup default stable` çalıştırın.

3. **Doğrulayın** ikisinin de çalıştığını:
    ```powershell
    rustc --version
    cargo --version
    ```

### Windows — İsteğe Bağlı

- **Docker Desktop** — yalnızca [Docker kum alanlı çalışma zamanı](#mevcut-çalışma-zamanı-desteği) kullanıyorsanız gereklidir (`runtime.kind = "docker"`). `winget install Docker.DockerDesktop` aracılığıyla yükleyin.

</details>

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

### Linux / macOS — Gerekli

1. **Temel derleme araçları:**
    - **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:** Xcode Command Line Tools'u yükleyin: `xcode-select --install`

2. **Rust Araç Zinciri:**

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

    Detaylar için [rustup.rs](https://rustup.rs) adresine bakın.

3. **Doğrulayın:**
    ```bash
    rustc --version
    cargo --version
    ```

### Linux / macOS — İsteğe Bağlı

- **Docker** — yalnızca [Docker kum alanlı çalışma zamanı](#mevcut-çalışma-zamanı-desteği) kullanıyorsanız gereklidir (`runtime.kind = "docker"`).
    - **Linux (Debian/Ubuntu):** [docs.docker.com](https://docs.docker.com/engine/install/ubuntu/) adresine bakın
    - **Linux (Fedora/RHEL):** [docs.docker.com](https://docs.docker.com/engine/install/fedora/) adresine bakın
    - **macOS:** [docker.com/products/docker-desktop](https://www.docker.com/products/docker-desktop/) adresinden Docker Desktop'u yükleyin

</details>

## Hızlı Başlangıç

### Seçenek 1: Otomatik kurulum (önerilen)

`bootstrap.sh` betiği Rust'u yükler, ZeroClaw'ı klonlar, derler ve ilk geliştirme ortamınızı ayarlar:

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

Bu işlem:

1. Rust'u yükler (yoksa)
2. ZeroClaw deposunu klonlar
3. ZeroClaw'ı sürüm modunda derler
4. `zeroclaw`'ı `~/.cargo/bin/`e yükler
5. `~/.zeroclaw/workspace/` içinde varsayılan çalışma alanı yapısını oluşturur
6. Başlangıç `~/.zeroclaw/workspace/config.toml` yapılandırma dosyasını üretir

Önyüklemeden sonra, `zeroclaw` komutunu global olarak kullanmak için kabuğunuzu yeniden yükleyin veya `source ~/.cargo/env` çalıştırın.

### Seçenek 2: Manuel kurulum

<details>
<summary><strong>Manuel kurulum adımlarını görmek için tıklayın</strong></summary>

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

# 2. Sürüm olarak derle
cargo build --release --locked

# 3. İkiliyi yükle
cargo install --path . --locked

# 4. Çalışma alanını başlat
zeroclaw init

# 5. Kurulumu doğrula
zeroclaw --version
zeroclaw status
```

</details>

### Kurulumdan Sonra

Kurulumdan sonra (önyükleme veya manuel olarak), şunları görmelisiniz:

```
~/.zeroclaw/workspace/
├── config.toml          # Ana yapılandırma
├── .pairing             # Eşleştirme sırları (ilk başlangıçta oluşturulur)
├── logs/                # Arka plan programı/ajan logları
├── skills/              # Özel beceriler
└── memory/              # Konuşma bağlamı depolaması
```

**Sonraki adımlar:**

1. AI sağlayıcılarınızı `~/.zeroclaw/workspace/config.toml` içinde yapılandırın
2. Gelişmiş seçenekler için [yapılandırma referansına](docs/config-reference.md) bakın
3. Ajanı başlatın: `zeroclaw agent start`
4. Tercih ettiğiniz kanal üzerinden test edin ([kanallar referansına](docs/channels-reference.md) bakın)

## Yapılandırma

Sağlayıcıları, kanalları ve sistem davranışını yapılandırmak için `~/.zeroclaw/workspace/config.toml` dosyasını düzenleyin.

### Hızlı Yapılandırma Referansı

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

[runtime]
kind = "native"    # veya "docker" (Docker gerektirir)
```

**Tam referans belgeleri:**

- [Yapılandırma Referansı](docs/config-reference.md) — tüm ayarlar, doğrulamalar, varsayılanlar
- [Sağlayıcı Referansı](docs/providers-reference.md) — AI sağlayıcıya özgü yapılandırmalar
- [Kanallar Referansı](docs/channels-reference.md) — Telegram, Matrix, Slack, Discord ve daha fazlası
- [Operasyonlar](docs/operations-runbook.md) — üretim izleme, sırları döndürme, ölçeklendirme

### Mevcut Çalışma Zamanı Desteği

ZeroClaw iki kod yürütme arka ucu destekler:

- **`native`** (varsayılan) — doğrudan süreç yürütme, en hızlı yol, güvenilir ortamlar için ideal
- **`docker`** — tam konteyner yalıtımı. sertleştirilmiş güvenlik ilkeleri. Docker gerektirir

Katı kum alanı veya ağ yalıtımı gerekiyorsa `runtime.kind = "docker"` kullanın. Tam detaylar için [yapılandırma referansına](docs/config-reference.md#runtime) bakın.

## Komutlar

```bash
# Çalışma alanı yönetimi
zeroclaw init                # Yeni bir çalışma alanı başlatır
zeroclaw status              # Arka plan programı/ajan durumunu gösterir
zeroclaw config validate     # config.toml sözdizimini ve değerlerini doğrular

# Arka plan programı yönetimi
zeroclaw daemon start        # Arka plan programını arka planda başlatır
zeroclaw daemon stop         # Çalışan arka plan programını durdurur
zeroclaw daemon restart      # Arka plan programını yeniden başlatır (yapılandırmayı yeniden yükler)
zeroclaw daemon logs         # Arka plan programı loglarını gösterir

# Ajan yönetimi
zeroclaw agent start         # Ajanı başlatır (çalışan arka plan programı gerektirir)
zeroclaw agent stop          # Ajanı durdurur
zeroclaw agent restart       # Ajanı yeniden başlatır (yapılandırmayı yeniden yükler)

# Eşleştirme operasyonları
zeroclaw pairing init        # Yeni bir eşleştirme sırrı oluşturur
zeroclaw pairing rotate      # Mevcut eşleştirme sırrını döndürür

# Tünelleme (herkese açık kullanım için)
zeroclaw tunnel start        # Yerel arka plan programına bir tünel başlatır
zeroclaw tunnel stop         # Aktif tüneli durdurur

# Teşhis
zeroclaw doctor              # Sistem sağlık kontrollerini çalıştırır
zeroclaw version             # Sürüm ve derleme bilgilerini gösterir
```

Tam seçenekler ve örnekler için [Komutlar Referansına](docs/commands-reference.md) bakın.

## Mimari

```
┌─────────────────────────────────────────────────────────────────┐
│                        Kanallar (trait)                          │
│  Telegram │ Matrix │ Slack │ Discord │ Web │ CLI │ Özel         │
└─────────────────────────┬───────────────────────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────────────────┐
│                      Ajan Orkestratörü                           │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐          │
│  │   Mesaj      │  │   Bağlam     │  │   Araç       │          │
│  │   Yönlendirme│  │   Bellek     │  │   Yürütme    │          │
│  └──────────────┘  └──────────────┘  └──────────────┘          │
└─────────────────────────┬───────────────────────────────────────┘
                          │
          ┌───────────────┼───────────────┐
          ▼               ▼               ▼
┌──────────────┐  ┌──────────────┐  ┌──────────────┐
│  Sağlayıcılar│  │   Bellek     │  │   Araçlar    │
│   (trait)    │  │   (trait)    │  │   (trait)    │
├──────────────┤  ├──────────────┤  ├──────────────┤
│  Anthropic   │  │   Markdown   │  │  Filesystem  │
│   OpenAI     │  │    SQLite    │  │     Bash     │
│   Gemini     │  │     Yok      │  │   Web Fetch  │
│   Ollama     │  │    Özel      │  │    Özel      │
│   Özel       │  └──────────────┘  └──────────────┘
└──────────────┘
          │
          ▼
┌─────────────────────────────────────────────────────────────────┐
│                   Çalışma Zamanı (trait)                         │
│                  Native │ Docker                                 │
└─────────────────────────────────────────────────────────────────┘
```

**Temel ilkeler:**

- Her şey bir **trait'tir** — sağlayıcılar, kanallar, araçlar, bellek, tüneller
- Kanallar orkestratörü çağırır; orkestratör sağlayıcıları + araçları çağırır
- Bellek sistemi konuşma bağlamını yönetir (markdown, SQLite veya yok)
- Çalışma zamanı kod yürütmeyi soyutlar (yerel veya Docker)
- Satıcı kilitlenmesi yok — kod değişikliği olmadan Anthropic ↔ OpenAI ↔ Gemini ↔ Ollama değiştirin

Detaylı diyagramlar ve uygulama detayları için [mimari belgelerine](docs/architecture.svg) bakın.

## Örnekler

### Telegram Bot

```toml
[channels.telegram]
enabled = true
bot_token = "123456:ABC-DEF..."
allowed_users = [987654321]  # Telegram kullanıcı ID'niz
```

Arka plan programını + ajanı başlatın, ardından Telegram'da botunuza bir mesaj gönderin:

```
/start
Merhaba! Bir Python betiği yazmama yardımcı olabilir misin?
```

Bot, AI tarafından oluşturulan kodla yanıt verir, istenirse araçları yürütür ve konuşma bağlamını korur.

### Matrix (uçtan uca şifreleme)

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

Şifreli bir odaya `@zeroclaw:matrix.org` davet edin ve bot tam şifrelemeyle yanıt verecektir. Cihaz doğrulama kurulumu için [Matrix E2EE Kılavuzuna](docs/matrix-e2ee-guide.md) bakın.

### Çoklu-Sağlayıcı

```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"]  # Sağlayıcı hatasında geçiş
```

Anthropic başarısız olursa veya hız sınırına ulaşırsa, orkestratör otomatik olarak OpenAI'ya geçer.

### Özel Bellek

```toml
[memory]
kind = "sqlite"
path = "~/.zeroclaw/workspace/memory/conversations.db"
retention_days = 90  # 90 gün sonra otomatik temizleme
```

Veya insan tarafından okunabilir depolama için Markdown kullanın:

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

Tüm bellek seçenekleri için [Yapılandırma Referansına](docs/config-reference.md#memory) bakın.

## Sağlayıcı Desteği

| Sağlayıcı       | Durum      | API Anahtarı             | Örnek Modeller                                      |
| ----------------- | ----------- | ------------------- | ---------------------------------------------------- |
| **Anthropic**     | ✅ Kararlı   | `ANTHROPIC_API_KEY` | `claude-sonnet-4-20250514`, `claude-opus-4-20250514` |
| **OpenAI**        | ✅ Kararlı   | `OPENAI_API_KEY`    | `gpt-4o`, `gpt-4o-mini`, `o1`, `o1-mini`             |
| **Google Gemini** | ✅ Kararlı   | `GOOGLE_API_KEY`    | `gemini-2.0-flash-exp`, `gemini-exp-1206`            |
| **Ollama**        | ✅ Kararlı   | Yok (yerel)         | `llama3.3`, `qwen2.5`, `phi4`                        |
| **Cerebras**      | ✅ Kararlı   | `CEREBRAS_API_KEY`  | `llama-3.3-70b`                                      |
| **Groq**          | ✅ Kararlı   | `GROQ_API_KEY`      | `llama-3.3-70b-versatile`                            |
| **Mistral**       | 🚧 Planlanan | `MISTRAL_API_KEY`   | TBD                                                  |
| **Cohere**        | 🚧 Planlanan | `COHERE_API_KEY`    | TBD                                                  |

### Özel Uç Noktalar

ZeroClaw, OpenAI uyumlu uç noktaları destekler:

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

Örnek: herhangi bir LLM'ye OpenAI arayüzü üzerinden erişmek için [LiteLLM](https://github.com/BerriAI/litellm)'i proxy olarak kullanın.

Tam yapılandırma detayları için [Sağlayıcı Referansına](docs/providers-reference.md) bakın.

## Kanal Desteği

| Kanal        | Durum      | Kimlik Doğrulama         | Notlar                                                     |
| ------------ | ----------- | ------------------------ | --------------------------------------------------------- |
| **Telegram** | ✅ Kararlı   | Bot Token                | Dosyalar, resimler, satır içi düğmeler dahil tam destek |
| **Matrix**   | ✅ Kararlı   | Şifre veya Token    | Cihaz doğrulamalı E2EE desteği              |
| **Slack**    | 🚧 Planlanan | OAuth veya Bot Token       | Çalışma alanı erişimi gerektirir                                    |
| **Discord**  | 🚧 Planlanan | Bot Token                | Guild izinleri gerektirir                                |
| **WhatsApp** | 🚧 Planlanan | Twilio veya resmi API | İş hesabı gerektirir                                    |
| **CLI**      | ✅ Kararlı   | Yok                    | Doğrudan konuşma arayüzü                       |
| **Web**      | 🚧 Planlanan | API Anahtarı veya OAuth         | Tarayıcı tabanlı sohbet arayüzü                        |

Tam yapılandırma talimatları için [Kanallar Referansına](docs/channels-reference.md) bakın.

## Araç Desteği

ZeroClaw, kod yürütme, dosya sistemi erişimi ve web alımı için yerleşik araçlar sağlar:

| Araç                | Açıklama                 | Gerekli Çalışma Zamanı                |
| -------------------- | --------------------------- | ----------------------------- |
| **bash**             | Shell komutlarını yürüt | Yerel veya Docker              |
| **python**           | Python betiklerini yürüt  | Python 3.8+ (yerel) veya Docker |
| **javascript**       | Node.js kodunu yürüt     | Node.js 18+ (yerel) veya Docker |
| **filesystem_read**  | Dosyaları oku            | Yerel veya Docker              |
| **filesystem_write** | Dosyaları yaz          | Yerel veya Docker              |
| **web_fetch**        | Web içeriği al     | Yerel veya Docker              |

### Yürütme Güvenliği

- **Yerel Çalışma Zamanı** — arka plan programının kullanıcı süreci olarak çalışır, tam dosya sistemi erişimi
- **Docker Çalışma Zamanı** — tam konteyner yalıtımı, ayrı dosya sistemleri ve ağlar

`config.toml` içinde yürütme ilkesini yapılandırın:

```toml
[runtime]
kind = "docker"
allowed_tools = ["bash", "python", "filesystem_read"]  # Açık izin listesi
```

Tam güvenlik seçenekleri için [Yapılandırma Referansına](docs/config-reference.md#runtime) bakın.

## Dağıtım

### Yerel Dağıtım (Geliştirme)

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

### Sunucu Dağıtımı (Üretim)

Arka plan programını ve ajanı hizmet olarak yönetmek için systemd kullanın:

```bash
# İkiliyi yükle
cargo install --path . --locked

# Çalışma alanını yapılandır
zeroclaw init

# systemd hizmet dosyaları oluştur
sudo cp deployment/systemd/zeroclaw-daemon.service /etc/systemd/system/
sudo cp deployment/systemd/zeroclaw-agent.service /etc/systemd/system/

# Hizmetleri etkinleştir ve başlat
sudo systemctl enable zeroclaw-daemon zeroclaw-agent
sudo systemctl start zeroclaw-daemon zeroclaw-agent

# Durumu doğrula
sudo systemctl status zeroclaw-daemon
sudo systemctl status zeroclaw-agent
```

Tam üretim dağıtım talimatları için [Ağ Dağıtımı Kılavuzuna](docs/network-deployment.md) bakın.

### Docker

```bash
# İmajı oluştur
docker build -t zeroclaw:latest .

# Konteyneri çalıştır
docker run -d \
  --name zeroclaw \
  -v ~/.zeroclaw/workspace:/workspace \
  -e ANTHROPIC_API_KEY=sk-ant-... \
  zeroclaw:latest
```

Derleme detayları ve yapılandırma seçenekleri için [`Dockerfile`](Dockerfile)'a bakın.

### Uç Donanım

ZeroClaw, düşük güç tüketimli donanımda çalışmak üzere tasarlanmıştır:

- **Raspberry Pi Zero 2 W** — ~512 MB RAM, tek ARMv8 çekirdek, < $5 donanım maliyeti
- **Raspberry Pi 4/5** — 1 GB+ RAM, çok çekirdekli, eşzamanlı iş yükleri için ideal
- **Orange Pi Zero 2** — ~512 MB RAM, dört çekirdekli ARMv8, ultra düşük maliyet
- **x86 SBC'ler (Intel N100)** — 4-8 GB RAM, hızlı derlemeler, yerel Docker desteği

Cihaza özgü kurulum talimatları için [Donanım Kılavuzuna](docs/hardware/README.md) bakın.

## Tünelleme (Herkese Açık Kullanım)

Yerel ZeroClaw arka plan programınızı güvenli tüneller aracılığıyla herkese açık ağa çıkarın:

```bash
zeroclaw tunnel start --provider cloudflare
```

Desteklenen tünel sağlayıcıları:

- **Cloudflare Tunnel** — ücretsiz HTTPS, port açığa çıkarma yok, çoklu etki alanı desteği
- **Ngrok** — hızlı kurulum, özel etki alanları (ücretli plan)
- **Tailscale** — özel mesh ağı. herkese açık port yok

Tam yapılandırma seçenekleri için [Yapılandırma Referansına](docs/config-reference.md#tunnel) bakın.

## Güvenlik

ZeroClaw birden çok güvenlik katmanı uygular:

### Eşleştirme

Arka plan programı ilk başlangıçta `~/.zeroclaw/workspace/.pairing` içinde saklanan bir eşleştirme sırrı oluşturur. İstemciler (ajan, CLI) bağlanmak için bu sırrı sunmalıdır.

```bash
zeroclaw pairing rotate  # Yeni bir sır oluşturur ve eskisini geçersiz kılar
```

### Kum Alanı

- **Docker Çalışma Zamanı** — ayrı dosya sistemleri ve ağlarla tam konteyner yalıtımı
- **Yerel Çalışma Zamanı** — kullanıcı süreci olarak çalışır; varsayılan olarak çalışma alanıyla sınırlıdır

### İzin Listeleri

Kanallar kullanıcı ID'sine göre erişimi kısıtlayabilir:

```toml
[channels.telegram]
enabled = true
allowed_users = [123456789, 987654321]  # Açık izin listesi
```

### Şifreleme

- **Matrix E2EE** — cihaz doğrulamalı tam uçtan uca şifreleme
- **TLS Taşıma** — tüm API ve tünel trafiği HTTPS/TLS kullanır

Tam ilkeler ve uygulamalar için [Güvenlik Belgelerine](docs/security/README.md) bakın.

## Gözlemlenebilirlik

ZeroClaw varsayılan olarak `~/.zeroclaw/workspace/logs/` dizinine log yazar. Loglar bileşene göre saklanır:

```
~/.zeroclaw/workspace/logs/
├── daemon.log           # Arka plan programı logları (başlangıç, API istekleri, hatalar)
├── agent.log            # Ajan logları (mesaj yönlendirme, araç yürütme)
├── telegram.log         # Kanala özgü loglar (etkinse)
└── matrix.log           # Kanala özgü loglar (etkinse)
```

### Loglama Yapılandırması

```toml
[logging]
level = "info"                           # debug, info, warn, error
path = "~/.zeroclaw/workspace/logs/"
rotation = "daily"                       # günlük, saatlik, boyut
max_size_mb = 100                        # Boyut tabanlı döndürme için
retention_days = 30                      # N gün sonra otomatik temizleme
```

Tüm loglama seçenekleri için [Yapılandırma Referansına](docs/config-reference.md#logging) bakın.

### Metrikler (Planlanan)

Üretim izleme için Prometheus metrikleri desteği yakında geliyor. [#234](https://github.com/zeroclaw-labs/zeroclaw/issues/234) numaralı konuda takip ediliyor.

## Beceriler

ZeroClaw, sistem yeteneklerini genişleten yeniden kullanılabilir modüller olan özel becerileri destekler.

### Beceri Tanımı

Beceriler bu yapı ile `~/.zeroclaw/workspace/skills/<skill-name>/` içinde saklanır:

```
skills/
└── my-skill/
    ├── skill.toml       # Beceri metaverileri (ad, açıklama, bağımlılıklar)
    ├── prompt.md        # AI için sistem istemi
    └── tools/           # İsteğe bağlı özel araçlar
        └── my_tool.py
```

### Beceri Örneği

```toml
# skills/web-research/skill.toml
[skill]
name = "web-research"
description = "Web'de arama yapar ve sonuçları özetler"
version = "1.0.0"

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

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

Sen bir araştırma asistanısın. Bir şeyi araştırmam istendiğinde:

1. İçeriği almak için web_fetch kullan
2. Sonuçları okunması kolay bir biçimde özetle
3. Kaynakları URL'lerle göster
```

### Beceri Kullanımı

Beceriler ajan başlangıcında otomatik olarak yüklenir. Konuşmalarda ada göre başvurun:

```
Kullanıcı: En son AI haberlerini bulmak için web-research becerisini kullan
Bot: [web-research becerisini yükler, web_fetch'i yürütür, sonuçları özetler]
```

Tam beceri oluşturma talimatları için [Beceriler](#beceriler) bölümüne bakın.

## Open Skills

ZeroClaw, AI ajan yeteneklerini genişletmek için modüler ve sağlayıcıdan bağımsız bir sistem olan [Open Skills](https://github.com/openagents-com/open-skills)'i destekler.

### Open Skills'i Etkinleştir

```toml
[skills]
open_skills_enabled = true
# open_skills_dir = "/path/to/open-skills"  # isteğe bağlı
```

Ayrıca `ZEROCLAW_OPEN_SKILLS_ENABLED` ve `ZEROCLAW_OPEN_SKILLS_DIR` ile çalışma zamanında geçersiz kılabilirsiniz.

## Geliştirme

```bash
cargo build              # Geliştirme derlemesi
cargo build --release    # Sürüm derlemesi (codegen-units=1, Raspberry Pi dahil tüm cihazlarda çalışır)
cargo build --profile release-fast    # Daha hızlı derleme (codegen-units=8, 16 GB+ RAM gerektirir)
cargo test               # Tam test paketini çalıştır
cargo clippy --locked --all-targets -- -D clippy::correctness
cargo fmt                # Biçimlendir

# SQLite vs Markdown karşılaştırma kıyaslamasını çalıştır
cargo test --test memory_comparison -- --nocapture
```

### Ön push kancası

Bir git kancası her push'tan önce `cargo fmt --check`, `cargo clippy -- -D warnings` ve `cargo test` çalıştırır. Bir kez etkinleştirin:

```bash
git config core.hooksPath .githooks
```

### Derleme Sorun Giderme (Linux'ta OpenSSL hataları)

Bir `openssl-sys` derleme hatasıyla karşılaşırsanız, bağımlılıkları eşzamanlayın ve deponun lockfile'ı ile yeniden derleyin:

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

ZeroClaw, HTTP/TLS bağımlılıkları için `rustls` kullanacak şekilde yapılandırılmıştır; `--locked`, geçişli grafiği temiz ortamlarda deterministik tutar.

Geliştirme sırasında hızlı bir push'a ihtiyacınız olduğunda kancayı atlamak için:

```bash
git push --no-verify
```

## İşbirliği ve Belgeler

Görev tabanlı bir harita için belge merkeziyle başlayın:

- Belge Merkezi: [`docs/README.md`](docs/README.md)
- Birleşik Docs İçindekiler: [`docs/SUMMARY.md`](docs/SUMMARY.md)
- Komutlar Referansı: [`docs/commands-reference.md`](docs/commands-reference.md)
- Yapılandırma Referansı: [`docs/config-reference.md`](docs/config-reference.md)
- Sağlayıcı Referansı: [`docs/providers-reference.md`](docs/providers-reference.md)
- Kanallar Referansı: [`docs/channels-reference.md`](docs/channels-reference.md)
- Operasyonlar Runbook'u: [`docs/operations-runbook.md`](docs/operations-runbook.md)
- Sorun Giderme: [`docs/troubleshooting.md`](docs/troubleshooting.md)
- Docs Envanteri/Sınıflandırma: [`docs/docs-inventory.md`](docs/docs-inventory.md)
- PR/Issue Triaj Anlık Görüntüsü (18 Şub. 2026 itibariyle): [`docs/project-triage-snapshot-2026-02-18.md`](docs/project-triage-snapshot-2026-02-18.md)

Ana işbirliği referansları:

- Belge Merkezi: [docs/README.md](docs/README.md)
- Belge Şablonu: [docs/doc-template.md](docs/doc-template.md)
- Belge Değişikliği Kontrol Listesi: [docs/README.md#4-documentation-change-checklist](docs/README.md#4-documentation-change-checklist)
- Kanal Yapılandırma Referansı: [docs/channels-reference.md](docs/channels-reference.md)
- Matrix Şifreli Oda Operasyonları: [docs/matrix-e2ee-guide.md](docs/matrix-e2ee-guide.md)
- Katkı Kılavuzu: [CONTRIBUTING.md](CONTRIBUTING.md)
- PR İş Akışı İlkesi: [docs/pr-workflow.md](docs/pr-workflow.md)
- Gözden Geçiren Playbook'u (triaj + derinlemesine gözden geçirme): [docs/reviewer-playbook.md](docs/reviewer-playbook.md)
- Sahiplik ve CI Triaj Haritası: [docs/ci-map.md](docs/ci-map.md)
- Güvenlik Açıklama İlkesi: [SECURITY.md](SECURITY.md)

Dağıtım ve çalışma zamanı operasyonları için:

- Ağ Dağıtımı Kılavuzu: [docs/network-deployment.md](docs/network-deployment.md)
- Proxy Agent Playbook'u: [docs/proxy-agent-playbook.md](docs/proxy-agent-playbook.md)

## ZeroClaw'ı Destekleyin

ZeroClaw işinize yardımcı oluyorsa ve sürekli geliştirmeyi desteklemek istiyorsanız, buradan bağış yapabilirsiniz:

<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="Bana Bir Kahve Ismarla" /></a>

### 🙏 Özel Teşekkürler

Bu açık kaynak çalışmasını ilham veren ve besleyen topluluklara ve kurumlara içten teşekkürler:

- **Harvard Üniversitesi** — entelektüel merakı teşvik ettikleri ve mümkün olanın sınırlarını zorladıkları için.
- **MIT** — açık bilgiyi, açık kaynağı ve teknolojinin herkes için erişilebilir olması gerektiği inancını savundukları için.
- **Sundai Club** — topluluk, enerji ve önemli şeyler inşa etme konusundaki amansız irade için.
- **Dünya ve Ötesi** 🌍✨ — açık kaynağı iyi bir güç haline getiren her katılımcı, hayalper ve inşa edene. Bu senin için.

En iyi fikirler her yerden geldiği için açık kaynakta inşa ediyoruz. Bunu okuyorsan, bunun bir parçasısın. Hoş geldin. 🦀❤️

## ⚠️ Resmi Depo ve Taklit Uyarısı

**Bu tek resmi ZeroClaw deposudur:**

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

ZeroClaw olduğunu iddia eden veya ZeroClaw Labs ile bağlantıyı ima eden başka herhangi bir depo, organizasyon, etki alanı veya paket **yetkisizdir ve bu projeyle bağlantılı değildir**. Bilinen yetkisiz forklar [TRADEMARK.md](TRADEMARK.md)'da listelenecektir.

Taklit veya marka kötüye kullanımıyla karşılaşırsanız, lütfen [bir sorun açın](https://github.com/zeroclaw-labs/zeroclaw/issues).

---

## Lisans

ZeroClaw, maksimum açıklık ve katılımcı koruma için çift lisanslıdır:

| Lisans                      | Kullanım Durumları                                            |
| ---------------------------- | ------------------------------------------------------------ |
| [MIT](LICENSE-MIT)               | Açık kaynak, araştırma, akademik, kişisel kullanım          |
| [Apache 2.0](LICENSE-APACHE) | Patent koruması, kurumsal, ticari dağıtım |

Lisanslardan birini seçebilirsiniz. **Katılımcılar otomatik olarak her ikisi altında da hak verir** — tam katılımcı anlaşması için [CLA.md](CLA.md)'ye bakın.

### Marka

**ZeroClaw** adı ve logosu, ZeroClaw Labs'ın tescilli markalarıdır. Bu lisans, onay veya bağlantı ima etmek için kullanım izni vermez. İzin verilen ve yasaklanan kullanımlar için [TRADEMARK.md](TRADEMARK.md)'e bakın.

### Katılımcı Korumaları

- Katkılarınızın **telif hakkını sizde tutarsınız**
- **Patent hibesi** (Apache 2.0) sizi diğer katılımcıların patent iddialarından korur
- Katkılarınız commit geçmişinde ve [NOTICE](NOTICE)'da **kalıcı olarak atfedilir**
- Katkıda bulunarak marka hakları devredilmez

## Katkıda Bulunma

[CONTRIBUTING.md](CONTRIBUTING.md) ve [CLA.md](CLA.md)'ye bakın. Bir trait uygulayın, bir PR gönderin:

- CI iş akışı kılavuzu: [docs/ci-map.md](docs/ci-map.md)
- Yeni `Provider` → `src/providers/`
- Yeni `Channel` → `src/channels/`
- Yeni `Observer` → `src/observability/`
- Yeni `Tool` → `src/tools/`
- Yeni `Memory` → `src/memory/`
- Yeni `Tunnel` → `src/tunnel/`
- Yeni `Skill` → `~/.zeroclaw/workspace/skills/<n>/`

---

**ZeroClaw** — Sıfır yük. Sıfır ödün. Her yerde dağıtın. Her şeyi değiştirin. 🦀

## Yıldız Geçmişi

<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="Yıldız Geçmişi Grafiği" src="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&legend=top-left" />
    </picture>
  </a>
</p>
