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

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

<p align="center" dir="rtl">
  <strong>صفر عبء. صفر تنازلات. 100% Rust. 100% محايد.</strong><br>
  <strong dir="ltr">⚡️ يعمل على أجهزة بقيمة $10 بأقل من 5MB RAM: ذاكرة أقل بنسبة 99% من OpenClaw وأرخص بنسبة 98% من Mac mini!</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://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" dir="rtl">
بني من قبل طلاب وأعضاء مجتمعات هارفارد ومعهد ماساتشوستس للتكنولوجيا وSundai.Club.
</p>

<p align="center" dir="rtl">
  🌐 <strong>اللغات:</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" dir="rtl">
  <a href="#البدء-السريع">البدء السريع</a> |
  <a href="bootstrap.sh">الإعداد بنقرة واحدة</a> |
  <a href="docs/README.md">مركز التوثيق</a> |
  <a href="docs/SUMMARY.md">فهرس التوثيق</a>
</p>

<p align="center" dir="rtl">
  <strong>الوصول السريع:</strong>
  <a href="docs/reference/README.md">المرجع</a> ·
  <a href="docs/operations/README.md">العمليات</a> ·
  <a href="docs/troubleshooting.md">استكشاف الأخطاء</a> ·
  <a href="docs/security/README.md">الأمان</a> ·
  <a href="docs/hardware/README.md">الأجهزة</a> ·
  <a href="docs/contributing/README.md">المساهمة</a>
</p>

<p align="center" dir="rtl">
  <strong>بنية تحتية سريعة وخفيفة ومستقلة تمامًا لمساعد الذكاء الاصطناعي</strong><br />
  انشر في أي مكان. استبدل أي شيء.
</p>

<p align="center" dir="rtl">
  ZeroClaw هو <strong>نظام تشغيل وقت التشغيل</strong> لعمليات العمل الآلية — بنية تحتية تجرد النماذج والأدوات والذاكرة والتنفيذ لبناء وكلاء مرة واحدة وتشغيلهم في أي مكان.
</p>

<p align="center"><code>بنية قائمة على السمات · وقت تشغيل آمن افتراضيًا · موفر/قناة/أداة قابلة للتبديل · كل شيء قابل للتوصيل</code></p>

### 📢 الإعلانات

استخدم هذا الجدول للإشعارات المهمة (تغييرات التوافق، إشعارات الأمان، نوافذ الصيانة، وحجوز الإصدارات).

