🦀 ZeroClaw — Asisten AI Pribadi

Nol overhead. Nol kompromi. 100% Rust. 100% Agnostik.
⚡️ Berjalan di perangkat keras $10 dengan RAM <5MB: Itu 99% lebih hemat memori dari OpenClaw dan 98% lebih murah dari Mac mini!

Dibangun oleh mahasiswa dan anggota komunitas Harvard, MIT, dan Sundai.Club.

🌐 Bahasa: 🇺🇸 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 adalah asisten AI pribadi yang Anda jalankan di perangkat sendiri. Ia menjawab Anda melalui saluran yang sudah Anda gunakan (WhatsApp, Telegram, Slack, Discord, Signal, iMessage, Matrix, IRC, Email, Bluesky, Nostr, Mattermost, Nextcloud Talk, DingTalk, Lark, QQ, Reddit, LinkedIn, Twitter, MQTT, WeChat Work, dan lainnya). Ia memiliki dasbor web untuk kontrol real-time dan dapat terhubung ke periferal perangkat keras (ESP32, STM32, Arduino, Raspberry Pi). Gateway hanyalah bidang kendali — produknya adalah asisten.

Jika Anda menginginkan asisten pribadi, pengguna tunggal, yang terasa lokal, cepat, dan selalu aktif, inilah solusinya.

Situs Web · Dokumentasi · Arsitektur · Memulai · Migrasi dari OpenClaw · Pemecahan Masalah · Discord

Pengaturan yang disarankan: jalankan zeroclaw onboard di terminal Anda. ZeroClaw Onboard memandu Anda langkah demi langkah dalam menyiapkan gateway, workspace, saluran, dan provider. Ini adalah jalur pengaturan yang disarankan dan berfungsi di macOS, Linux, dan Windows (melalui WSL2). Instalasi baru? Mulai di sini: Memulai

• OpenAI Codex (langganan ChatGPT)
• Gemini (Google OAuth)
• Anthropic (kunci API atau token autentikasi)

Catatan model: meskipun banyak provider/model didukung, untuk pengalaman terbaik gunakan model generasi terbaru terkuat yang tersedia untuk Anda. Lihat Onboarding.

Konfigurasi model + CLI: Referensi Provider Rotasi profil autentikasi (OAuth vs kunci API) + failover: Failover Model

Runtime: Rust stable toolchain. Biner tunggal, tanpa dependensi runtime.

brew install zeroclaw

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

zeroclaw onboard berjalan otomatis setelah instalasi untuk mengonfigurasi workspace dan provider Anda.

Panduan lengkap pemula (autentikasi, pairing, saluran): Memulai

# Instal + onboard
./install.sh --api-key "sk-..." --provider openrouter

# Mulai gateway (server webhook + dasbor web)
zeroclaw gateway                # default: 127.0.0.1:42617
zeroclaw gateway --port 0       # port acak (keamanan ditingkatkan)

# Bicara ke asisten
zeroclaw agent -m "Hello, ZeroClaw!"

# Mode interaktif
zeroclaw agent

# Mulai runtime otonom penuh (gateway + saluran + cron + hands)
zeroclaw daemon

# Periksa status
zeroclaw status

# Jalankan diagnostik
zeroclaw doctor

Memperbarui? Jalankan zeroclaw doctor setelah pembaruan.

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

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

zeroclaw onboard

Alternatif dev (tanpa instalasi global): awali perintah dengan cargo run --release -- (contoh: cargo run --release -- status).

ZeroClaw dapat mengimpor workspace, memori, dan konfigurasi OpenClaw Anda:

# Pratinjau apa yang akan dimigrasikan (aman, hanya-baca)
zeroclaw migrate openclaw --dry-run

# Jalankan migrasi
zeroclaw migrate openclaw

Ini memigrasikan entri memori, file workspace, dan konfigurasi Anda dari ~/.openclaw/ ke ~/.zeroclaw/. Konfigurasi dikonversi dari JSON ke TOML secara otomatis.

ZeroClaw terhubung ke permukaan pesan nyata. Perlakukan DM masuk sebagai input tidak tepercaya.

Panduan keamanan lengkap: SECURITY.md

