🦀 ZeroClaw — Kişisel AI Asistanı

Sıfır ek yük. Sıfır uzlaşma. %100 Rust. %100 Agnostik.
⚡️ $10'lık donanımda <5MB RAM ile çalışır: OpenClaw'dan %99 daha az bellek ve Mac mini'den %98 daha ucuz!

Harvard, MIT ve Sundai.Club topluluklarının öğrencileri ve üyeleri tarafından geliştirilmiştir.

🌐 Diller: 🇺🇸 English · 🇨🇳 简体中文 · 🇯🇵 日本語 · 🇰🇷 한국어 · 🇻🇳 Tiếng Việt · 🇵🇭 Tagalog · 🇪🇸 Español · 🇧🇷 Português · 🇮🇹 Italiano · 🇩🇪 Deutsch · 🇫🇷 Français · 🇸🇦 العربية · 🇮🇳 हिन्दी · 🇷🇺 Русский · 🇧🇩 বাংলা · 🇮🇱 עברית · 🇵🇱 Polski · 🇨🇿 Čeština · 🇳🇱 Nederlands · 🇹🇷 Türkçe · 🇺🇦 Українська · 🇮🇩 Bahasa Indonesia · 🇹🇭 ไทย · 🇵🇰 اردو · 🇷🇴 Română · 🇸🇪 Svenska · 🇬🇷 Ελληνικά · 🇭🇺 Magyar · 🇫🇮 Suomi · 🇩🇰 Dansk · 🇳🇴 Norsk

ZeroClaw, kendi cihazlarınızda çalıştırdığınız kişisel bir AI asistanıdır. Zaten kullandığınız kanallarda size yanıt verir (WhatsApp, Telegram, Slack, Discord, Signal, iMessage, Matrix, IRC, Email, Bluesky, Nostr, Mattermost, Nextcloud Talk, DingTalk, Lark, QQ, Reddit, LinkedIn, Twitter, MQTT, WeChat Work ve daha fazlası). Gerçek zamanlı kontrol için bir web paneli bulunur ve donanım çevre birimlerine bağlanabilir (ESP32, STM32, Arduino, Raspberry Pi). Gateway sadece kontrol düzlemidir — ürün asistanın kendisidir.

Yerel, hızlı ve her zaman açık hissettiren kişisel, tek kullanıcılı bir asistan istiyorsanız, işte bu.

Web sitesi · Belgeler · Mimari · Başlarken · OpenClaw'dan Geçiş · Sorun Giderme · Discord

Önerilen kurulum: terminalinizde zeroclaw onboard komutunu çalıştırın. ZeroClaw Onboard, gateway, workspace, kanallar ve sağlayıcı kurulumunda sizi adım adım yönlendirir. Önerilen kurulum yoludur ve macOS, Linux ve Windows'ta (WSL2 ile) çalışır. Yeni kurulum mu? Buradan başlayın: Başlarken

• OpenAI Codex (ChatGPT aboneliği)
• Gemini (Google OAuth)
• Anthropic (API anahtarı veya yetkilendirme tokeni)

Model notu: birçok sağlayıcı/model desteklense de, en iyi deneyim için kullanabileceğiniz en güçlü son nesil modeli kullanın. Bkz. Onboarding.

Model yapılandırması + CLI: Sağlayıcı referansı Yetkilendirme profili rotasyonu (OAuth vs API anahtarları) + failover: Model failover

Çalışma zamanı: Kararlı Rust toolchain. Tek ikili dosya, çalışma zamanı bağımlılığı yok.

brew install zeroclaw

git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw
./install.sh

zeroclaw onboard kurulumdan sonra workspace ve sağlayıcınızı yapılandırmak için otomatik olarak çalışır.

Tam başlangıç kılavuzu (kimlik doğrulama, eşleştirme, kanallar): Başlarken

# Kurulum + onboarding
./install.sh --api-key "sk-..." --provider openrouter

