صفر اوور ہیڈ۔ صفر سمجھوتا۔ 100% Rust۔ 100% غیر جانبدار۔
⚡️ $10 ہارڈویئر پر <5MB RAM کے ساتھ چلتا ہے: یہ OpenClaw سے 99% کم میموری اور Mac mini سے 98% سستا ہے!
Harvard، MIT، اور Sundai.Club کمیونٹیز کے طلباء اور اراکین نے بنایا۔
🌐 زبانیں: 🇺🇸 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 ایک ذاتی AI اسسٹنٹ ہے جسے آپ اپنے آلات پر چلاتے ہیں۔ یہ آپ کو ان چینلز پر جواب دیتا ہے جو آپ پہلے سے استعمال کرتے ہیں (WhatsApp، Telegram، Slack، Discord، Signal، iMessage، Matrix، IRC، Email، Bluesky، Nostr، Mattermost، Nextcloud Talk، DingTalk، Lark، QQ، Reddit، LinkedIn، Twitter، MQTT، WeChat Work، اور مزید)۔ اس میں ریئل ٹائم کنٹرول کے لیے ویب ڈیش بورڈ ہے اور یہ ہارڈویئر پیری فیرلز (ESP32، STM32، Arduino، Raspberry Pi) سے جڑ سکتا ہے۔ Gateway صرف control plane ہے — پروڈکٹ اسسٹنٹ ہے۔
اگر آپ ایک ذاتی، واحد صارف اسسٹنٹ چاہتے ہیں جو مقامی، تیز، اور ہمیشہ فعال محسوس ہو، تو یہ ہے۔
ویب سائٹ · دستاویزات · آرکیٹیکچر · شروع کریں · OpenClaw سے منتقلی · مسائل حل کریں · Discord
تجویز کردہ سیٹ اپ: اپنے ٹرمینل میں
zeroclaw onboardچلائیں۔ ZeroClaw Onboard آپ کو gateway، workspace، چینلز، اور provider ترتیب دینے میں مرحلہ وار رہنمائی کرتا ہے۔ یہ تجویز کردہ سیٹ اپ راستہ ہے اور macOS، Linux، اور Windows (WSL2 کے ذریعے) پر کام کرتا ہے۔ نئی تنصیب؟ یہاں سے شروع کریں: شروع کریں
ماڈل نوٹ: اگرچہ بہت سے providers/ماڈلز سپورٹ کیے جاتے ہیں، بہترین تجربے کے لیے اپنے دستیاب سب سے مضبوط جدید ترین ماڈل کا استعمال کریں۔ دیکھیں Onboarding۔
ماڈلز کنفیگ + CLI: Providers حوالہ Auth پروفائل روٹیشن (OAuth بمقابلہ API keys) + failover: Model failover
رن ٹائم: Rust stable toolchain۔ واحد بائنری، کوئی runtime dependencies نہیں۔
brew install zeroclaw
git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw
./install.sh
zeroclaw onboard انسٹال کے بعد خود بخود چلتا ہے تاکہ آپ کا workspace اور provider ترتیب دیا جا سکے۔
مکمل ابتدائی گائیڈ (تصدیق، pairing، چینلز): شروع کریں
# انسٹال + onboard
./install.sh --api-key "sk-..." --provider openrouter
# Gateway شروع کریں (webhook سرور + ویب ڈیش بورڈ)
zeroclaw gateway # ڈیفالٹ: 127.0.0.1:42617
zeroclaw gateway --port 0 # بے ترتیب پورٹ (سیکیورٹی مضبوط)
# اسسٹنٹ سے بات کریں
zeroclaw agent -m "Hello, ZeroClaw!"
# انٹرایکٹو موڈ
zeroclaw agent
# مکمل خودمختار رن ٹائم شروع کریں (gateway + چینلز + cron + hands)
zeroclaw daemon
# اسٹیٹس چیک کریں
zeroclaw status
# تشخیص چلائیں
zeroclaw doctor
اپ گریڈ کر رہے ہیں؟ اپ ڈیٹ کے بعد zeroclaw doctor چلائیں۔
git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw
cargo build --release --locked
cargo install --path . --force --locked
zeroclaw onboard
Dev متبادل (بغیر global انسٹال): کمانڈز کے آگے
cargo run --release --لگائیں (مثال:cargo run --release -- status)۔
ZeroClaw آپ کا OpenClaw workspace، میموری، اور کنفیگریشن درآمد کر سکتا ہے:
# دیکھیں کیا منتقل ہوگا (محفوظ، صرف پڑھنے)
zeroclaw migrate openclaw --dry-run
# منتقلی چلائیں
zeroclaw migrate openclaw
یہ آپ کے میموری اندراجات، workspace فائلیں، اور کنفیگریشن ~/.openclaw/ سے ~/.zeroclaw/ میں منتقل کرتا ہے۔ کنفیگ خود بخود JSON سے TOML میں تبدیل ہو جاتی ہے۔
ZeroClaw حقیقی پیغام رسانی سطحوں سے جڑتا ہے۔ آنے والے DMs کو غیر بھروسہ مند ان پٹ سمجھیں۔
مکمل سیکیورٹی گائیڈ: SECURITY.md
تمام چینلز پر ڈیفالٹ رویہ:
zeroclaw pairing approve <channel> <code> (پھر بھیجنے والا مقامی اجازت نامہ میں شامل ہو جاتا ہے)۔config.toml میں واضح opt-in ضروری ہے۔zeroclaw doctor چلائیں۔خودمختاری کی سطحیں:
| سطح | رویہ |
|---|---|
ReadOnly | ایجنٹ مشاہدہ کر سکتا ہے لیکن عمل نہیں کر سکتا |
Supervised (ڈیفالٹ) | ایجنٹ درمیانے/زیادہ خطرے والے آپریشنز کے لیے منظوری کے ساتھ عمل کرتا ہے |
Full | ایجنٹ پالیسی حدود میں خودمختار طور پر عمل کرتا ہے |
سینڈ باکسنگ پرتیں: workspace تنہائی، path traversal بلاکنگ، کمانڈ اجازت نامے، ممنوعہ راستے (/etc، /root، ~/.ssh)، شرح محدودیت (زیادہ سے زیادہ عمل/گھنٹہ، لاگت/دن کی حد)۔
اہم نوٹسز کے لیے یہ بورڈ استعمال کریں (تبدیلیاں جو توڑ دیں، سیکیورٹی مشاورتیں، دیکھ بھال کی کھڑکیاں، اور ریلیز بلاکرز)۔
| تاریخ (UTC) | سطح | نوٹس | عمل |
|---|---|---|---|
| 2026-02-19 | اہم ترین | ہم openagen/zeroclaw، zeroclaw.org یا zeroclaw.net سے وابستہ نہیں ہیں۔ zeroclaw.org اور zeroclaw.net ڈومینز فی الحال openagen/zeroclaw فورک کی طرف اشارہ کرتے ہیں، اور وہ ڈومین/ریپوزٹری ہماری سرکاری ویب سائٹ/پروجیکٹ کی نقل کر رہے ہیں۔ | ان ذرائع سے معلومات، بائنریز، فنڈ ریزنگ، یا اعلانات پر بھروسہ نہ کریں۔ صرف یہ ریپوزٹری اور ہمارے تصدیق شدہ سوشل اکاؤنٹس استعمال کریں۔ |
| 2026-02-19 | اہم | Anthropic نے 2026-02-19 کو تصدیق اور اسناد کے استعمال کی شرائط اپ ڈیٹ کیں۔ Claude Code OAuth ٹوکنز (Free، Pro، Max) خصوصی طور پر Claude Code اور Claude.ai کے لیے ہیں؛ Claude Free/Pro/Max سے OAuth ٹوکنز کسی اور پروڈکٹ، ٹول، یا سروس (بشمول Agent SDK) میں استعمال کرنا اجازت یافتہ نہیں ہے اور صارف سروس کی شرائط کی خلاف ورزی ہو سکتی ہے۔ | براہ کرم ممکنہ نقصان سے بچنے کے لیے عارضی طور پر Claude Code OAuth انٹیگریشنز سے گریز کریں۔ اصل شق: Authentication and Credential Use۔ |
Peripheral trait کے ذریعے ESP32، STM32 Nucleo، Arduino، Raspberry Pi GPIO۔مقامی مشین فوری بینچ مارک (macOS arm64، فروری 2026) 0.8GHz ایج ہارڈویئر کے لیے نارملائز۔
| OpenClaw | NanoBot | PicoClaw | ZeroClaw 🦀 | |
|---|---|---|---|---|
| زبان | TypeScript | Python | Go | Rust |
| RAM | > 1GB | > 100MB | < 10MB | < 5MB |
| اسٹارٹ اپ (0.8GHz کور) | > 500s | > 30s | < 1s | < 10ms |
| بائنری سائز | ~28MB (dist) | N/A (Scripts) | ~8MB | ~8.8 MB |
| لاگت | Mac Mini $599 | Linux SBC ~$50 | Linux Board $10 | کوئی بھی ہارڈویئر $10 |
نوٹ: ZeroClaw نتائج
/usr/bin/time -lاستعمال کرتے ہوئے ریلیز بلڈز پر ماپے گئے ہیں۔ OpenClaw کو Node.js رن ٹائم کی ضرورت ہے (عام طور پر ~390MB اضافی میموری اوور ہیڈ)، جبکہ NanoBot کو Python رن ٹائم کی ضرورت ہے۔ PicoClaw اور ZeroClaw سٹیٹک بائنریز ہیں۔ اوپر RAM اعداد رن ٹائم میموری ہیں؛ بلڈ ٹائم کمپائلیشن ضروریات زیادہ ہیں۔
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، agent، onboard، doctor، status، service، migrate، auth، cron، channel، skills۔چینلز: 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)۔
Gateway سے براہ راست فراہم کردہ React 19 + Vite 6 + Tailwind CSS 4 ویب ڈیش بورڈ:
| ہدف | پلیٹ فارم | مقصد |
|---|---|---|
| ESP32 | Espressif ESP32 | وائرلیس پیری فیرل ایجنٹ |
| ESP32-UI | ESP32 + Display | بصری انٹرفیس کے ساتھ ایجنٹ |
| STM32 Nucleo | STM32 (ARM Cortex-M) | صنعتی پیری فیرل |
| Arduino | Arduino | بنیادی سینسر/ایکچویٹر بریج |
| Uno Q Bridge | Arduino Uno | ایجنٹ کے لیے سیریل بریج |
کم از کم ~/.zeroclaw/config.toml:
default_provider = "anthropic"
api_key = "sk-ant-..."
مکمل کنفیگریشن حوالہ: 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" # یا "tailscale", "ngrok", "openvpn", "custom", "none"
تفصیلات: چینل حوالہ · کنفیگ حوالہ
native (ڈیفالٹ) — براہ راست process ایگزیکیوشن، تیز ترین راستہ، بھروسہ مند ماحول کے لیے مثالی۔docker — مکمل کنٹینر تنہائی، نافذ سیکیورٹی پالیسیاں، Docker ضروری ہے۔سخت سینڈ باکسنگ یا نیٹ ورک تنہائی کے لیے runtime.kind = "docker" سیٹ کریں۔
ZeroClaw سبسکرپشن نیٹو auth پروفائلز سپورٹ کرتا ہے (ملٹی اکاؤنٹ، آرام پر خفیہ)۔
~/.zeroclaw/auth-profiles.json~/.zeroclaw/.secret_key<provider>:<profile_name> (مثال: openai-codex:work)# OpenAI Codex OAuth (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
# چیک / ریفریش / پروفائل تبدیل کریں
zeroclaw auth status
zeroclaw auth refresh --provider openai-codex --profile default
zeroclaw auth use --provider openai-codex --profile work
# سبسکرپشن auth کے ساتھ ایجنٹ چلائیں
zeroclaw agent --provider openai-codex -m "hello"
zeroclaw agent --provider anthropic -m "hello"
Workspace روٹ: ~/.zeroclaw/workspace/ (config کے ذریعے قابل ترتیب)۔
انجیکٹ کردہ prompt فائلیں:
IDENTITY.md — ایجنٹ شخصیت اور کردارUSER.md — صارف سیاق و سباق اور ترجیحاتMEMORY.md — طویل مدتی حقائق اور اسباقAGENTS.md — سیشن کنونشنز اور آغاز کے قواعدSOUL.md — بنیادی شناخت اور آپریٹنگ اصولاسکلز: ~/.zeroclaw/workspace/skills/<skill>/SKILL.md یا SKILL.toml۔
# انسٹال شدہ اسکلز کی فہرست
zeroclaw skills list
# git سے انسٹال
zeroclaw skills install https://github.com/user/my-skill.git
# انسٹال سے پہلے سیکیورٹی آڈٹ
zeroclaw skills audit https://github.com/user/my-skill.git
# اسکل ہٹائیں
zeroclaw skills remove my-skill
# Workspace مینجمنٹ
zeroclaw onboard # رہنمائی شدہ سیٹ اپ وزرڈ
zeroclaw status # daemon/ایجنٹ اسٹیٹس دکھائیں
zeroclaw doctor # سسٹم تشخیص چلائیں
# Gateway + daemon
zeroclaw gateway # Gateway سرور شروع کریں (127.0.0.1:42617)
zeroclaw daemon # مکمل خودمختار رن ٹائم شروع کریں
# ایجنٹ
zeroclaw agent # انٹرایکٹو چیٹ موڈ
zeroclaw agent -m "message" # واحد پیغام موڈ
# سروس مینجمنٹ
zeroclaw service install # OS سروس کے طور پر انسٹال کریں (launchd/systemd)
zeroclaw service start|stop|restart|status
# چینلز
zeroclaw channel list # ترتیب شدہ چینلز کی فہرست
zeroclaw channel doctor # چینل صحت چیک کریں
zeroclaw channel bind-telegram 123456789
# Cron + شیڈولنگ
zeroclaw cron list # شیڈولڈ جابز کی فہرست
zeroclaw cron add "*/5 * * * *" --prompt "Check system health"
zeroclaw cron remove <id>
# میموری
zeroclaw memory list # میموری اندراجات کی فہرست
zeroclaw memory get <key> # میموری حاصل کریں
zeroclaw memory stats # میموری اعداد و شمار
# Auth پروفائلز
zeroclaw auth login --provider <name>
zeroclaw auth status
zeroclaw auth use --provider <name> --profile <profile>
# ہارڈویئر پیری فیرلز
zeroclaw hardware discover # منسلک آلات اسکین کریں
zeroclaw peripheral list # منسلک پیری فیرلز کی فہرست
zeroclaw peripheral flash # آلے پر فرم ویئر فلیش کریں
# منتقلی
zeroclaw migrate openclaw --dry-run
zeroclaw migrate openclaw
# شیل تکمیلات
source <(zeroclaw completions bash)
zeroclaw completions zsh > ~/.zfunc/_zeroclaw
مکمل کمانڈز حوالہ: docs/reference/cli/commands-reference.md
Visual Studio Build Tools (MSVC لنکر اور Windows SDK فراہم کرتا ہے):
winget install Microsoft.VisualStudio.2022.BuildTools
انسٹالیشن کے دوران (یا Visual Studio Installer کے ذریعے)، "Desktop development with C++" ورک لوڈ منتخب کریں۔
Rust toolchain:
winget install Rustlang.Rustup
انسٹالیشن کے بعد، نیا ٹرمینل کھولیں اور rustup default stable چلائیں تاکہ مستحکم toolchain فعال ہو۔
تصدیق کریں دونوں کام کر رہے ہیں:
rustc --version
cargo --version
runtime.kind = "docker") استعمال کر رہے ہوں۔ winget install Docker.DockerDesktop سے انسٹال کریں۔Build essentials:
sudo apt install build-essential pkg-configsudo dnf group install development-tools && sudo dnf install pkg-configxcode-select --installRust toolchain:
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
تفصیلات کے لیے rustup.rs دیکھیں۔
تصدیق کریں دونوں کام کر رہے ہیں:
rustc --version
cargo --version
یا اوپر کے مراحل چھوڑیں اور سب کچھ (سسٹم dependencies، Rust، ZeroClaw) ایک کمانڈ میں انسٹال کریں:
curl -LsSf https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/install.sh | bash
سورس سے بنانا نتیجے میں آنے والی بائنری چلانے سے زیادہ وسائل کی ضرورت ہے:
| وسیلہ | کم از کم | تجویز کردہ |
|---|---|---|
| RAM + swap | 2 GB | 4 GB+ |
| خالی ڈسک | 6 GB | 10 GB+ |
اگر آپ کا ہوسٹ کم از کم سے نیچے ہے، پری بلٹ بائنریز استعمال کریں:
./install.sh --prefer-prebuilt
بغیر سورس فال بیک صرف بائنری انسٹال کے لیے:
./install.sh --prebuilt-only
runtime.kind = "docker") استعمال کر رہے ہوں۔ اپنے پیکیج مینیجر یا docker.com سے انسٹال کریں۔نوٹ: ڈیفالٹ
cargo build --releaseچوٹی کمپائل دباؤ کم کرنے کے لیےcodegen-units=1استعمال کرتا ہے۔ طاقتور مشینوں پر تیز بلڈز کے لیے،cargo build --profile release-fastاستعمال کریں۔
ریلیز اثاثے شائع کیے جاتے ہیں:
x86_64، aarch64، armv7x86_64، aarch64x86_64تازہ ترین اثاثے یہاں سے ڈاؤن لوڈ کریں: https://github.com/zeroclaw-labs/zeroclaw/releases/latest
جب آپ onboarding فلو سے گزر چکے ہوں اور گہرا حوالہ چاہتے ہوں تو یہ استعمال کریں۔
ZeroClaw smooth crab 🦀 کے لیے بنایا گیا تھا، ایک تیز اور مؤثر AI اسسٹنٹ۔ Argenis De La Rosa اور کمیونٹی نے بنایا۔
اگر ZeroClaw آپ کے کام میں مدد کرتا ہے اور آپ جاری ترقی کی حمایت کرنا چاہتے ہیں، تو آپ یہاں عطیہ دے سکتے ہیں:
ان کمیونٹیز اور اداروں کا دلی شکریہ جو اس اوپن سورس کام کو متاثر اور توانائی دیتے ہیں:
ہم کھلے میں بنا رہے ہیں کیونکہ بہترین آئیڈیاز ہر جگہ سے آتے ہیں۔ اگر آپ یہ پڑھ رہے ہیں، تو آپ اس کا حصہ ہیں۔ خوش آمدید۔ 🦀❤️
ZeroClaw میں نئے ہیں؟ good first issue لیبل والے issues تلاش کریں — شروع کرنے کے طریقے کے لیے شراکت گائیڈ دیکھیں۔ AI/vibe-coded PRs کا خیرمقدم ہے! 🤖
CONTRIBUTING.md اور CLA.md دیکھیں۔ ایک trait نافذ کریں، PR جمع کرائیں:
Provider → src/providers/Channel → src/channels/Observer → src/observability/Tool → src/tools/Memory → src/memory/Tunnel → src/tunnel/Peripheral → src/peripherals/Skill → ~/.zeroclaw/workspace/skills/<name>/یہ ZeroClaw کی واحد سرکاری ریپوزٹری ہے:
کوئی بھی دوسری ریپوزٹری، تنظیم، ڈومین، یا پیکیج جو "ZeroClaw" ہونے کا دعویٰ کرے یا ZeroClaw Labs سے وابستگی کا اشارہ کرے غیر مجاز ہے اور اس پروجیکٹ سے وابستہ نہیں ہے۔ معلوم غیر مجاز فورکس TRADEMARK.md میں درج ہوں گے۔
اگر آپ کو نقل یا ٹریڈ مارک کا غلط استعمال ملے، براہ کرم issue کھولیں۔
ZeroClaw زیادہ سے زیادہ کشادگی اور شراکت دار تحفظ کے لیے دوہری لائسنس یافتہ ہے:
| لائسنس | استعمال کا معاملہ |
|---|---|
| MIT | اوپن سورس، تحقیق، تعلیمی، ذاتی استعمال |
| Apache 2.0 | پیٹنٹ تحفظ، ادارہ جاتی، تجارتی تعیناتی |
آپ کوئی بھی لائسنس منتخب کر سکتے ہیں۔ شراکت دار خود بخود دونوں کے تحت حقوق دیتے ہیں — مکمل شراکت دار معاہدے کے لیے CLA.md دیکھیں۔
ZeroClaw نام اور لوگو ZeroClaw Labs کے ٹریڈ مارکس ہیں۔ یہ لائسنس انہیں توثیق یا وابستگی کا اشارہ دینے کے لیے استعمال کرنے کی اجازت نہیں دیتا۔ مجاز اور ممنوع استعمال کے لیے TRADEMARK.md دیکھیں۔
ZeroClaw — صفر اوور ہیڈ۔ صفر سمجھوتا۔ کہیں بھی تعینات کریں۔ کچھ بھی تبدیل کریں۔ 🦀
یہ فہرست GitHub شراکت داروں کے گراف سے بنائی گئی ہے اور خود بخود اپ ڈیٹ ہوتی ہے۔