Perilaku default di semua saluran:

• Pairing DM (default): pengirim yang tidak dikenal menerima kode pairing singkat dan bot tidak memproses pesan mereka.
• Setujui dengan: zeroclaw pairing approve <channel> <code> (kemudian pengirim ditambahkan ke daftar izin lokal).
• DM masuk publik memerlukan opt-in eksplisit di config.toml.
• Jalankan zeroclaw doctor untuk menemukan kebijakan DM yang berisiko atau salah konfigurasi.

Level otonomi:

Lapisan sandboxing: isolasi workspace, pemblokiran traversal jalur, daftar izin perintah, jalur terlarang (/etc, /root, ~/.ssh), pembatasan laju (maksimum tindakan/jam, batas biaya/hari).

Gunakan papan ini untuk pemberitahuan penting (perubahan yang merusak, saran keamanan, jendela pemeliharaan, dan pemblokir rilis).

• Runtime Ringan secara Default — alur kerja CLI dan status umum berjalan dalam amplop memori beberapa megabyte pada build rilis.
• Deployment Hemat Biaya — dirancang untuk board $10 dan instans cloud kecil, tanpa dependensi runtime berat.
• Cold Start Cepat — runtime Rust biner tunggal menjaga startup perintah dan daemon hampir instan.
• Arsitektur Portabel — satu biner di ARM, x86, dan RISC-V dengan provider/saluran/alat yang dapat ditukar.
• Gateway Lokal-Pertama — bidang kendali tunggal untuk sesi, saluran, alat, cron, SOP, dan peristiwa.
• Inbox multi-saluran — WhatsApp, Telegram, Slack, Discord, Signal, iMessage, Matrix, IRC, Email, Bluesky, Nostr, Mattermost, Nextcloud Talk, DingTalk, Lark, QQ, Reddit, LinkedIn, Twitter, MQTT, WeChat Work, WebSocket, dan lainnya.
• Orkestrasi multi-agen (Hands) — swarm agen otonom yang berjalan sesuai jadwal dan semakin pintar seiring waktu.
• Standard Operating Procedures (SOP) — otomasi alur kerja berbasis peristiwa dengan MQTT, webhook, cron, dan pemicu periferal.
• Dasbor Web — UI web React 19 + Vite dengan obrolan real-time, browser memori, editor konfigurasi, manajer cron, dan inspektor alat.
• Periferal perangkat keras — ESP32, STM32 Nucleo, Arduino, Raspberry Pi GPIO melalui trait Peripheral.
• Alat kelas satu — shell, file I/O, browser, git, web fetch/search, MCP, Jira, Notion, Google Workspace, dan 70+ lainnya.
• Hook siklus hidup — intersep dan modifikasi panggilan LLM, eksekusi alat, dan pesan di setiap tahap.
• Platform skill — skill bawaan, komunitas, dan workspace dengan audit keamanan.
• Dukungan tunnel — Cloudflare, Tailscale, ngrok, OpenVPN, dan tunnel kustom untuk akses jarak jauh.

• Ringan secara default: biner Rust kecil, startup cepat, jejak memori rendah.
• Aman secara desain: pairing, sandboxing ketat, daftar izin eksplisit, pelingkupan workspace.
• Sepenuhnya dapat ditukar: sistem inti adalah trait (provider, saluran, alat, memori, tunnel).
• Tanpa lock-in: dukungan provider kompatibel OpenAI + endpoint kustom pluggable.

Benchmark cepat mesin lokal (macOS arm64, Feb 2026) dinormalisasi untuk perangkat keras edge 0.8GHz.

Catatan: Hasil ZeroClaw diukur pada build rilis menggunakan /usr/bin/time -l. OpenClaw memerlukan runtime Node.js (biasanya ~390MB overhead memori tambahan), sedangkan NanoBot memerlukan runtime Python. PicoClaw dan ZeroClaw adalah biner statis. Angka RAM di atas adalah memori runtime; kebutuhan kompilasi saat build lebih tinggi.

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

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