# Gateway'i başlatın (webhook sunucusu + web paneli)
zeroclaw gateway                # varsayılan: 127.0.0.1:42617
zeroclaw gateway --port 0       # rastgele port (güvenlik güçlendirilmiş)

# Asistanla konuşun
zeroclaw agent -m "Hello, ZeroClaw!"

# Etkileşimli mod
zeroclaw agent

# Tam otonom çalışma zamanını başlatın (gateway + kanallar + cron + hands)
zeroclaw daemon

# Durumu kontrol edin
zeroclaw status

# Tanılama çalıştırın
zeroclaw doctor

Güncelleme mi yapıyorsunuz? Güncellemeden sonra zeroclaw doctor çalıştırın.

git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw

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

zeroclaw onboard

Geliştirici fallback (global kurulum yok): komutların başına cargo run --release -- ekleyin (örnek: cargo run --release -- status).

ZeroClaw, OpenClaw workspace'inizi, belleğinizi ve yapılandırmanızı içe aktarabilir:

# Nelerin taşınacağını önizleyin (güvenli, salt okunur)
zeroclaw migrate openclaw --dry-run

# Geçişi çalıştırın
zeroclaw migrate openclaw

Bu, bellek girişlerinizi, workspace dosyalarınızı ve yapılandırmanızı ~/.openclaw/ dizininden ~/.zeroclaw/ dizinine taşır. Yapılandırma otomatik olarak JSON'dan TOML'a dönüştürülür.

ZeroClaw gerçek mesajlaşma platformlarına bağlanır. Gelen DM'leri güvenilmeyen girdi olarak değerlendirin.

Tam güvenlik kılavuzu: SECURITY.md

Tüm kanallarda varsayılan davranış:

• DM eşleştirme (varsayılan): bilinmeyen gönderenler kısa bir eşleştirme kodu alır ve bot mesajlarını işlemez.
• Şununla onaylayın: zeroclaw pairing approve <channel> <code> (ardından gönderen yerel izin listesine eklenir).
• Genel gelen DM'ler, config.toml'da açık bir opt-in gerektirir.
• Riskli veya yanlış yapılandırılmış DM politikalarını tespit etmek için zeroclaw doctor çalıştırın.

Otonomi seviyeleri:

Sandboxing katmanları: workspace izolasyonu, yol geçişi engelleme, komut izin listeleri, yasaklı yollar (/etc, /root, ~/.ssh), hız sınırlama (maks eylem/saat, maliyet/gün sınırları).