| التاريخ (UTC) | المستوى      | الإشعار                                                                                                                                                                                                                                                                                                                                                                                                              | الإجراء                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ---------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 2026-02-19 | _حرج_  | **نحن غير مرتبطين** بـ `openagen/zeroclaw` أو `zeroclaw.org`. نطاق `zeroclaw.org` يشير حاليًا إلى الفرع `openagen/zeroclaw`، وهذا النطاق/المستودع ينتحل شخصية موقعنا/مشروعنا الرسمي.                                                                                                                                                                                 | لا تثق بالمعلومات أو الملفات الثنائية أو جمع التبرعات أو الإعلانات من هذه المصادر. استخدم فقط [هذا المستودع](https://github.com/zeroclaw-labs/zeroclaw) وحساباتنا الموثقة على وسائل التواصل الاجتماعي.                                                                                                                                                                                                                                                                                                                                                          |
| 2026-02-21 | _مهم_ | موقعنا الرسمي أصبح متاحًا الآن: [zeroclawlabs.ai](https://zeroclawlabs.ai). شكرًا لصبرك أثناء الانتظار. لا نزال نكتشف محاولات الانتحال: لا تشارك في أي نشاط استثمار/تمويل باسم ZeroClaw إذا لم يتم نشره عبر قنواتنا الرسمية.                                                                                                                   | استخدم [هذا المستودع](https://github.com/zeroclaw-labs/zeroclaw) كمصدر وحيد للحقيقة. تابع [X (@zeroclawlabs)](https://x.com/zeroclawlabs?s=21)، [Telegram (@zeroclawlabs)](https://t.me/zeroclawlabs)، [Facebook (مجموعة)](https://www.facebook.com/groups/zeroclaw)، [Reddit (r/zeroclawlabs)](https://www.reddit.com/r/zeroclawlabs/)، و[Xiaohongshu](https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search) للتحديثات الرسمية. |
| 2026-02-19 | _مهم_ | قامت Anthropic بتحديث شروط استخدام المصادقة وبيانات الاعتماد في 2026-02-19. مصادقة OAuth (Free، Pro، Max) حصريًا لـ Claude Code و Claude.ai؛ استخدام رموز Claude Free/Pro/Max OAuth في أي منتج أو أداة أو خدمة أخرى (بما في ذلك Agent SDK) غير مسموح به وقد ينتهك شروط استخدام المستهلك. | يرجى تجنب مؤقتًا تكاملات Claude Code OAuth لمنع أي خسارة محتملة. البند الأصلي: [Authentication and Credential Use](https://code.claude.com/docs/en/legal-and-compliance#authentication-and-credential-use).                                                                                                                                                                                                                                                                                                                      |

### ✨ الميزات

- 🏎️ **وقت تشغيل خفيف افتراضيًا:** عمليات سطر الأوامر الشائعة وأوامر الحالة تعمل ضمن مساحة ذاكرة بضع ميغابايت في إصدارات الإنتاج.
- 💰 **نشر فعال من حيث التكلفة:** مصمم للوحات منخفضة التكلفة وحالات السحابة الصغيرة بدون تبعيات وقت تشغيل ثقيلة.
- ⚡ **بدء تشغيل سريع من البارد:** وقت تشغيل Rust الثنائي الواحد يحافظ على بدء الأوامر والبرامج الخلفية شبه فوري للعمليات اليومية.
- 🌍 **بنية محمولة:** سير عمل ثنائي واحد على ARM و x86 و RISC-V مع موفر/قناة/أداة قابلة للتبديل.

### لماذا تختار الفرق ZeroClaw

- **خفيف افتراضيًا:** ملف Rust ثنائي صغير، بدء تشغيل سريع، بصمة ذاكرة منخفضة.
- **آمن بالتصميم:** الاقتران، الصندوق الرملي الصارم، قوائم السماح الصريحة، نطاق مساحة العمل.
- **قابل للتبديل بالكامل:** الأنظمة الأساسية هي سمات (الموفرون، القنوات، الأدوات، الذاكرة، الأنفاق).
- **لا قفل للمورد:** دعم موفر متوافق مع OpenAI + نقاط نهاية مخصصة قابلة للتوصيل.

## لقطة قياس الأداء (ZeroClaw مقابل OpenClaw، قابلة للتكرار)

قياس أداء سريع على جهاز محلي (macOS arm64، فبراير 2026) مُطبع لأجهزة الحافة بسرعة 0.8 GHz.

|                              | OpenClaw      | NanoBot        | PicoClaw        | ZeroClaw 🦀           |
| ---------------------------- | ------------- | -------------- | --------------- | --------------------- |
| **اللغة**                  | TypeScript    | Python         | Go              | **Rust**              |
| **الذاكرة العشوائية**                      | > 1 غيغابايت        | > 100 ميغابايت       | < 10 ميغابايت         | **< 5 ميغابايت**            |
| **بدء التشغيل (نواة 0.8 GHz)** | > 500 ثانية        | > 30 ثانية          | < 1 ثانية            | **< 10 ملي ثانية**            |
| **حجم الملف الثنائي**           | ~28 ميغابايت (dist) | N/A (Scripts)  | ~8 ميغابايت           | **3.4 ميغابايت**            |
| **التكلفة**                     | Mac Mini $599 | Linux SBC ~$50 | لوحة Linux $10 | **أي جهاز $10** |

> ملاحظات: تم قياس نتائج ZeroClaw في إصدارات الإنتاج باستخدام `/usr/bin/time -l`. يتطلب OpenClaw وقت تشغيل Node.js (عادةً ~390 ميغابايت من عبء الذاكرة الإضافي)، بينما يتطلب NanoBot وقت تشغيل Python. PicoClaw و ZeroClaw هما ملفات ثنائية ثابتة. أرقام الذاكرة العشوائية أعلاه هي ذاكرة وقت التشغيل؛ متطلبات التجميع في وقت البناء أعلى.

<p align="center">
  <img src="zero-claw.jpeg" alt="مقارنة ZeroClaw مقابل OpenClaw" width="800" />
</p>

### قياس محلي قابل للتكرار

قد تتغير ادعاءات قياس الأداء مع تطور الكود وسلاسل الأدوات، لذا قم دائمًا بقياس إصدارك الحالي محليًا:

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

عينة مثال (macOS arm64، تم قياسها في 18 فبراير 2026):

- حجم الملف الثنائي للإصدار: `8.8M`
- `zeroclaw --help`: وقت حقيقي حوالي `0.02s`، بصمة ذاكرة قصوى ~`3.9 ميغابايت`
- `zeroclaw status`: وقت حقيقي حوالي `0.01s`، بصمة ذاكرة قصوى ~`4.1 ميغابايت`

## المتطلبات الأساسية

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

### Windows — مطلوب

1. **Visual Studio Build Tools** (يوفر رابط MSVC و Windows SDK):

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

    أثناء التثبيت (أو عبر Visual Studio Installer)، حدد عبء عمل **"تطوير سطح المكتب باستخدام C++"**.

2. **سلسلة أدوات Rust:**

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

    بعد التثبيت، افتح محطة طرفية جديدة وقم بتشغيل `rustup default stable` للتأكد من أن سلسلة الأدوات المستقرة نشطة.

3. **تحقق** من أن كلاهما يعمل:
    ```powershell
    rustc --version
    cargo --version
    ```

### Windows — اختياري

- **Docker Desktop** — مطلوب فقط إذا كنت تستخدم [وقت تشغيل Docker المعزول](#دعم-وقت-التشغيل-الحالي) (`runtime.kind = "docker"`). قم بالتثبيت عبر `winget install Docker.DockerDesktop`.

</details>

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

### Linux / macOS — مطلوب

1. **أدوات البناء الأساسية:**
    - **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: `xcode-select --install`

2. **سلسلة أدوات Rust:**

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

    راجع [rustup.rs](https://rustup.rs) للتفاصيل.

3. **تحقق:**
    ```bash
    rustc --version
    cargo --version
    ```

### Linux / macOS — اختياري

- **Docker** — مطلوب فقط إذا كنت تستخدم [وقت تشغيل Docker المعزول](#دعم-وقت-التشغيل-الحالي) (`runtime.kind = "docker"`).
    - **Linux (Debian/Ubuntu):** راجع [docs.docker.com](https://docs.docker.com/engine/install/ubuntu/)
    - **Linux (Fedora/RHEL):** راجع [docs.docker.com](https://docs.docker.com/engine/install/fedora/)
    - **macOS:** قم بتثبيت Docker Desktop عبر [docker.com/products/docker-desktop](https://www.docker.com/products/docker-desktop/)

</details>

## البدء السريع

### الخيار 1: الإعداد الآلي (موصى به)

يقوم نص `bootstrap.sh` بتثبيت Rust ونسخ ZeroClaw وتجميعه وإعداد بيئة التطوير الأولية الخاصة بك:

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

سيقوم هذا بـ:

1. تثبيت Rust (إذا لم يكن موجودًا)
2. نسخ مستودع ZeroClaw
3. تجميع ZeroClaw في وضع الإصدار
4. تثبيت `zeroclaw` في `~/.cargo/bin/`
5. إنشاء هيكل مساحة العمل الافتراضية في `~/.zeroclaw/workspace/`
6. إنشاء ملف تكوين بدء التشغيل `~/.zeroclaw/workspace/config.toml`

بعد التمهيد، أعد تحميل shell الخاص بك أو قم بتشغيل `source ~/.cargo/env` لاستخدام أمر `zeroclaw` عالميًا.

### الخيار 2: التثبيت اليدوي

<details>
<summary><strong>انقر لرؤية خطوات التثبيت اليدوي</strong></summary>

```bash
# 1. نسخ المستودع
git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw

# 2. التجميع في وضع الإصدار
cargo build --release --locked

# 3. تثبيت الملف الثنائي
cargo install --path . --locked

# 4. تهيئة مساحة العمل
zeroclaw init

# 5. التحقق من التثبيت
zeroclaw --version
zeroclaw status
```

</details>

### بعد التثبيت

بمجرد التثبيت (عبر التمهيد أو يدويًا)، يجب أن ترى:

```
~/.zeroclaw/workspace/
├── config.toml          # التكوين الرئيسي
├── .pairing             # أسرار الاقتران (تُنشأ عند التشغيل الأول)
├── logs/                # سجلات البرنامج الخفي/الوكيل
├── skills/              # المهارات المخصصة
└── memory/              # تخزين سياق المحادثة
```

**الخطوات التالية:**

1. قم بتكوين موفري الذكاء الاصطناعي الخاص بك في `~/.zeroclaw/workspace/config.toml`
2. تحقق من [مرجع التكوين](docs/config-reference.md) للخيارات المتقدمة
3. ابدأ الوكيل: `zeroclaw agent start`
4. اختبر عبر قناتك المفضلة (راجع [مرجع القنوات](docs/channels-reference.md))

## التكوين

قم بتحرير `~/.zeroclaw/workspace/config.toml` لتكوين الموفرون والقنوات وسلوك النظام.

### مرجع التكوين السريع

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

[runtime]
kind = "native"    # أو "docker" (يتطلب Docker)
```

**مستندات المرجع الكاملة:**

- [مرجع التكوين](docs/config-reference.md) — جميع الإعدادات والتحقق والقيم الافتراضية
- [مرجع الموفرون](docs/providers-reference.md) — تكوينات محددة لموفري الذكاء الاصطناعي
- [مرجع القنوات](docs/channels-reference.md) — Telegram و Matrix و Slack و Discord والمزيد
- [العمليات](docs/operations-runbook.md) — المراقبة في الإنتاج وتدوير الأسرار والتوسع

### دعم وقت التشغيل الحالي

يدعم ZeroClaw واجهتين خلفيتين لتنفيذ الكود:

- **`native`** (افتراضي) — تنفيذ العملية المباشر، المسار الأسرع، مثالي للبيئات الموثوقة
- **`docker`** — عزل الحاوية الكامل، سياسات الأمان المحصنة، يتطلب Docker

استخدم `runtime.kind = "docker"` إذا كنت بحاجة إلى صندوق رملي صارم أو عزل الشبكة. راجع [مرجع التكوين](docs/config-reference.md#runtime) للتفاصيل الكاملة.

## الأوامر

```bash
# إدارة مساحة العمل
zeroclaw init                # تهيئة مساحة عمل جديدة
zeroclaw status              # عرض حالة البرنامج الخفي/الوكيل
zeroclaw config validate     # التحقق من بنية وقيم config.toml

# إدارة البرنامج الخفي
zeroclaw daemon start        # بدء البرنامج الخفي في الخلفية
zeroclaw daemon stop         # إيقاف البرنامج الخفي قيد التشغيل
zeroclaw daemon restart      # إعادة تشغيل البرنامج الخفي (إعادة تحميل التكوين)
zeroclaw daemon logs         # عرض سجلات البرنامج الخفي

# إدارة الوكيل
zeroclaw agent start         # بدء الوكيل (يتطلب تشغيل البرنامج الخفي)
zeroclaw agent stop          # إيقاف الوكيل
zeroclaw agent restart       # إعادة تشغيل الوكيل (إعادة تحميل التكوين)

# عمليات الاقتران
zeroclaw pairing init        # إنشاء سر اقتران جديد
zeroclaw pairing rotate      # تدوير سر الاقتران الحالي

# الأنفاق (للتعرض العام)
zeroclaw tunnel start        # بدء نفق إلى البرنامج الخفي المحلي
zeroclaw tunnel stop         # إيقاف النفق النشط

# التشخيص
zeroclaw doctor              # تشغيل فحوصات صحة النظام
zeroclaw version             # عرض الإصدار ومعلومات البناء
```

راجع [مرجع الأوامر](docs/commands-reference.md) للخيارات والأمثلة الكاملة.

## البنية

```
┌─────────────────────────────────────────────────────────────────┐
│                        القنوات (سمة)                           │
│  Telegram │ Matrix │ Slack │ Discord │ Web │ CLI │ Custom       │
└─────────────────────────┬───────────────────────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────────────────┐
│                      منسق الوكيل                         │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐          │
│  │   توجيه    │  │   السياق   │  │  التنفيذ  │          │
│  │   الرسائل    │  │   الذاكرة    │  │   الأداة  │          │
│  └──────────────┘  └──────────────┘  └──────────────┘          │
└─────────────────────────┬───────────────────────────────────────┘
                          │
          ┌───────────────┼───────────────┐
          ▼               ▼               ▼
┌──────────────┐  ┌──────────────┐  ┌──────────────┐
│   الموفرون  │  │   الذاكرة    │  │  الأدوات   │
│   (سمة)    │  │   (سمة)    │  │   (سمة)    │
├──────────────┤  ├──────────────┤  ├──────────────┤
│  Anthropic   │  │   Markdown   │  │  Filesystem  │
│   OpenAI     │  │    SQLite    │  │     Bash     │
│   Gemini     │  │     None     │  │   Web Fetch  │
│   Ollama     │  │    Custom    │  │   Custom     │
│   Custom     │  └──────────────┘  └──────────────┘
└──────────────┘
          │
          ▼
┌─────────────────────────────────────────────────────────────────┐
│                   وقت التشغيل (سمة)                               │
│                  Native │ Docker                                 │
└─────────────────────────────────────────────────────────────────┘
```

**المبادئ الأساسية:**

- كل شيء هو **سمة** — الموفرون والقنوات والأدوات والذاكرة والأنفاق
- القنوات تستدعي المنسق؛ المنسق يستدعي الموفرون + الأدوات
- نظام الذاكرة يدير سياق المحادثة (markdown أو SQLite أو لا شيء)
- وقت التشغيل يجرد تنفيذ الكود (أصلي أو Docker)
- لا قفل للمورد — استبدل Anthropic ↔ OpenAI ↔ Gemini ↔ Ollama بدون تغييرات في الكود

راجع [توثيق البنية](docs/architecture.svg) للرسوم البيانية التفصيلية وتفاصيل التنفيذ.

## الأمثلة

### بوت Telegram

```toml
[channels.telegram]
enabled = true
bot_token = "123456:ABC-DEF..."
allowed_users = [987654321]  # معرف مستخدم Telegram الخاص بك
```

ابدأ البرنامج الخفي + الوكيل، ثم أرسل رسالة إلى بوتك على Telegram:

```
/start
مرحباً! هل يمكنك مساعدتي في كتابة نص Python؟
```

يستجيب البوت بكود مُنشأ بالذكاء الاصطناعي، وينفذ الأدوات إذا طُلب، ويحافظ على سياق المحادثة.

### Matrix (تشفير من طرف إلى طرف)

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

ادعُ `@zeroclaw:matrix.org` إلى غرفة مشفرة، وسيستجيب البوت بتشفير كامل. راجع [دليل Matrix E2EE](docs/matrix-e2ee-guide.md) لإعداد التحقق من الجهاز.

### متعدد الموفرون

```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"]  # التبديل عند خطأ المورد
```

إذا فشل Anthropic أو وصل إلى حد السرعة، يتبادل المنسق تلقائيًا إلى OpenAI.

### ذاكرة مخصصة

```toml
[memory]
kind = "sqlite"
path = "~/.zeroclaw/workspace/memory/conversations.db"
retention_days = 90  # حذف تلقائي بعد 90 يومًا
```

أو استخدم Markdown للتخزين القابل للقراءة البشرية:

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

راجع [مرجع التكوين](docs/config-reference.md#memory) لجميع خيارات الذاكرة.

## دعم الموفرون

| المورد       | الحالة      | مفتاح API             | النماذج المثال                                      |
| ----------------- | ----------- | ------------------- | ---------------------------------------------------- |
| **Anthropic**     | ✅ مستقر   | `ANTHROPIC_API_KEY` | `claude-sonnet-4-20250514`, `claude-opus-4-20250514` |
| **OpenAI**        | ✅ مستقر   | `OPENAI_API_KEY`    | `gpt-4o`, `gpt-4o-mini`, `o1`, `o1-mini`             |
| **Google Gemini** | ✅ مستقر   | `GOOGLE_API_KEY`    | `gemini-2.0-flash-exp`, `gemini-exp-1206`            |
| **Ollama**        | ✅ مستقر   | N/A (محلي)         | `llama3.3`, `qwen2.5`, `phi4`                        |
| **Cerebras**      | ✅ مستقر   | `CEREBRAS_API_KEY`  | `llama-3.3-70b`                                      |
| **Groq**          | ✅ مستقر   | `GROQ_API_KEY`      | `llama-3.3-70b-versatile`                            |
| **Mistral**       | 🚧 مخطط | `MISTRAL_API_KEY`   | TBD                                                  |
| **Cohere**        | 🚧 مخطط | `COHERE_API_KEY`    | TBD                                                  |

### نقاط النهاية المخصصة

يدعم ZeroClaw نقاط النهاية المتوافقة مع OpenAI:

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

مثال: استخدم [LiteLLM](https://github.com/BerriAI/litellm) كوكيل للوصول إلى أي LLM عبر واجهة OpenAI.

راجع [مرجع الموفرون](docs/providers-reference.md) لتفاصيل التكوين الكاملة.

## دعم القنوات

| القناة        | الحالة      | المصادقة         | ملاحظات                                                     |
| ------------ | ----------- | ------------------------ | --------------------------------------------------------- |
| **Telegram** | ✅ مستقر   | رمز البوت                | دعم كامل بما في ذلك الملفات والصور والأزرار المضمنة |
| **Matrix**   | ✅ مستقر   | كلمة المرور أو الرمز    | دعم E2EE مع التحقق من الجهاز              |
| **Slack**    | 🚧 مخطط | OAuth أو رمز البوت       | يتطلب الوصول إلى مساحة العمل                                    |
| **Discord**  | 🚧 مخطط | رمز البوت                | يتطلب أذونات النقابة                                |
| **WhatsApp** | 🚧 مخطط | Twilio أو API الرسمية | يتطلب حساب تجاري                                    |
| **CLI**      | ✅ مستقر   | لا شيء                    | واجهة محادثة مباشرة                       |
| **Web**      | 🚧 مخطط | مفتاح API أو OAuth         | واجهة دردشة قائمة على المتصفح                        |

راجع [مرجع القنوات](docs/channels-reference.md) لتعليمات التكوين الكاملة.

## دعم الأدوات

يوفر ZeroClaw أدوات مدمجة لتنفيذ الكود والوصول إلى نظام الملفات واسترجاع الويب:

| الأداة                | الوصف                 | وقت التشغيل المطلوب                |
| -------------------- | --------------------------- | ----------------------------- |
| **bash**             | ينفذ أوامر الصدفة | أصلي أو Docker              |
| **python**           | ينفذ نصوص Python  | Python 3.8+ (أصلي) أو Docker |
| **javascript**       | ينفذ كود Node.js     | Node.js 18+ (أصلي) أو Docker |
| **filesystem_read**  | يقرأ الملفات            | أصلي أو Docker              |
| **filesystem_write** | يكتب الملفات          | أصلي أو Docker              |
| **web_fetch**        | يجلب محتوى الويب     | أصلي أو Docker              |

### أمان التنفيذ

- **وقت التشغيل الأصلي** — يعمل كعملية مستخدم البرنامج الخفي، وصول كامل لنظام الملفات
- **وقت تشغيل Docker** — عزل حاوية كامل، أنظمة ملفات وشبكات منفصلة

قم بتكوين سياسة التنفيذ في `config.toml`:

```toml
[runtime]
kind = "docker"
allowed_tools = ["bash", "python", "filesystem_read"]  # قائمة سماح صريحة
```

راجع [مرجع التكوين](docs/config-reference.md#runtime) لخيارات الأمان الكاملة.

## النشر

### النشر المحلي (التطوير)

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

### نشر الخادم (الإنتاج)

استخدم systemd لإدارة البرنامج الخفي والوكيل كخدمات:

```bash
# تثبيت الملف الثنائي
cargo install --path . --locked

# تكوين مساحة العمل
zeroclaw init

# إنشاء ملفات خدمة systemd
sudo cp deployment/systemd/zeroclaw-daemon.service /etc/systemd/system/
sudo cp deployment/systemd/zeroclaw-agent.service /etc/systemd/system/

# تمكين وبدء الخدمات
sudo systemctl enable zeroclaw-daemon zeroclaw-agent
sudo systemctl start zeroclaw-daemon zeroclaw-agent

# التحقق من الحالة
sudo systemctl status zeroclaw-daemon
sudo systemctl status zeroclaw-agent
```

راجع [دليل نشر الشبكة](docs/network-deployment.md) لتعليمات نشر الإنتاج الكاملة.

### Docker

```bash
# بناء الصورة
docker build -t zeroclaw:latest .

# تشغيل الحاوية
docker run -d \
  --name zeroclaw \
  -v ~/.zeroclaw/workspace:/workspace \
  -e ANTHROPIC_API_KEY=sk-ant-... \
  zeroclaw:latest
```

راجع [`Dockerfile`](Dockerfile) لتفاصيل البناء وخيارات التكوين.

### أجهزة الحافة

تم تصميم ZeroClaw للعمل على أجهزة منخفضة الطاقة:

- **Raspberry Pi Zero 2 W** — ~512 ميغابايت ذاكرة عشوائية، نواة ARMv8 واحدة، < $5 تكلفة الأجهزة
- **Raspberry Pi 4/5** — 1 غيغابايت+ ذاكرة عشوائية، متعدد النوى، مثالي لأحمال العمل المتزامنة
- **Orange Pi Zero 2** — ~512 ميغابايت ذاكرة عشوائية، رباعي النواة ARMv8، تكلفة منخفضة جدًا
- **أجهزة SBCs x86 (Intel N100)** — 4-8 غيغابايت ذاكرة عشوائية، بناء سريع، دعم Docker أصلي

راجع [دليل الأجهزة](docs/hardware/README.md) لتعليمات الإعداد الخاصة بالجهاز.

## الأنفاق (التعرض العام)

اعرض البرنامج الخفي ZeroClaw المحلي الخاص بك للشبكة العامة عبر أنفاق آمنة:

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

موفرو الأنفاق المدعومون:

- **Cloudflare Tunnel** — HTTPS مجاني، لا تعرض للمنافذ، دعم متعدد المجالات
- **Ngrok** — إعداد سريع، مجالات مخصصة (خطة مدفوعة)
- **Tailscale** — شبكة شبكية خاصة، لا منفذ عام

راجع [مرجع التكوين](docs/config-reference.md#tunnel) لخيارات التكوين الكاملة.

## الأمان

ينفذ ZeroClaw طبقات متعددة من الأمان:

### الاقتران

يُنشئ البرنامج الخفي سر اقتران عند التشغيل الأول مخزن في `~/.zeroclaw/workspace/.pairing`. يجب على العملاء (الوكيل، CLI) تقديم هذا السر للاتصال.

```bash
zeroclaw pairing rotate  # يُنشئ سرًا جديدًا ويبطل القديم
```

### الصندوق الرملي

- **وقت تشغيل Docker** — عزل حاوية كامل مع أنظمة ملفات وشبكات منفصلة
- **وقت التشغيل الأصلي** — يعمل كعملية مستخدم، محدد النطاق في مساحة العمل افتراضيًا

### قوائم السماح

يمكن للقنوات تقييد الوصول حسب معرف المستخدم:

```toml
[channels.telegram]
enabled = true
allowed_users = [123456789, 987654321]  # قائمة سماح صريحة
```

### التشفير

- **Matrix E2EE** — تشفير من طرف إلى طرف كامل مع التحقق من الجهاز
- **نقل TLS** — جميع حركة API والنفق تستخدم HTTPS/TLS

راجع [توثيق الأمان](docs/security/README.md) للسياسات والممارسات الكاملة.

## إمكانية الملاحظة

يسجل ZeroClaw في `~/.zeroclaw/workspace/logs/` افتراضيًا. يتم تخزين السجلات حسب المكون:

```
~/.zeroclaw/workspace/logs/
├── daemon.log           # سجلات البرنامج الخفي (بدء التشغيل، طلبات API، الأخطاء)
├── agent.log            # سجلات الوكيل (توجيه الرسائل، تنفيذ الأدوات)
├── telegram.log         # سجلات خاصة بالقناة (إذا مُكنت)
└── matrix.log           # سجلات خاصة بالقناة (إذا مُكنت)
```

### تكوين التسجيل

```toml
[logging]
level = "info"                           # debug، info، warn، error
path = "~/.zeroclaw/workspace/logs/"
rotation = "daily"                       # يومي، ساعي، حجم
max_size_mb = 100                        # للتدوير القائم على الحجم
retention_days = 30                      # حذف تلقائي بعد N يومًا
```

راجع [مرجع التكوين](docs/config-reference.md#logging) لجميع خيارات التسجيل.

### المقاييس (مخطط)

دعم مقاييس Prometheus لمراقبة الإنتاج قريبًا. التتبع في [#234](https://github.com/zeroclaw-labs/zeroclaw/issues/234).

## المهارات

يدعم ZeroClaw المهارات المخصصة — وحدات قابلة لإعادة الاستخدام توسع قدرات النظام.

### تعريف المهارة

يتم تخزين المهارات في `~/.zeroclaw/workspace/skills/<skill-name>/` بهذا الهيكل:

```
skills/
└── my-skill/
    ├── skill.toml       # بيانات المهارة (الاسم، الوصف، التبعيات)
    ├── prompt.md        # موجه النظام للذكاء الاصطناعي
    └── tools/           # أدوات مخصصة اختيارية
        └── my_tool.py
```

### مثال المهارة

```toml
# skills/web-research/skill.toml
[skill]
name = "web-research"
description = "يبحث في الويب ويلخص النتائج"
version = "1.0.0"

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

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

أنت مساعد بحث. عند طلب البحث عن شيء ما:

1. استخدم web_fetch لاسترجاع المحتوى
2. لخص النتائج بتنسيق سهل القراءة
3. استشهد بالمصادر مع عناوين URL
```

### استخدام المهارات

يتم تحميل المهارات تلقائيًا عند بدء تشغيل الوكيل. أشر إليها بالاسم في المحادثات:

```
المستخدم: استخدم مهارة البحث على الويب للعثور على أخبار الذكاء الاصطناعي الأخيرة
البوت: [يحمل مهارة البحث على الويب، ينفذ web_fetch، يلخص النتائج]
```

راجع قسم [المهارات](#المهارات) لتعليمات إنشاء المهارات الكاملة.

## المهارات المفتوحة

يدعم ZeroClaw [Open Skills](https://github.com/openagents-com/open-skills) — نظام معياري ومحايد للمورد لتوسيع قدرات وكلاء الذكاء الاصطناعي.

### تمكين المهارات المفتوحة

```toml
[skills]
open_skills_enabled = true
# open_skills_dir = "/path/to/open-skills"  # اختياري
```

يمكنك أيضًا التجاوز في وقت التشغيل باستخدام `ZEROCLAW_OPEN_SKILLS_ENABLED` و `ZEROCLAW_OPEN_SKILLS_DIR`.

## التطوير

```bash
cargo build              # بناء التطوير
cargo build --release    # بناء الإصدار (codegen-units=1، يعمل على جميع الأجهزة بما في ذلك Raspberry Pi)
cargo build --profile release-fast    # بناء أسرع (codegen-units=8، يتطلب 16 غيغابايت+ ذاكرة عشوائية)
cargo test               # تشغيل مجموعة الاختبار الكاملة
cargo clippy --locked --all-targets -- -D clippy::correctness
cargo fmt                # تنسيق

# تشغيل معيار مقارنة SQLite مقابل Markdown
cargo test --test memory_comparison -- --nocapture
```

### خطاف ما قبل الدفع

يقوم خطاف git بتشغيل `cargo fmt --check` و `cargo clippy -- -D warnings` و `cargo test` قبل كل دفع. قم بتمكينه مرة واحدة:

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

### استكشاف أخطاء البناء وإصلاحها (أخطاء OpenSSL على Linux)

إذا واجهت خطأ بناء `openssl-sys`، قم بمزامنة التبعيات وأعد التجميع باستخدام ملف قفل المستودع:

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

تم تكوين ZeroClaw لاستخدام `rustls` لتبعيات HTTP/TLS؛ `--locked` يحافظ على الرسم البياني العابر حتمي في البيئات النظيفة.

لتخطي الخطاف عندما تحتاج إلى دفع سريع أثناء التطوير:

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

## التعاون والتوثيق

ابدأ بمركز التوثيق لخريطة قائمة على المهام:

- مركز التوثيق: [`docs/README.md`](docs/README.md)
- فهرس التوثيق الموحد: [`docs/SUMMARY.md`](docs/SUMMARY.md)
- مرجع الأوامر: [`docs/commands-reference.md`](docs/commands-reference.md)
- مرجع التكوين: [`docs/config-reference.md`](docs/config-reference.md)
- مرجع الموفرون: [`docs/providers-reference.md`](docs/providers-reference.md)
- مرجع القنوات: [`docs/channels-reference.md`](docs/channels-reference.md)
- دليل العمليات: [`docs/operations-runbook.md`](docs/operations-runbook.md)
- استكشاف الأخطاء: [`docs/troubleshooting.md`](docs/troubleshooting.md)
- مخزون/تصنيف التوثيق: [`docs/docs-inventory.md`](docs/docs-inventory.md)
- لقطة فرز PR/المشكلة (اعتبارًا من 18 فبراير 2026): [`docs/project-triage-snapshot-2026-02-18.md`](docs/project-triage-snapshot-2026-02-18.md)

مراجع التعاون الرئيسية:

- مركز التوثيق: [docs/README.md](docs/README.md)
- قالب التوثيق: [docs/doc-template.md](docs/doc-template.md)
- قائمة تغيير التوثيق: [docs/README.md#4-documentation-change-checklist](docs/README.md#4-documentation-change-checklist)
- مرجع تكوين القنوات: [docs/channels-reference.md](docs/channels-reference.md)
- عمليات غرف Matrix المشفرة: [docs/matrix-e2ee-guide.md](docs/matrix-e2ee-guide.md)
- دليل المساهمة: [CONTRIBUTING.md](CONTRIBUTING.md)
- سياسة سير عمل PR: [docs/pr-workflow.md](docs/pr-workflow.md)
- دليل المراجع (الفرز + المراجعة العميقة): [docs/reviewer-playbook.md](docs/reviewer-playbook.md)
- خريطة الملكية وفرز CI: [docs/ci-map.md](docs/ci-map.md)
- سياسة الإفصاح الأمني: [SECURITY.md](SECURITY.md)

للنشر وعمليات وقت التشغيل:

- دليل نشر الشبكة: [docs/network-deployment.md](docs/network-deployment.md)
- دليل وكيل الوكيل: [docs/proxy-agent-playbook.md](docs/proxy-agent-playbook.md)

## دعم ZeroClaw

إذا كان ZeroClaw يساعد عملك وترغب في دعم التطوير المستمر، يمكنك التبرع هنا:

<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="اشترِ لي قهوة" /></a>

### 🙏 شكر خاص

شكر خالص للمجتمعات والمؤسسات التي تلهم وتغذي هذا العمل مفتوح المصدر:

- **جامعة هارفارد** — لتعزيز الفضول الفكري ودفع حدود ما هو ممكن.
- **MIT** — للدفاع عن المعرفة المفتوحة والمصدر المفتوح والاعتقاد بأن التكنولوجيا يجب أن تكون متاحة للجميع.
- **Sundai Club** — للمجتمع والطاقة والإرادة الدؤوبة لبناء أشياء مهمة.
- **العالم وما بعده** 🌍✨ — لكل مساهم وحالم وباني هناك يجعل المصدر المفتوح قوة للخير. هذا من أجلك.

نحن نبني في المصدر المفتوح لأن أفضل الأفكار تأتي من كل مكان. إذا كنت تقرأ هذا، فأنت جزء منه. مرحبًا. 🦀❤️

## ⚠️ المستودع الرسمي وتحذير الانتحال

**هذا هو مستودع ZeroClaw الرسمي الوحيد:**

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

أي مستودع أو منظمة أو نطاق أو حزمة آخر يدعي أنه "ZeroClaw" أو يلمح إلى الارتباط بـ ZeroClaw Labs هو **غير مصرح به وغير مرتبط بهذا المشروع**. سيتم إدراج الفروع غير المصرح بها المعروفة في [TRADEMARK.md](TRADEMARK.md).

إذا واجهت انتحالًا أو سوء استخدام للعلامة التجارية، يرجى [فتح مشكلة](https://github.com/zeroclaw-labs/zeroclaw/issues).

---

## الترخيص

ZeroClaw مرخص بشكل مزدوج لأقصى قدر من الانفتاح وحماية المساهمين:

| الترخيص                      | حالات الاستخدام                                            |
| ---------------------------- | ------------------------------------------------------------ |
| [MIT](LICENSE-MIT)               | مفتوح المصدر، البحث، الأكاديمي، الاستخدام الشخصي          |
| [Apache 2.0](LICENSE-APACHE) | حماية براءات الاختراع، المؤسسي، النشر التجاري |

يمكنك اختيار أي من الترخيصين. **يمنح المساهمون تلقائيًا حقوقًا بموجب كليهما** — راجع [CLA.md](CLA.md) لاتفاقية المساهم الكاملة.

### العلامة التجارية

اسم **ZeroClaw** والشعار علامتان تجاريتان مسجلتان لـ ZeroClaw Labs. لا يمنح هذا الترخيص الإذن باستخدامهما للإيحاء بالموافقة أو الارتباط. راجع [TRADEMARK.md](TRADEMARK.md) للاستخدامات المسموح بها والمحظورة.

### حماية المساهمين

- **تحتفظ بحقوق النشر** لمساهماتك
- **منح براءة الاختراع** (Apache 2.0) يحميك من مطالبات براءات الاختراع من مساهمين آخرين
- يتم **نسب مساهماتك بشكل دائم** في تاريخ الالتزامات و [NOTICE](NOTICE)
- لا يتم نقل حقوق العلامة التجارية من خلال المساهمة

## المساهمة

راجع [CONTRIBUTING.md](CONTRIBUTING.md) و [CLA.md](CLA.md). قم بتنفيذ سمة، أرسل PR:

- دليل سير عمل CI: [docs/ci-map.md](docs/ci-map.md)
- `Provider` جديد ← `src/providers/`
- `Channel` جديد ← `src/channels/`
- `Observer` جديد ← `src/observability/`
- `Tool` جديد ← `src/tools/`
- `Memory` جديدة ← `src/memory/`
- `Tunnel` جديد ← `src/tunnel/`
- `Skill` جديدة ← `~/.zeroclaw/workspace/skills/<n>/`

---

**ZeroClaw** — صفر عبء. صفر تنازلات. انشر في أي مكان. استبدل أي شيء. 🦀

## تاريخ النجوم

<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="رسم بياني لتاريخ النجوم" src="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&legend=top-left" />
    </picture>
  </a>
</p>