• Bidang kendali HTTP/WS/SSE Gateway dengan sesi, presence, konfigurasi, cron, webhook, dasbor web, dan pairing.
• Permukaan CLI: gateway, agent, onboard, doctor, status, service, migrate, auth, cron, channel, skills.
• Loop orkestrasi agen dengan dispatch alat, konstruksi prompt, klasifikasi pesan, dan pemuatan memori.
• Model sesi dengan penegakan kebijakan keamanan, level otonomi, dan gating persetujuan.
• Wrapper provider resilient dengan failover, retry, dan routing model di 20+ backend LLM.

Saluran: WhatsApp (native), 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).

Dasbor web React 19 + Vite 6 + Tailwind CSS 4 yang disajikan langsung dari Gateway:

• Dashboard — ikhtisar sistem, status kesehatan, uptime, pelacakan biaya
• Agent Chat — obrolan interaktif dengan agen
• Memory — jelajahi dan kelola entri memori
• Config — lihat dan edit konfigurasi
• Cron — kelola tugas terjadwal
• Tools — jelajahi alat yang tersedia
• Logs — lihat log aktivitas agen
• Cost — penggunaan token dan pelacakan biaya
• Doctor — diagnostik kesehatan sistem
• Integrations — status integrasi dan pengaturan
• Pairing — manajemen pairing perangkat

• Inti: shell, file read/write/edit, operasi git, glob search, content search
• Web: browser control, web fetch, web search, screenshot, image info, PDF read
• Integrasi: Jira, Notion, Google Workspace, Microsoft 365, LinkedIn, Composio, Pushover
• MCP: Model Context Protocol tool wrapper + deferred tool sets
• Penjadwalan: cron add/remove/update/run, schedule tool
• Memori: recall, store, forget, knowledge, project intel
• Lanjutan: delegate (agen-ke-agen), swarm, model switch/routing, security ops, cloud ops
• Perangkat keras: board info, memory map, memory read (feature-gated)

• Level otonomi: ReadOnly, Supervised (default), Full.
• Sandboxing: isolasi workspace, pemblokiran traversal jalur, daftar izin perintah, jalur terlarang, Landlock (Linux), Bubblewrap.
• Pembatasan laju: maksimum tindakan per jam, maksimum biaya per hari (dapat dikonfigurasi).
• Gating persetujuan: persetujuan interaktif untuk operasi risiko menengah/tinggi.
• E-stop: kemampuan shutdown darurat.
• 129+ tes keamanan dalam CI otomatis.

• Dasbor web disajikan langsung dari Gateway.
• Dukungan tunnel: Cloudflare, Tailscale, ngrok, OpenVPN, perintah kustom.
• Adapter runtime Docker untuk eksekusi terkontainerisasi.
• CI/CD: beta (otomatis saat push) → stable (dispatch manual) → Docker, crates.io, Scoop, AUR, Homebrew, tweet.
• Biner pre-built untuk Linux (x86_64, aarch64, armv7), macOS (x86_64, aarch64), Windows (x86_64).

Minimal ~/.zeroclaw/config.toml:

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

Referensi konfigurasi lengkap: 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"  # atau "tailscale", "ngrok", "openvpn", "custom", "none"

Detail: Referensi Saluran · Referensi Konfigurasi

• native (default) — eksekusi proses langsung, jalur tercepat, ideal untuk lingkungan tepercaya.
• docker — isolasi kontainer penuh, kebijakan keamanan ditegakkan, memerlukan Docker.

Atur runtime.kind = "docker" untuk sandboxing ketat atau isolasi jaringan.

ZeroClaw mendukung profil autentikasi native berlangganan (multi-akun, terenkripsi saat istirahat).

• File penyimpanan: ~/.zeroclaw/auth-profiles.json
• Kunci enkripsi: ~/.zeroclaw/.secret_key
• Format id profil: <provider>:<profile_name> (contoh: openai-codex:work)

# OpenAI Codex OAuth (langganan ChatGPT)
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

# Periksa / refresh / ganti profil
zeroclaw auth status
zeroclaw auth refresh --provider openai-codex --profile default
zeroclaw auth use --provider openai-codex --profile work

# Jalankan agen dengan auth berlangganan
zeroclaw agent --provider openai-codex -m "hello"
zeroclaw agent --provider anthropic -m "hello"