Bu panoyu önemli bildirimler (breaking change'ler, güvenlik tavsiyeleri, bakım pencereleri ve sürüm engelleyicileri) için kullanın.

• Varsayılan olarak hafif çalışma zamanı — yaygın CLI ve durum iş akışları, release derlemelerinde birkaç megabaytlık bellek zarfında çalışır.
• Maliyet etkin dağıtım — $10'lık kartlar ve küçük bulut örnekleri için tasarlanmış, ağır çalışma zamanı bağımlılığı yok.
• Hızlı soğuk başlatmalar — tek ikili Rust çalışma zamanı, komut ve daemon başlatmayı neredeyse anlık tutar.
• Taşınabilir mimari — ARM, x86 ve RISC-V'de değiştirilebilir sağlayıcılar/kanallar/araçlarla tek ikili dosya.
• Yerel gateway — oturumlar, kanallar, araçlar, cron, SOP'lar ve olaylar için tek kontrol düzlemi.
• Çok kanallı gelen kutusu — WhatsApp, Telegram, Slack, Discord, Signal, iMessage, Matrix, IRC, Email, Bluesky, Nostr, Mattermost, Nextcloud Talk, DingTalk, Lark, QQ, Reddit, LinkedIn, Twitter, MQTT, WeChat Work, WebSocket ve daha fazlası.
• Çok ajanlı orkestrasyon (Hands) — zamanlanmış çalışan ve zamanla daha akıllı hale gelen otonom ajan kümeleri.
• Standart İşletim Prosedürleri (SOP'lar) — MQTT, webhook, cron ve çevre birimi tetikleyicileriyle olay odaklı iş akışı otomasyonu.
• Web paneli — gerçek zamanlı sohbet, bellek tarayıcısı, yapılandırma düzenleyicisi, cron yöneticisi ve araç denetçisi ile React 19 + Vite web arayüzü.
• Donanım çevre birimleri — Peripheral trait'i üzerinden ESP32, STM32 Nucleo, Arduino, Raspberry Pi GPIO.
• Birinci sınıf araçlar — shell, dosya G/Ç, tarayıcı, git, web fetch/search, MCP, Jira, Notion, Google Workspace ve 70+ daha fazlası.
• Yaşam döngüsü hook'ları — her aşamada LLM çağrılarını, araç yürütmelerini ve mesajları yakalayın ve değiştirin.
• Yetenek platformu — güvenlik denetimi ile yerleşik, topluluk ve workspace yetenekleri.
• Tünel desteği — uzaktan erişim için Cloudflare, Tailscale, ngrok, OpenVPN ve özel tüneller.

• Varsayılan olarak hafif: küçük Rust ikili dosyası, hızlı başlatma, düşük bellek ayak izi.
• Tasarımdan güvenli: eşleştirme, sıkı sandboxing, açık izin listeleri, workspace kapsamlandırma.
• Tamamen değiştirilebilir: temel sistemler trait'lerdir (sağlayıcılar, kanallar, araçlar, bellek, tüneller).
• Satıcı bağımlılığı yok: OpenAI uyumlu sağlayıcı desteği + takılabilir özel endpoint'ler.

Yerel makine hızlı benchmark'ı (macOS arm64, Şubat 2026) 0.8GHz edge donanımı için normalleştirilmiş.

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

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

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

• Gateway HTTP/WS/SSE kontrol düzlemi: oturumlar, varlık, yapılandırma, cron, webhook'lar, web paneli ve eşleştirme.
• CLI yüzeyi: gateway, agent, onboard, doctor, status, service, migrate, auth, cron, channel, skills.
• Araç dispatch'i, prompt oluşturma, mesaj sınıflandırma ve bellek yükleme ile ajan orkestrasyon döngüsü.
• Güvenlik politikası uygulama, otonomi seviyeleri ve onay kapılamayla oturum modeli.
• 20+ LLM backend'inde failover, yeniden deneme ve model yönlendirme ile dayanıklı sağlayıcı wrapper'ı.

Kanallar: WhatsApp (yerel), Telegram, Slack, Discord, Signal, iMessage, Matrix, IRC, Email, Bluesky, DingTalk, Lark, Mattermost, Nextcloud Talk, Nostr, QQ, Reddit, LinkedIn, Twitter, MQTT, WeChat Work, WATI, Mochat, Linq, Notion, WebSocket, ClawdTalk.

Feature-gated: Matrix (channel-matrix), Lark (channel-lark), Nostr (channel-nostr).

Gateway'den doğrudan sunulan React 19 + Vite 6 + Tailwind CSS 4 web paneli:

• Dashboard — sistem genel görünümü, sağlık durumu, çalışma süresi, maliyet takibi
• Ajan Sohbeti — ajanla etkileşimli sohbet
• Bellek — bellek girişlerini gözatma ve yönetme
• Yapılandırma — yapılandırmayı görüntüleme ve düzenleme
• Cron — zamanlanmış görevleri yönetme
• Araçlar — kullanılabilir araçları gözatma
• Günlükler — ajan etkinlik günlüklerini görüntüleme
• Maliyet — token kullanımı ve maliyet takibi
• Doctor — sistem sağlık tanılaması
• Entegrasyonlar — entegrasyon durumu ve kurulumu
• Eşleştirme — cihaz eşleştirme yönetimi

• Çekirdek: shell, dosya okuma/yazma/düzenleme, git işlemleri, glob arama, içerik arama
• Web: tarayıcı kontrolü, web fetch, web arama, ekran görüntüsü, görüntü bilgisi, PDF okuma
• Entegrasyonlar: Jira, Notion, Google Workspace, Microsoft 365, LinkedIn, Composio, Pushover
• MCP: Model Context Protocol araç wrapper'ı + ertelenmiş araç setleri
• Zamanlama: cron add/remove/update/run, zamanlama aracı
• Bellek: recall, store, forget, knowledge, project intel
• Gelişmiş: delegate (ajan-ajana), swarm, model switch/routing, security ops, cloud ops
• Donanım: board info, memory map, memory read (feature-gated)

• Otonomi seviyeleri: ReadOnly, Supervised (varsayılan), Full.
• Sandboxing: workspace izolasyonu, yol geçişi engelleme, komut izin listeleri, yasaklı yollar, Landlock (Linux), Bubblewrap.
• Hız sınırlama: saat başı maks eylem, gün başı maks maliyet (yapılandırılabilir).
• Onay kapılama: orta/yüksek riskli işlemler için etkileşimli onay.
• E-stop: acil durum kapatma yeteneği.
• 129+ güvenlik testi otomatik CI'da.

• Web paneli doğrudan Gateway'den sunulur.
• Tünel desteği: Cloudflare, Tailscale, ngrok, OpenVPN, özel komut.
• Konteynerleştirilmiş yürütme için Docker çalışma zamanı adaptörü.
• CI/CD: beta (push'ta otomatik) → stable (manuel dispatch) → Docker, crates.io, Scoop, AUR, Homebrew, tweet.
• Linux (x86_64, aarch64, armv7), macOS (x86_64, aarch64), Windows (x86_64) için önceden derlenmiş ikili dosyalar.

Minimal ~/.zeroclaw/config.toml:

default_provider = "anthropic"
api_key = "sk-ant-..."

Tam yapılandırma referansı: docs/reference/api/config-reference.md.

Telegram:

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

Discord:

[channels.discord]
token = "your-bot-token"

Slack:

[channels.slack]
bot_token = "xoxb-..."
app_token = "xapp-..."

WhatsApp:

[channels.whatsapp]
enabled = true

Matrix:

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

Signal:

[channels.signal]
phone_number = "+1234567890"

[tunnel]
kind = "cloudflare"  # veya "tailscale", "ngrok", "openvpn", "custom", "none"

Ayrıntılar: Kanal referansı · Yapılandırma referansı

• native (varsayılan) — doğrudan süreç yürütme, en hızlı yol, güvenilir ortamlar için ideal.
• docker — tam konteyner izolasyonu, zorunlu güvenlik politikaları, Docker gerektirir.

Sıkı sandboxing veya ağ izolasyonu için runtime.kind = "docker" ayarlayın.

ZeroClaw, yerel abonelik yetkilendirme profillerini destekler (çoklu hesap, durağan halde şifreli).

• Depolama dosyası: ~/.zeroclaw/auth-profiles.json
• Şifreleme anahtarı: ~/.zeroclaw/.secret_key
• Profil ID formatı: <provider>:<profile_name> (örnek: openai-codex:work)

# OpenAI Codex OAuth (ChatGPT aboneliği)
zeroclaw auth login --provider openai-codex --device-code

# Gemini OAuth
zeroclaw auth login --provider gemini --profile default

# Anthropic setup-token
zeroclaw auth paste-token --provider anthropic --profile default --auth-kind authorization

# Kontrol / yenileme / profil değiştirme
zeroclaw auth status
zeroclaw auth refresh --provider openai-codex --profile default
zeroclaw auth use --provider openai-codex --profile work

# Ajanı abonelik auth ile çalıştırma
zeroclaw agent --provider openai-codex -m "hello"
zeroclaw agent --provider anthropic -m "hello"

Workspace kök dizini: ~/.zeroclaw/workspace/ (config ile yapılandırılabilir).

Enjekte edilen prompt dosyaları:

• IDENTITY.md — ajan kişiliği ve rolü
• USER.md — kullanıcı bağlamı ve tercihleri
• MEMORY.md — uzun vadeli gerçekler ve dersler
• AGENTS.md — oturum kuralları ve başlatma kuralları
• SOUL.md — temel kimlik ve çalışma prensipleri

Yetenekler: ~/.zeroclaw/workspace/skills/<skill>/SKILL.md veya SKILL.toml.

# Yüklü yetenekleri listele
zeroclaw skills list

# Git'ten yükle
zeroclaw skills install https://github.com/user/my-skill.git

# Yüklemeden önce güvenlik denetimi
zeroclaw skills audit https://github.com/user/my-skill.git

# Bir yeteneği kaldır
zeroclaw skills remove my-skill

# Workspace yönetimi
zeroclaw onboard              # Rehberli kurulum sihirbazı
zeroclaw status               # Daemon/ajan durumunu göster
zeroclaw doctor               # Sistem tanılaması çalıştır

# Gateway + daemon
zeroclaw gateway              # Gateway sunucusunu başlat (127.0.0.1:42617)
zeroclaw daemon               # Tam otonom çalışma zamanını başlat

# Ajan
zeroclaw agent                # Etkileşimli sohbet modu
zeroclaw agent -m "message"   # Tek mesaj modu

# Hizmet yönetimi
zeroclaw service install      # OS hizmeti olarak yükle (launchd/systemd)
zeroclaw service start|stop|restart|status

# Kanallar
zeroclaw channel list         # Yapılandırılmış kanalları listele
zeroclaw channel doctor       # Kanal sağlığını kontrol et
zeroclaw channel bind-telegram 123456789

# Cron + zamanlama
zeroclaw cron list            # Zamanlanmış görevleri listele
zeroclaw cron add "*/5 * * * *" --prompt "Check system health"
zeroclaw cron remove <id>

# Bellek
zeroclaw memory list          # Bellek girişlerini listele
zeroclaw memory get <key>     # Bir bellek al
zeroclaw memory stats         # Bellek istatistikleri

# Yetkilendirme profilleri
zeroclaw auth login --provider <name>
zeroclaw auth status
zeroclaw auth use --provider <name> --profile <profile>

# Donanım çevre birimleri
zeroclaw hardware discover    # Bağlı cihazları tara
zeroclaw peripheral list      # Bağlı çevre birimlerini listele
zeroclaw peripheral flash     # Cihaza firmware yükle

# Geçiş
zeroclaw migrate openclaw --dry-run
zeroclaw migrate openclaw

# Kabuk tamamlama
source <(zeroclaw completions bash)
zeroclaw completions zsh > ~/.zfunc/_zeroclaw

Tam komut referansı: docs/reference/cli/commands-reference.md

curl -LsSf https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/install.sh | bash

./install.sh --prefer-prebuilt

./install.sh --prebuilt-only

Sürüm varlıkları şunlar için yayınlanır:

• Linux: x86_64, aarch64, armv7
• macOS: x86_64, aarch64
• Windows: x86_64

En son varlıkları şuradan indirin: https://github.com/zeroclaw-labs/zeroclaw/releases/latest

Onboarding akışını geçtikten sonra daha derin referans istediğinizde bunları kullanın.

• Navigasyon ve "ne nerede" için belge dizini ile başlayın.
• Tam sistem modeli için mimari genel bakış okuyun.
• Her anahtar ve örneğe ihtiyacınız olduğunda yapılandırma referansı kullanın.
• İşletim el kitabı ile Gateway'i kitabına göre çalıştırın.
• Rehberli kurulum için ZeroClaw Onboard takip edin.
• Yaygın hataları sorun giderme kılavuzu ile ayıklayın.
• Herhangi bir şeyi açığa çıkarmadan önce güvenlik rehberliği gözden geçirin.

• Belge merkezi: docs/README.md
• Birleşik içindekiler: docs/SUMMARY.md
• Komut referansı: docs/reference/cli/commands-reference.md
• Yapılandırma referansı: docs/reference/api/config-reference.md
• Sağlayıcı referansı: docs/reference/api/providers-reference.md
• Kanal referansı: docs/reference/api/channels-reference.md
• İşletim el kitabı: docs/ops/operations-runbook.md
• Sorun giderme: docs/ops/troubleshooting.md

• Katkıda bulunma rehberi: CONTRIBUTING.md
• PR iş akışı politikası: docs/contributing/pr-workflow.md
• CI iş akışı rehberi: docs/contributing/ci-map.md
• İncelemeci el kitabı: docs/contributing/reviewer-playbook.md
• Güvenlik açıklama politikası: SECURITY.md
• Belge şablonu: docs/contributing/doc-template.md

• Ağ dağıtım rehberi: docs/ops/network-deployment.md
• Proxy ajan el kitabı: docs/ops/proxy-agent-playbook.md
• Donanım rehberleri: docs/hardware/README.md

ZeroClaw, smooth crab 🦀 için inşa edildi — hızlı ve verimli bir AI asistanı. Argenis De La Rosa ve topluluk tarafından geliştirildi.

• zeroclawlabs.ai
• @zeroclawlabs

ZeroClaw işinize yarıyorsa ve süregelen geliştirmeyi desteklemek istiyorsanız, buradan bağış yapabilirsiniz:

Bu açık kaynak çalışmaya ilham veren ve yakıt sağlayan topluluklara ve kurumlara içten bir teşekkür:

• Harvard University — entelektüel merakı beslemek ve mümkün olanın sınırlarını zorlamak için.
• MIT — açık bilgiyi, açık kaynağı ve teknolojinin herkes için erişilebilir olması gerektiği inancını savunmak için.
• Sundai Club — topluluk, enerji ve önemli şeyler inşa etmeye yönelik amansız istek için.
• Dünya ve Ötesi 🌍✨ — açık kaynağı iyilik için bir güç yapan her katkıda bulunan, hayalci ve inşaatçıya. Bu sizin için.

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

ZeroClaw'da yeni misiniz? good first issue etiketli issue'ları arayın — nasıl başlayacağınızı öğrenmek için Katkıda Bulunma Rehberimize bakın. AI/vibe-coded PR'lar hoş geldiniz! 🤖

CONTRIBUTING.md ve CLA.md'ye bakın. Bir trait uygulayın, PR gönderin:

• CI iş akışı rehberi: docs/contributing/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 Peripheral → src/peripherals/
• Yeni Skill → ~/.zeroclaw/workspace/skills/<name>/

Bu, tek resmi ZeroClaw deposudur:

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

"ZeroClaw" olduğunu iddia eden veya ZeroClaw Labs ile bağlantı ima eden başka herhangi bir depo, organizasyon, alan adı veya paket yetkisiz olup bu projeyle bağlantılı değildir. Bilinen yetkisiz fork'lar TRADEMARK.md'de listelenecektir.

Kimlik taklidi veya ticari marka kötüye kullanımıyla karşılaşırsanız, lütfen bir issue açın.

ZeroClaw, maksimum açıklık ve katkıda bulunan koruması için çift lisanslıdır:

Her iki lisanstan birini seçebilirsiniz. Katkıda bulunanlar her ikisi altında otomatik olarak hak verir — tam katkıda bulunan sözleşmesi için CLA.md'ye bakın.

ZeroClaw adı ve logosu, ZeroClaw Labs'ın ticari markalarıdır. Bu lisans, onay veya bağlantı ima etmek için bunları kullanma izni vermez. İzin verilen ve yasaklanan kullanımlar için TRADEMARK.md'ye bakın.

• Katkılarınızın telif hakkını elinizde tutarsınız
• Patent hakkı (Apache 2.0) sizi diğer katkıda bulunanların patent taleplerinden korur
• Katkılarınız commit geçmişinde ve NOTICE'da kalıcı olarak atfedilir
• Katkıda bulunarak hiçbir ticari marka hakkı devredilmez

ZeroClaw — Sıfır ek yük. Sıfır uzlaşma. Her yere dağıtın. Her şeyi değiştirin. 🦀

Bu liste GitHub katkıda bulunanlar grafiğinden oluşturulur ve otomatik olarak güncellenir.