صفر حمل زائد. صفر تنازلات. 100% Rust. 100% مستقل.
⚡️ يعمل على أجهزة بقيمة 10 دولارات بأقل من 5 ميجابايت رام: هذا أقل بنسبة 99% من الذاكرة مقارنة بـ OpenClaw و98% أرخص من Mac mini!
تم بناؤه بواسطة طلاب وأعضاء من مجتمعات 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 هو مساعد ذكاء اصطناعي شخصي تشغّله على أجهزتك الخاصة. يجيبك على القنوات التي تستخدمها بالفعل (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). البوابة هي مجرد مستوى التحكم — المنتج هو المساعد.
إذا كنت تريد مساعدًا شخصيًا لمستخدم واحد يشعر بأنه محلي وسريع ويعمل دائمًا، فهذا هو.
الموقع الإلكتروني · التوثيق · البنية المعمارية · البدء · الانتقال من OpenClaw · استكشاف الأخطاء · Discord
الإعداد المفضل: شغّل
zeroclaw onboardفي طرفيتك. ZeroClaw Onboard يرشدك خطوة بخطوة لإعداد البوابة ومساحة العمل والقنوات والمزود. إنه مسار الإعداد الموصى به ويعمل على macOS وLinux وWindows (عبر WSL2). تثبيت جديد؟ ابدأ هنا: البدء
ملاحظة حول النماذج: بينما يتم دعم العديد من المزودين/النماذج، للحصول على أفضل تجربة استخدم أقوى نموذج من أحدث جيل متاح لديك. انظر الإعداد.
إعدادات النماذج + CLI: مرجع المزودين تدوير ملف المصادقة (OAuth مقابل مفاتيح API) + الانتقال التلقائي: الانتقال التلقائي للنماذج
بيئة التشغيل: سلسلة أدوات Rust المستقرة. ملف ثنائي واحد، بدون تبعيات وقت التشغيل.
brew install zeroclaw
git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw
./install.sh
zeroclaw onboard يعمل تلقائيًا بعد التثبيت لتكوين مساحة العمل والمزود.
دليل المبتدئين الكامل (المصادقة، الاقتران، القنوات): البدء
# Install + onboard
./install.sh --api-key "sk-..." --provider openrouter
# Start the gateway (webhook server + web dashboard)
zeroclaw gateway # default: 127.0.0.1:42617
zeroclaw gateway --port 0 # random port (security hardened)
# Talk to the assistant
zeroclaw agent -m "Hello, ZeroClaw!"
# Interactive mode
zeroclaw agent
# Start full autonomous runtime (gateway + channels + cron + hands)
zeroclaw daemon
# Check status
zeroclaw status
# Run diagnostics
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
البديل للتطوير (بدون تثبيت عام): ابدأ الأوامر بـ
cargo run --release --(مثال:cargo run --release -- status).
يمكن لـ ZeroClaw استيراد مساحة عمل OpenClaw والذاكرة والتكوين الخاص بك:
# Preview what will be migrated (safe, read-only)
zeroclaw migrate openclaw --dry-run
# Run the migration
zeroclaw migrate openclaw
يقوم هذا بترحيل إدخالات الذاكرة وملفات مساحة العمل والتكوين من ~/.openclaw/ إلى ~/.zeroclaw/. يتم تحويل التكوين من JSON إلى TOML تلقائيًا.
يتصل ZeroClaw بأسطح المراسلة الحقيقية. تعامل مع الرسائل المباشرة الواردة كمدخلات غير موثوقة.
دليل الأمان الكامل: SECURITY.md
السلوك الافتراضي على جميع القنوات:
zeroclaw pairing approve <channel> <code> (ثم يُضاف المرسل إلى قائمة السماح المحلية).config.toml.zeroclaw doctor لكشف سياسات الرسائل المباشرة الخطرة أو المُعدة خطأ.مستويات الاستقلالية:
| المستوى | السلوك |
|---|---|
ReadOnly | يمكن للوكيل المراقبة ولكن لا يمكنه التصرف |
Supervised (افتراضي) | يتصرف الوكيل مع الموافقة على العمليات متوسطة/عالية المخاطر |
Full | يتصرف الوكيل بشكل مستقل ضمن حدود السياسة |
طبقات العزل: عزل مساحة العمل، حظر اجتياز المسار، قوائم السماح للأوامر، المسارات المحظورة (/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؛ استخدام رموز OAuth من Claude Free/Pro/Max في أي منتج أو أداة أو خدمة أخرى (بما في ذلك Agent SDK) غير مسموح به وقد ينتهك شروط خدمة المستهلك. | يرجى تجنب تكاملات Claude Code OAuth مؤقتًا لمنع الخسارة المحتملة. البند الأصلي: المصادقة واستخدام بيانات الاعتماد. |
Peripheral.مقارنة محلية سريعة (macOS arm64، فبراير 2026) مُعايرة لأجهزة الحافة بتردد 0.8GHz.
| OpenClaw | NanoBot | PicoClaw | ZeroClaw 🦀 | |
|---|---|---|---|---|
| اللغة | TypeScript | Python | Go | Rust |
| الرام | > 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 (عادةً ~390 ميجابايت حمل ذاكرة إضافي)، بينما يتطلب NanoBot بيئة تشغيل Python. PicoClaw وZeroClaw ملفات ثنائية ثابتة. أرقام الرام أعلاه هي ذاكرة وقت التشغيل؛ متطلبات التجميع في وقت البناء أعلى.
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 (أصلي)، 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.
مُحددة بالميزات: Matrix (channel-matrix)، Lark (channel-lark)، Nostr (channel-nostr).
لوحة تحكم ويب 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" # or "tailscale", "ngrok", "openvpn", "custom", "none"
التفاصيل: مرجع القنوات · مرجع التكوين
native (افتراضي) — تنفيذ مباشر للعمليات، أسرع مسار، مثالي للبيئات الموثوقة.docker — عزل كامل بالحاويات، سياسات أمان مفروضة، يتطلب Docker.اضبط runtime.kind = "docker" للعزل الصارم أو عزل الشبكة.
يدعم ZeroClaw ملفات تعريف مصادقة أصلية للاشتراك (متعددة الحسابات، مشفرة عند الراحة).
~/.zeroclaw/auth-profiles.json~/.zeroclaw/.secret_key<provider>:<profile_name> (مثال: openai-codex:work)# OpenAI Codex OAuth (ChatGPT subscription)
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
# Check / refresh / switch profile
zeroclaw auth status
zeroclaw auth refresh --provider openai-codex --profile default
zeroclaw auth use --provider openai-codex --profile work
# Run the agent with subscription auth
zeroclaw agent --provider openai-codex -m "hello"
zeroclaw agent --provider anthropic -m "hello"
جذر مساحة العمل: ~/.zeroclaw/workspace/ (قابل للتكوين عبر التكوين).
ملفات الموجه المحقونة:
IDENTITY.md — شخصية الوكيل ودورهUSER.md — سياق المستخدم وتفضيلاتهMEMORY.md — حقائق ودروس طويلة المدىAGENTS.md — اتفاقيات الجلسة وقواعد التهيئةSOUL.md — الهوية الأساسية ومبادئ التشغيلالمهارات: ~/.zeroclaw/workspace/skills/<skill>/SKILL.md أو SKILL.toml.
# List installed skills
zeroclaw skills list
# Install from git
zeroclaw skills install https://github.com/user/my-skill.git
# Security audit before install
zeroclaw skills audit https://github.com/user/my-skill.git
# Remove a skill
zeroclaw skills remove my-skill
# Workspace management
zeroclaw onboard # Guided setup wizard
zeroclaw status # Show daemon/agent status
zeroclaw doctor # Run system diagnostics
# Gateway + daemon
zeroclaw gateway # Start gateway server (127.0.0.1:42617)
zeroclaw daemon # Start full autonomous runtime
# Agent
zeroclaw agent # Interactive chat mode
zeroclaw agent -m "message" # Single message mode
# Service management
zeroclaw service install # Install as OS service (launchd/systemd)
zeroclaw service start|stop|restart|status
# Channels
zeroclaw channel list # List configured channels
zeroclaw channel doctor # Check channel health
zeroclaw channel bind-telegram 123456789
# Cron + scheduling
zeroclaw cron list # List scheduled jobs
zeroclaw cron add "*/5 * * * *" --prompt "Check system health"
zeroclaw cron remove <id>
# Memory
zeroclaw memory list # List memory entries
zeroclaw memory get <key> # Retrieve a memory
zeroclaw memory stats # Memory statistics
# Auth profiles
zeroclaw auth login --provider <name>
zeroclaw auth status
zeroclaw auth use --provider <name> --profile <profile>
# Hardware peripherals
zeroclaw hardware discover # Scan for connected devices
zeroclaw peripheral list # List connected peripherals
zeroclaw peripheral flash # Flash firmware to device
# Migration
zeroclaw migrate openclaw --dry-run
zeroclaw migrate openclaw
# Shell completions
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:
winget install Rustlang.Rustup
بعد التثبيت، افتح طرفية جديدة وشغّل rustup default stable لضمان أن سلسلة الأدوات المستقرة نشطة.
تحقق من أن كليهما يعملان:
rustc --version
cargo --version
runtime.kind = "docker"). ثبّت عبر winget install Docker.DockerDesktop.أساسيات البناء:
sudo apt install build-essential pkg-configsudo dnf group install development-tools && sudo dnf install pkg-configxcode-select --installسلسلة أدوات Rust:
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
انظر rustup.rs للتفاصيل.
تحقق من أن كليهما يعملان:
rustc --version
cargo --version
أو تخطى الخطوات أعلاه وثبّت كل شيء (تبعيات النظام، Rust، ZeroClaw) بأمر واحد:
curl -LsSf https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/install.sh | bash
البناء من المصدر يحتاج موارد أكثر من تشغيل الملف الثنائي الناتج:
| المورد | الحد الأدنى | الموصى به |
|---|---|---|
| الرام + 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
استخدم هذه عندما تتجاوز مرحلة الإعداد وتريد المرجع الأعمق.
تم بناء ZeroClaw للسلطعون الناعم 🦀، مساعد ذكاء اصطناعي سريع وفعال. بناه Argenis De La Rosa والمجتمع.
إذا ساعدك ZeroClaw في عملك وتريد دعم التطوير المستمر، يمكنك التبرع هنا:
شكر من القلب للمجتمعات والمؤسسات التي تلهم وتغذي هذا العمل مفتوح المصدر:
نحن نبني علنًا لأن أفضل الأفكار تأتي من كل مكان. إذا كنت تقرأ هذا، فأنت جزء منه. مرحبًا. 🦀❤️
جديد على ZeroClaw؟ ابحث عن المشكلات المصنفة good first issue — انظر دليل المساهمة لمعرفة كيفية البدء. مرحبًا بمساهمات AI/vibe-coded! 🤖
انظر CONTRIBUTING.md وCLA.md. نفّذ سمة، قدّم 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.
إذا واجهت انتحالًا أو إساءة استخدام للعلامة التجارية، يرجى فتح مشكلة.
ZeroClaw مرخص بترخيص مزدوج لأقصى انفتاح وحماية للمساهمين:
| الترخيص | حالة الاستخدام |
|---|---|
| MIT | مفتوح المصدر، بحثي، أكاديمي، استخدام شخصي |
| Apache 2.0 | حماية براءات الاختراع، مؤسسي، نشر تجاري |
يمكنك اختيار أي ترخيص. يمنح المساهمون الحقوق تلقائيًا بموجب كليهما — انظر CLA.md لاتفاقية المساهم الكاملة.
اسم وشعار ZeroClaw هما علامتان تجاريتان لـ ZeroClaw Labs. لا يمنح هذا الترخيص إذنًا لاستخدامهما للإشارة إلى التأييد أو الانتماء. انظر TRADEMARK.md للاستخدامات المسموحة والمحظورة.
ZeroClaw — صفر حمل زائد. صفر تنازلات. انشر في أي مكان. بدّل أي شيء. 🦀
يتم إنشاء هذه القائمة من رسم المساهمين في GitHub وتُحدّث تلقائيًا.