Root workspace: ~/.zeroclaw/workspace/ (dapat dikonfigurasi melalui config).

File prompt yang diinjeksi:

• IDENTITY.md — kepribadian dan peran agen
• USER.md — konteks dan preferensi pengguna
• MEMORY.md — fakta dan pelajaran jangka panjang
• AGENTS.md — konvensi sesi dan aturan inisialisasi
• SOUL.md — identitas inti dan prinsip operasi

Skill: ~/.zeroclaw/workspace/skills/<skill>/SKILL.md atau SKILL.toml.

# Daftar skill yang terinstal
zeroclaw skills list

# Instal dari git
zeroclaw skills install https://github.com/user/my-skill.git

# Audit keamanan sebelum instalasi
zeroclaw skills audit https://github.com/user/my-skill.git

# Hapus skill
zeroclaw skills remove my-skill

# Manajemen workspace
zeroclaw onboard              # Wizard pengaturan terpandu
zeroclaw status               # Tampilkan status daemon/agen
zeroclaw doctor               # Jalankan diagnostik sistem

# Gateway + daemon
zeroclaw gateway              # Mulai server gateway (127.0.0.1:42617)
zeroclaw daemon               # Mulai runtime otonom penuh

# Agen
zeroclaw agent                # Mode obrolan interaktif
zeroclaw agent -m "message"   # Mode pesan tunggal

# Manajemen layanan
zeroclaw service install      # Instal sebagai layanan OS (launchd/systemd)
zeroclaw service start|stop|restart|status

# Saluran
zeroclaw channel list         # Daftar saluran yang dikonfigurasi
zeroclaw channel doctor       # Periksa kesehatan saluran
zeroclaw channel bind-telegram 123456789

# Cron + penjadwalan
zeroclaw cron list            # Daftar tugas terjadwal
zeroclaw cron add "*/5 * * * *" --prompt "Check system health"
zeroclaw cron remove <id>

# Memori
zeroclaw memory list          # Daftar entri memori
zeroclaw memory get <key>     # Ambil memori
zeroclaw memory stats         # Statistik memori

# Profil autentikasi
zeroclaw auth login --provider <name>
zeroclaw auth status
zeroclaw auth use --provider <name> --profile <profile>

# Periferal perangkat keras
zeroclaw hardware discover    # Pindai perangkat yang terhubung
zeroclaw peripheral list      # Daftar periferal yang terhubung
zeroclaw peripheral flash     # Flash firmware ke perangkat

# Migrasi
zeroclaw migrate openclaw --dry-run
zeroclaw migrate openclaw

# Pelengkapan shell
source <(zeroclaw completions bash)
zeroclaw completions zsh > ~/.zfunc/_zeroclaw

Referensi perintah lengkap: 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

Aset rilis dipublikasikan untuk:

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

Unduh aset terbaru dari: https://github.com/zeroclaw-labs/zeroclaw/releases/latest

Gunakan ini ketika Anda sudah melewati alur onboarding dan menginginkan referensi yang lebih mendalam.

• Mulai dengan indeks dokumentasi untuk navigasi dan "apa di mana."
• Baca ikhtisar arsitektur untuk model sistem lengkap.
• Gunakan referensi konfigurasi ketika Anda memerlukan setiap kunci dan contoh.
• Jalankan Gateway sesuai buku dengan runbook operasional.
• Ikuti ZeroClaw Onboard untuk pengaturan terpandu.
• Debug kegagalan umum dengan panduan pemecahan masalah.
• Tinjau panduan keamanan sebelum mengekspos apa pun.

• Hub dokumentasi: docs/README.md
• TOC dokumentasi terpadu: docs/SUMMARY.md
• Referensi perintah: docs/reference/cli/commands-reference.md
• Referensi konfigurasi: docs/reference/api/config-reference.md
• Referensi provider: docs/reference/api/providers-reference.md
• Referensi saluran: docs/reference/api/channels-reference.md
• Runbook operasional: docs/ops/operations-runbook.md
• Pemecahan masalah: docs/ops/troubleshooting.md

• Panduan kontribusi: CONTRIBUTING.md
• Kebijakan alur kerja PR: docs/contributing/pr-workflow.md
• Panduan alur kerja CI: docs/contributing/ci-map.md
• Playbook reviewer: docs/contributing/reviewer-playbook.md
• Kebijakan pengungkapan keamanan: SECURITY.md
• Template dokumentasi: docs/contributing/doc-template.md

• Panduan deployment jaringan: docs/ops/network-deployment.md
• Playbook proxy agent: docs/ops/proxy-agent-playbook.md
• Panduan perangkat keras: docs/hardware/README.md

ZeroClaw dibangun untuk smooth crab 🦀, asisten AI yang cepat dan efisien. Dibangun oleh Argenis De La Rosa dan komunitas.

• zeroclawlabs.ai
• @zeroclawlabs

Jika ZeroClaw membantu pekerjaan Anda dan Anda ingin mendukung pengembangan berkelanjutan, Anda dapat berdonasi di sini:

Terima kasih yang tulus kepada komunitas dan institusi yang menginspirasi dan mendorong pekerjaan open-source ini:

• Harvard University — untuk memupuk rasa ingin tahu intelektual dan mendorong batas dari apa yang mungkin.
• MIT — untuk memperjuangkan pengetahuan terbuka, open source, dan keyakinan bahwa teknologi harus dapat diakses oleh semua orang.
• Sundai Club — untuk komunitas, energi, dan dorongan tanpa henti untuk membangun hal-hal yang penting.
• Dunia & Seterusnya 🌍✨ — kepada setiap kontributor, pemimpi, dan pembangun di luar sana yang menjadikan open source sebagai kekuatan untuk kebaikan. Ini untuk kalian.

Kami membangun secara terbuka karena ide terbaik datang dari mana saja. Jika Anda membaca ini, Anda adalah bagian darinya. Selamat datang. 🦀❤️

Baru di ZeroClaw? Cari isu berlabel good first issue — lihat Panduan Kontribusi untuk cara memulai. PR yang dibuat dengan AI/vibe-coded dipersilakan! 🤖

Lihat CONTRIBUTING.md dan CLA.md. Implementasikan trait, kirimkan PR:

• Panduan alur kerja CI: docs/contributing/ci-map.md
• Provider baru → src/providers/
• Channel baru → src/channels/
• Observer baru → src/observability/
• Tool baru → src/tools/
• Memory baru → src/memory/
• Tunnel baru → src/tunnel/
• Peripheral baru → src/peripherals/
• Skill baru → ~/.zeroclaw/workspace/skills/<name>/

Ini adalah satu-satunya repositori resmi ZeroClaw:

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

Repositori, organisasi, domain, atau paket lain yang mengklaim sebagai "ZeroClaw" atau menyiratkan afiliasi dengan ZeroClaw Labs adalah tidak sah dan tidak berafiliasi dengan proyek ini. Fork tidak sah yang diketahui akan terdaftar di TRADEMARK.md.

Jika Anda menemukan peniruan atau penyalahgunaan merek dagang, silakan buka isu.

ZeroClaw memiliki dual-license untuk keterbukaan maksimum dan perlindungan kontributor:

Anda dapat memilih salah satu lisensi. Kontributor secara otomatis memberikan hak di bawah keduanya — lihat CLA.md untuk perjanjian kontributor lengkap.

Nama dan logo ZeroClaw adalah merek dagang dari ZeroClaw Labs. Lisensi ini tidak memberikan izin untuk menggunakannya untuk menyiratkan dukungan atau afiliasi. Lihat TRADEMARK.md untuk penggunaan yang diizinkan dan dilarang.

• Anda mempertahankan hak cipta atas kontribusi Anda
• Hibah paten (Apache 2.0) melindungi Anda dari klaim paten oleh kontributor lain
• Kontribusi Anda secara permanen diatribusikan dalam riwayat commit dan NOTICE
• Tidak ada hak merek dagang yang dialihkan dengan berkontribusi

ZeroClaw — Nol overhead. Nol kompromi. Deploy di mana saja. Tukar apa saja. 🦀

Daftar ini dihasilkan dari grafik kontributor GitHub dan diperbarui secara otomatis.