---
title: 'دليل OpenClaw 2026: التثبيت، المهارات، Canvas، الاستضافة الذاتية'
description: 'دليل OpenClaw الشامل لـ 2026: التثبيت على Windows/Mac/Linux/Docker، وصل 20+ قناة مراسلة، استخدام 13,700+ مهارة ClawHub، واستضافة ذاتية على VPS.'
url: https://nerdleveltech.com/ar/guides/openclaw-personal-ai-assistant
language: ar
last_updated: '2026-03-30'
category: ai-ml
reading_time_minutes: 60
author: NerdLevelTech
keywords:
  - OpenClaw
  - Clawdbot
  - مساعد ذكي مستضاف ذاتياً
  - وكيل ذكاء اصطناعي شخصي
  - مهارات OpenClaw
  - ClawHub
  - أتمتة الذكاء الاصطناعي
  - بوت واتساب ذكي
  - مساعد ذكاء اصطناعي مفتوح المصدر
  - إعداد OpenClaw
markdown_url: https://nerdleveltech.com/ar/guides/openclaw-personal-ai-assistant.md
attribution: 'Source: NerdLevelTech — https://nerdleveltech.com/ar/guides/openclaw-personal-ai-assistant'
terms: https://nerdleveltech.com/llms.txt
---

# دليل OpenClaw 2026: التثبيت، المهارات، Canvas، الاستضافة الذاتية

*آخر تحديث: 2026-03-30 | OpenClaw v2026.3.28 | Node.js 22.14+ | رخصة MIT*

OpenClaw هو مساعد ذكاء اصطناعي شخصي مجاني ومفتوح المصدر ومستضاف ذاتياً مع أكثر من 335,000 نجمة على GitHub، يعمل على أجهزتك الخاصة، يتصل بأكثر من 20 منصة مراسلة أصلياً، وينفذ مهام حقيقية — أوامر الطرفية، أتمتة المتصفح، إدارة الملفات، وسير العمل المجدولة — باستخدام أي نموذج لغة كبير تختاره، مع أكثر من 13,700 مهارة مجتمعية على ClawHub.

> **ملاحظة الإصدار:** يغطي هذا الدليل OpenClaw v2026.3.28 (مارس 2026). تجاوز المشروع React كأكثر مشروع برمجي حصولاً على النجوم على GitHub في 60 يوماً وهو تحت تطوير نشط. تحقق دائماً من [docs.openclaw.ai](https://docs.openclaw.ai) لأحدث التوثيق.

## ما هو OpenClaw ولماذا هو مهم

**OpenClaw** هو مساعد ذكاء اصطناعي شخصي مجاني ومفتوح المصدر ومستضاف ذاتياً يعمل على أجهزتك الخاصة. على عكس المساعدين السحابيين مثل ChatGPT أو واجهة Claude على الويب، يحافظ OpenClaw على بياناتك محلياً ويتصل بمنصات المراسلة التي تستخدمها بالفعل — واتساب، تيليجرام، سلاك، ديسكورد، والمزيد.

لكن OpenClaw ليس مجرد روبوت دردشة. إنه **منصة وكيل ذكاء اصطناعي** — يمكنه تنفيذ مهام حقيقية على حاسوبك:

- تشغيل أوامر الطرفية والسكريبتات
- قراءة وكتابة وتعديل الملفات على نظام ملفاتك
- التحكم بالمتصفح (التنقل، النقر، ملء النماذج، لقطات الشاشة)
- جدولة مهام cron والاستجابة لـ webhooks
- إدارة البريد الإلكتروني والتقويمات وسير العمل
- عرض محتوى مرئي تفاعلي عبر Canvas (بروتوكول A2UI)
- البحث في الويب مع Exa و Tavily و Firecrawl المدمجة (جديد في v2026.3.22)
- أتمتة أي شيء يمكنك وصفه بلغة طبيعية

### إحصائيات رئيسية (مارس 2026)

| المقياس | القيمة |
|---------|--------|
| نجوم GitHub | أكثر من 335,000 (تجاوز رقم React القياسي الذي استغرق 10 سنوات في 60 يوماً)[^2][^4] |
| المساهمون | أكثر من 1,100 |
| الفروع (Forks) | أكثر من 57,000 |
| مهارات ClawHub | أكثر من 13,729 مهارة مجتمعية[^3] |
| قنوات المراسلة | 20+ أصلية، إضافات مجتمعية متاحة |
| الرخصة | MIT — مجاني ومفتوح المصدر بالكامل |
| أحدث إصدار | v2026.3.28 |

---

## تاريخ الإصدارات: من Clawdbot إلى OpenClaw

يحمل OpenClaw ما قد يكون أسرع ثلاث إعادات تسمية في تاريخ المصدر المفتوح:

| التاريخ | الاسم | الحدث |
|---------|-------|-------|
| نوفمبر 2025 | **Clawdbot** | أنشأه Peter Steinberger (مؤسس PSPDFKit). تورية على "Claude" مع تميمة جراد البحر |
| أواخر يناير 2026 | — | انتشر بشكل فيروسي — 60,000 نجمة على GitHub في 72 ساعة |
| 27 يناير 2026 | **Moltbot** | أُعيد تسميته بعد أن أشار فريق Anthropic القانوني إلى تشابه العلامة التجارية مع "Claude" |
| 29 يناير 2026 | **OpenClaw** | الاسم النهائي — "Moltbot" لم ينجح، ومحتالو العملات المشفرة اختطفوا الحسابات القديمة |
| 14 فبراير 2026 | — | أعلن Steinberger انضمامه لـ OpenAI؛ المشروع ينتقل إلى مؤسسة مفتوحة المصدر[^9] |
| 3 مارس 2026 | — | تجاوز React عند 250,829 نجمة — أكثر مشروع برمجي حصولاً على النجوم على GitHub |
| 23 مارس 2026 | **v2026.3.22** | إصدار رئيسي: أكثر من 45 ميزة جديدة، 13 تغييراً جذرياً، 82 إصلاح خطأ، أكثر من 20 تصحيحاً أمنياً[^5] |

### تنبيه تغيير جذري (v2026.3.22)

تم إزالة جميع المتغيرات البيئية ذات البادئة `CLAWDBOT_*` و `MOLTBOT_*`. إذا كان ملف `.env` الخاص بك لا يزال يستخدمها، سيفشل الوكيل في البدء. استبدلها بمكافئات `OPENCLAW_*`.

---

## البنية: كيف يعمل OpenClaw

يستخدم OpenClaw **بنية البوابة (Gateway)** — مستوى تحكم محلي قائم على WebSocket ينسق كل شيء:

```
┌──────────────────────────────────────────────────────┐
│                     البوابة (Gateway)                  │
│               ws://127.0.0.1:18789                    │
│                                                       │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌─────────┐ │
│  │ الجلسات  │ │ القنوات  │ │ الأدوات  │ │ Canvas  │ │
│  └──────────┘ └──────────┘ └──────────┘ └─────────┘ │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌─────────┐ │
│  │ الأحداث │ │  Cron    │ │ المهارات │ │ المتصفح │ │
│  └──────────┘ └──────────┘ └──────────┘ └─────────┘ │
└───────┬──────────┬───────────┬───────────┬───────────┘
        │          │           │           │
   ┌────▼────┐ ┌──▼────┐ ┌───▼──────┐ ┌──▼─────┐
   │واتساب  │ │ سلاك │ │ ديسكورد │ │ WebChat│ ...20+ قناة
   └─────────┘ └───────┘ └──────────┘ └────────┘
        │          │           │           │
   ┌────▼──────────▼───────────▼───────────▼────┐
   │          مزود نموذج الذكاء الاصطناعي        │
   │  Claude / GPT-4o / Gemini / Ollama (محلي)   │
   └─────────────────────────────────────────────┘
```

### المكونات الرئيسية

| المكون | ما يفعله |
|--------|----------|
| **البوابة (Gateway)** | الدماغ — يدير الجلسات، يوجه الرسائل، ينسق الأدوات، يخدم واجهة التحكم |
| **القنوات** | موصلات لأكثر من 20 منصة مراسلة (أصلية) |
| **بيئة تشغيل الوكيل** | محرك الاستدلال الذكي — يتحدث مع نموذج اللغة الكبير الذي اخترته |
| **الأدوات** | قدرات مدمجة: الطرفية، نظام الملفات، التحكم بالمتصفح، cron، webhooks |
| **المهارات** | ملفات SKILL.md من ClawHub أو مخصصة توسع قدرات الوكيل |
| **العقد (Nodes)** | تطبيقات مصاحبة (macOS، iOS، Android) توفر قدرات الجهاز (الكاميرا، الشاشة، الموقع، الإشعارات) |
| **Canvas** | مساحة عمل مرئية يقودها الوكيل لعرض واجهات مستخدم تفاعلية (بروتوكول A2UI) |

### المكدس التقني

- **اللغة:** TypeScript
- **بيئة التشغيل:** Node.js 22.14+
- **مدير الحزم:** pnpm (مُفضّل) أو npm. Bun تجريبي — غير موصى به لقنوات WhatsApp/Telegram
- **أتمتة المتصفح:** Chrome/Chromium مُدار عبر OpenClaw عبر CDP
- **Canvas:** بروتوكول A2UI v0.8 عبر WebKit/WebView
- **الرخصة:** MIT — مجاني ومفتوح المصدر بالكامل

---

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

### المتطلبات المسبقة

- **Node.js 22 أو أحدث** (تحقق: `node --version`)
- macOS، Linux، أو Windows (انظر قسم Windows أدناه للتفاصيل)

### التثبيت السريع

**macOS / Linux:**

```bash
curl -fsSL https://openclaw.ai/install.sh | bash
```

**Windows (PowerShell — تشغيل كمسؤول):**

```powershell
iwr -useb https://openclaw.ai/install.ps1 | iex
```

**أو عبر npm/pnpm:**

```bash
npm install -g openclaw@latest
# أو
pnpm add -g openclaw@latest
```

### الإعداد الأولي

بعد التثبيت، شغّل معالج الإعداد التفاعلي:

```bash
openclaw onboard --install-daemon
```

يرشدك خلال:
1. **النموذج/المصادقة** — اختر مزوداً (Anthropic، OpenAI، إلخ) والصق مفتاح API
2. **البحث في الويب** — تكوين مزود بحث اختياري (Perplexity، Brave، إلخ)
3. **مساحة العمل** — تحديد موقع ملفات الوكيل (افتراضي `~/.openclaw/workspace`)
4. **البوابة** — المنفذ، عنوان الربط، وضع المصادقة
5. **القنوات** — ربط أول منصة مراسلة (واتساب، تيليجرام، إلخ)
6. **الخدمة** — تثبيت كـ LaunchAgent (macOS) أو خدمة systemd (Linux)
7. **فحص الصحة** — التحقق من بدء البوابة بنجاح
8. **المهارات** — تثبيت المهارات الموصى بها والتبعيات الاختيارية

### التحقق من التثبيت

```bash
# التحقق من حالة البوابة
openclaw gateway status

# فتح واجهة التحكم في المتصفح
openclaw dashboard
# يفتح http://127.0.0.1:18789/

# التحقق من الإصدار
openclaw --version
```

### التكوين

ملف التكوين الرئيسي في `~/.openclaw/openclaw.json`:

```json5
{
  agents: {
    defaults: {
      model: {
        primary: "anthropic/claude-opus-4-6"  // النموذج الموصى به لأفضل النتائج
      }
    }
  },
  gateway: {
    port: 18789
  }
}
```

**استخدام نماذج محلية (بدون اتصال بالإنترنت بالكامل):**

```json5
{
  agents: {
    defaults: {
      model: {
        primary: "ollama/llama3.1:70b"  // خصوصية تامة — بدون استدعاءات API سحابية
      }
    }
  }
}
```

### من المصدر (للتطوير)

```bash
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
pnpm openclaw onboard --install-daemon

# وضع التطوير مع إعادة التحميل التلقائي:
pnpm gateway:watch
```

---

## التثبيت على Windows (PowerShell، WSL2، Docker)

لدى Windows ثلاث طرق للتثبيت، كل منها بمزايا مختلفة:

### الطريقة 1: أمر PowerShell الواحد (الأسرع)

```powershell
# تشغيل PowerShell كمسؤول
iwr -useb https://openclaw.ai/install.ps1 | iex
```

**المتطلبات:**
- Windows 10 Build 19041+ أو Windows 11
- Node.js 22.14+ مثبت ([nodejs.org](https://nodejs.org))
- 4 جيجابايت ذاكرة كحد أدنى (يُوصى بـ 8 جيجابايت)

**ماذا يفعل السكريبت:**
1. يتحقق من وجود Node.js و npm
2. يثبت OpenClaw عالمياً عبر npm
3. يسجل اختيارياً مهمة مجدولة في Windows للبدء التلقائي

**ملاحظة أمنية:** تم الكشف عن ثغرة حقن أوامر في آلية البدء التلقائي لمهام Windows المجدولة في 19 مارس 2026، تؤثر على جميع الإصدارات قبل v2026.2.25. شغّل دائماً `openclaw --version` وحدّث إذا كنت أقل من v2026.2.25.

### الطريقة 2: WSL2 + مثبت Linux (الموصى بها للتطوير)

يوفر WSL2 بيئة Linux كاملة، مما يتجنب المشاكل الخاصة بـ Windows:

```powershell
# 1. تثبيت WSL2 (إن لم يكن موجوداً)
wsl --install

# 2. فتح طرفية WSL، ثم تثبيت OpenClaw بطريقة Linux
curl -fsSL https://openclaw.ai/install.sh | bash

# 3. تشغيل الإعداد الأولي
openclaw onboard --install-daemon
```

هذا النهج موصى به للمطورين لأن:
- توافق كامل مع Linux — بدون مشاكل ترجمة المسارات
- أداء أفضل لنظام الملفات مع Node.js
- تكامل Docker يعمل بسلاسة
- المهارات التي تستخدم أوامر الطرفية تعمل كما هو موثق

### الطريقة 3: Docker Desktop (الأفضل للعزل)

```powershell
# سحب وتشغيل صورة Docker الرسمية
docker run -d `
  --name openclaw `
  -p 18789:18789 `
  -v ${env:USERPROFILE}\.openclaw:/root/.openclaw `
  ghcr.io/openclaw/openclaw:latest
```

```yaml
# docker-compose.yml
services:
  openclaw:
    image: ghcr.io/openclaw/openclaw:latest
    ports:
      - "18789:18789"
    volumes:
      - ~/.openclaw:/root/.openclaw
    restart: unless-stopped
```

### مقارنة طرق تثبيت Windows

| الطريقة | وقت الإعداد | ملائمة للتطوير | العزل | توافق الطرفية |
|---------|------------|----------------|-------|---------------|
| PowerShell | دقيقتان | متوسطة | بدون | PowerShell فقط |
| WSL2 | 10 دقائق | عالية | جزئي | Linux كامل |
| Docker | 5 دقائق | متوسطة | كامل | Linux كامل (في الحاوية) |

---

## مرجع المتغيرات البيئية

يستخدم OpenClaw متغيرات بيئية للتكوين. فهمها ضروري للنشر المخصص وإعدادات Docker وتكوينات الملفات المتعددة.

### المتغيرات البيئية الأساسية

| المتغير | الافتراضي | الغرض |
|---------|----------|-------|
| `OPENCLAW_HOME` | `$HOME` | يستبدل دليل النظام الرئيسي لجميع دقة المسارات الداخلية. يمكّن العزل الكامل لنظام الملفات لحسابات الخدمة |
| `OPENCLAW_STATE_DIR` | `~/.openclaw` | يتجاوز دليل الحالة حيث يخزن OpenClaw التكوين والسجلات والذاكرة والمهارات |
| `OPENCLAW_CONFIG_PATH` | `~/.openclaw/openclaw.json` | يشير إلى ملف تكوين محدد. مفيد لتشغيل تكوينات متعددة |
| `OPENCLAW_CONTAINER` | غير محدد | عند التعيين، ينفذ أوامر OpenClaw داخل حاوية Docker/Podman قيد التشغيل (جديد في v2026.3.22) |

### ترتيب التحميل (قاعدة "عدم التجاوز")

يحمّل OpenClaw المتغيرات البيئية من مصادر متعددة بترتيب صارم. **القيمة الأولى المكتشفة تفوز** — المصادر اللاحقة لا تتجاوز أبداً السابقة:

```
1. بيئة العملية (مثل: OPENCLAW_STATE_DIR=/custom openclaw gateway)
2. ملف .env في دليل العمل الحالي
3. ملف .env العام في ~/.openclaw/.env (أي $OPENCLAW_STATE_DIR/.env)
4. كتلة env في التكوين في ~/.openclaw/openclaw.json
5. استيراد اختياري من login-shell
```

هذا يعني:
- المتغير المُعيّن في الطرفية له الأولوية دائماً
- ملف `.env` في دليل مشروعك يتجاوز التكوين العام
- ملف `.env` العام يتجاوز تكوين JSON

### أولوية OPENCLAW_HOME

```
OPENCLAW_HOME > $HOME > USERPROFILE > os.homedir()
```

يمكن تعيين `OPENCLAW_HOME` لمسار بعلامة التلدة (مثل `~/svc`)، والذي يتم توسيعه باستخدام `$HOME` قبل الاستخدام.

### عزل الملفات الشخصية (Profile)

شغّل عدة نسخ مستقلة من OpenClaw مع `--profile`:

```bash
# المساعد الشخصي
openclaw --profile personal gateway

# مساعد العمل (حالة منفصلة تماماً)
openclaw --profile work gateway
```

كل ملف شخصي يحصل على دليل حالة معزول خاص به، مما يمنع التداخل بين السياقات الشخصية والمهنية.

### مثال Docker مع المتغيرات البيئية

```yaml
# docker-compose.yml مع متغيرات بيئية مخصصة
services:
  openclaw:
    image: ghcr.io/openclaw/openclaw:latest
    ports:
      - "18789:18789"
    environment:
      - OPENCLAW_STATE_DIR=/data/openclaw
      - OPENCLAW_HOME=/home/openclaw
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
    volumes:
      - openclaw-data:/data/openclaw
    restart: unless-stopped

volumes:
  openclaw-data:
```

### الترحيل من متغيرات CLAWDBOT_*/MOLTBOT_*

اعتباراً من v2026.3.22، تم إزالة جميع البادئات القديمة. حدّث ملفات `.env`:

```bash
# قديم (سيفشل في البدء)
CLAWDBOT_STATE_DIR=/custom/path
MOLTBOT_HOME=/home/user

# جديد (مطلوب)
OPENCLAW_STATE_DIR=/custom/path
OPENCLAW_HOME=/home/user
```

---

## مزودو نماذج الذكاء الاصطناعي والتكوين

يعمل OpenClaw مع أكثر من 20 مزوداً للذكاء الاصطناعي. يمكنك استخدام واجهات API سحابية أو نماذج محلية أو مزج الاثنين لوكلاء مختلفين.

### أولوية المزود (الاكتشاف التلقائي)

عند تكوين مفاتيح API متعددة، يختار OpenClaw مزوداً بهذا الترتيب[^6]:

```
Anthropic > OpenAI > OpenRouter > Gemini > OpenCode > GitHub Copilot >
xAI > Groq > Mistral > Cerebras > Venice > Moonshot > Kimi > MiniMax >
Synthetic > ZAI > AI Gateway > Xiaomi > Bedrock > Ollama
```

### النماذج الموصى بها حسب حالة الاستخدام

| حالة الاستخدام | النموذج | السبب |
|---------------|---------|-------|
| مساعد عام | Claude Opus 4.8 | أفضل استدلال واستخدام أدوات واتباع تعليمات |
| اقتصادي | Claude Haiku 4.5 | سريع ورخيص وجيد للمهام البسيطة |
| توليد الكود | GPT-4o أو Claude Sonnet 4.6 | كود قوي مع استجابة سريعة |
| خصوصية تامة | Ollama (Llama 3.1 70B) | لا تغادر أي بيانات جهازك |
| مهام الاستدلال | OpenAI o1 | سلسلة أفكار للمشاكل المعقدة |
| استجابات سريعة | Gemini 2.5 Flash | زمن استجابة منخفض للاستخدام التفاعلي |

### تكوين نموذج لكل وكيل

وجّه مهام مختلفة لنماذج مختلفة لتحسين التكلفة والجودة:

```json5
{
  agents: {
    list: [
      { id: "personal", default: true, model: { primary: "anthropic/claude-opus-4-6" } },
      { id: "work", model: { primary: "anthropic/claude-sonnet-4-6" } },
      { id: "quick", model: { primary: "anthropic/claude-haiku-4-5" } },
      { id: "private", model: { primary: "ollama/llama3.1:70b" } }
    ]
  },
  bindings: [
    { agentId: "personal", match: { channel: "whatsapp" } },
    { agentId: "work", match: { channel: "slack" } },
    { agentId: "private", match: { channel: "matrix" } }
  ]
}
```

### النماذج المحلية مع Ollama

يتم اكتشاف Ollama تلقائياً على `http://127.0.0.1:11434` عند تفعيله بـ `OLLAMA_API_KEY`:

```bash
# تثبيت Ollama (macOS/Linux)
curl -fsSL https://ollama.com/install.sh | sh

# سحب نموذج
ollama pull llama3.1:70b

# تعيين المتغير البيئي لتفعيل Ollama في OpenClaw
export OLLAMA_API_KEY=ollama
```

### وكلاء مزودين مخصصين

أضف وكلاء متوافقة مع OpenAI/Anthropic عبر `models.providers`:

```json5
{
  models: {
    providers: {
      "my-proxy": {
        baseUrl: "https://my-llm-proxy.internal/v1",
        apiKey: "${MY_PROXY_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "my-model",
            name: "My Custom Model",
            contextWindow: 32000,
            maxTokens: 32000
          }
        ]
      }
    }
  }
}
```

ملاحظة: حقل `id` يجب أن يطابق تماماً ما يتوقعه API المزود. حقل `api` يحدد وضع التوافق (`"openai-completions"` أو `"anthropic-messages"`).

---

## ربط قنوات المراسلة (20+ قناة أصلية)

يتضمن OpenClaw أكثر من 20 إضافة قناة مراسلة أصلية، مع قنوات إضافية متاحة عبر إضافات المجتمع. إليك الأكثر شيوعاً:

| القناة | SDK/البروتوكول | ملاحظات |
|--------|--------------|---------|
| **واتساب** | Baileys | القناة الأكثر شعبية. يستخدم بروتوكول WhatsApp Web |
| **تيليجرام** | grammY | واجهة Bot API. أنشئ بوت عبر @BotFather |
| **سلاك** | Bolt | تكامل تطبيق مساحة العمل |
| **ديسكورد** | discord.js | حساب بوت في خوادمك |
| **Google Chat** | Official API | تكامل مساحة العمل |
| **سيجنال** | signal-cli | يركز على الخصوصية. يتطلب جهاز مرتبط |
| **BlueBubbles** | BlueBubbles API | iMessage على أجهزة غير Apple |
| **iMessage** | Legacy bridge | macOS فقط |
| **Microsoft Teams** | Bot Framework | تكامل المؤسسات |
| **Matrix** | matrix-js-sdk | **إضافة رسمية جديدة (v2026.3.22)** — محادثات البوت، بوابة الإشارات، دردشة بوت-لبوت، شبكات خاصة |
| **IRC** | بروتوكول IRC | شبكات الدردشة الكلاسيكية |
| **Feishu** | Feishu API | شائع في الصين (Lark) |
| **LINE** | LINE API | شائع في اليابان/جنوب شرق آسيا |
| **Mattermost** | Mattermost API | بديل سلاك مستضاف ذاتياً |
| **Nextcloud Talk** | NC Talk API | تواصل مستضاف ذاتياً |
| **Nostr** | بروتوكول Nostr | اجتماعي لامركزي |
| **Twitch** | IRC (إضافة منفصلة) | دردشة منصة البث — غير مدمجة مع النواة |
| **Zalo** | Zalo API | شائع في فيتنام |
| **WeChat** | WeChat API | شائع في الصين |
| **WebChat** | مدمج | واجهة متصفح احتياطية، متاحة دائماً |

*بالإضافة إلى أكثر من 30 قناة إضافية. القائمة الكاملة على [docs.openclaw.ai/channels](https://docs.openclaw.ai).*

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

اربط قنوات متعددة في وقت واحد، كل منها يوجه لتكوين وكيل مختلف باستخدام نظام `bindings`:

```json5
{
  agents: {
    list: [
      { id: "home", default: true, workspace: "~/.openclaw/workspace-home" },
      { id: "work", workspace: "~/.openclaw/workspace-work" },
      { id: "private", model: { primary: "ollama/llama3.1:70b" } }
    ]
  },
  channels: {
    whatsapp: { allowFrom: ["+15555550123"] },
    slack: {},
    matrix: {}
  },
  bindings: [
    { agentId: "home", match: { channel: "whatsapp" } },
    { agentId: "work", match: { channel: "slack" } },
    { agentId: "private", match: { channel: "matrix" } }
  ]
}
```

---

## المهارات وClawHub: أكثر من 13,700 مهارة مجتمعية

### ما هي المهارات؟

المهارة هي مجلد يحتوي على ملف **SKILL.md** — مستند Markdown يعلّم وكيل الذكاء الاصطناعي كيفية أداء مهمة معينة. لا حاجة لـ SDK أو تجميع أو بيئة تشغيل خاصة. فقط YAML frontmatter مع تعليمات Markdown. المهارات تعيش في `~/.openclaw/skills/` (مُدارة) أو `<project>/skills/` (نطاق مساحة العمل).

### ClawHub — سجل المهارات

**ClawHub** ([clawhub.ai](https://clawhub.ai)) هو دليل مهارات المجتمع مع **أكثر من 13,729 مهارة**[^3] عبر فئات:

- **الإنتاجية** — إدارة البريد الإلكتروني، أتمتة التقويم، تدوين الملاحظات
- **DevOps** — عمليات Git، CI/CD، مراقبة الخوادم، النشر
- **المالية** — تتبع النفقات، أتمتة التداول، إدارة المحافظ
- **إنشاء المحتوى** — إعادة استخدام المحتوى عبر المنصات، كتابة المدونات، توليد الصور
- **أتمتة المنزل** — التحكم بإنترنت الأشياء، روتينات المنزل الذكي
- **التواصل** — ردود تلقائية، جدولة الرسائل، الترجمة
- **التطوير** — مراجعة الكود، التوثيق، المساعدة في التصحيح
- **البيانات** — كشط الويب، تحليل البيانات، توليد التقارير
- **Canvas OS** — تطبيقات لوحة تحكم تفاعلية، نماذج أولية، تصورات بيانات

### تثبيت المهارات

ثبّت المهارات من ClawHub أو أدرها عبر سطر الأوامر:

```bash
# التثبيت من ClawHub
clawhub install daily-standup

# عرض المهارات المثبتة
openclaw skills list

# إزالة مهارة
openclaw skills remove daily-standup

# تحديث جميع المهارات المثبتة
openclaw skills update --all

# عرض الأدوات المتاحة (أمر شرطة في الدردشة)
# /tools
```

### كتابة مهارة Markdown

أبسط مهارة هي مجرد ملف Markdown بتعليمات:

```markdown
---
name: daily-standup
description: توليد تحديث يومي من التزامات git
---

# مولد التحديث اليومي

انظر في سجل git لآخر 24 ساعة في دليل المشروع الحالي.
لخّص ما تم إنجازه، وما هو قيد التقدم، وأي عوائق.

نسّق الناتج كالتالي:

**تم:**
- [العناصر المكتملة]

**قيد التقدم:**
- [العمل الحالي]

**العوائق:**
- [أي مشاكل]
```

### المهارات المتقدمة: الإضافات بـ TypeScript

للتكاملات المعقدة التي تتجاوز ما يمكن لمهارات Markdown فعله، يدعم OpenClaw **الإضافات (Plugins)** — وحدات TypeScript تسجل المزودين والأدوات والخطافات والقنوات عبر `OpenClawPluginApi`:

```typescript
// الإضافة تسجل القدرات عبر الـ API
export function register(api: OpenClawPluginApi) {
  // تسجيل أداة مخصصة يمكن للوكيل استخدامها
  api.registerTool({
    name: "price-checker",
    description: "مقارنة الأسعار عبر مواقع التسوق",
    // الوكيل يستدعي هذه الأداة عبر اللغة الطبيعية
  });

  // تسجيل خطافات لأحداث النظام
  api.registerHook("onMessage", async (message) => {
    // منطق مخصص لكل رسالة واردة
  });
}
```

أنشئ مشروع مهارة جديد مع:

```bash
openclaw skills create my-awesome-skill
cd my-awesome-skill
npm run dev
```

معظم حالات الاستخدام تُخدم بشكل أفضل بواسطة **مهارات Markdown** (ملفات SKILL.md تُحقن في أمر النظام) بدلاً من إضافات TypeScript.

---

## Canvas و A2UI: مساحة العمل المرئية الموجهة بالوكيل

Canvas هي واحدة من أكثر ميزات OpenClaw تميزاً — مساحة عمل مرئية يتحكم بها الوكيل حيث يعرض الذكاء الاصطناعي مكونات واجهة مستخدم تفاعلية مباشرة على جهازك عبر بروتوكول A2UI.

### ما هو Canvas؟

بدلاً من الردود النصية فقط، يتيح Canvas للذكاء الاصطناعي إنشاء:
- لوحات تحكم تفاعلية ببيانات حية
- نماذج أولية وعروض مرئية
- رسوم بيانية وتصورات بيانات
- أدوات داخلية مخصصة برسوم متحركة
- تطبيقات ويب مصغرة تستمر عبر الجلسات

### بروتوكول A2UI (v0.8)

A2UI (واجهة الوكيل للمستخدم) هو البروتوكول الذي يشغل Canvas[^8]. يستخدم أربعة أنواع رسائل:

| نوع الرسالة | الغرض |
|-------------|-------|
| `beginRendering` | يشير إلى بداية سطح مرئي جديد |
| `surfaceUpdate` | يرسل مكونات واجهة مستخدم تصريحية إلى Canvas |
| `dataModelUpdate` | يحدّث البيانات بدون إعادة عرض السطح بالكامل |
| `deleteSurface` | يزيل سطحاً مرئياً |

### دعم المنصات

| المنصة | التنفيذ | ملاحظات |
|--------|---------|---------|
| macOS | WebKit أصلي (WKWebView) | لوحة بدون حدود قابلة لتغيير الحجم بجوار شريط القائمة |
| iOS | مكون SwiftUI | عرض Canvas مضمن |
| Android | WebView | عرض WebView قياسي لـ Android |
| الويب | تبويب المتصفح | يفتح Canvas في واجهة التحكم |

### A2UI في التطبيق: بناء سطح Canvas

يستخدم A2UI **مكونات JSON تصريحية** بتنسيق JSONL (كائن JSON واحد لكل سطر)، وليس HTML/CSS/JS مباشرة:

```jsonl
// 1. تعريف السطح مع المكونات
{"surfaceUpdate":{"surfaceId":"main","components":[
  {"id":"root","component":{"Column":{"children":{"explicitList":["title","content"]}}}},
  {"id":"title","component":{"Text":{"text":{"literalString":"مقاييس المشروع"},"usageHint":"h1"}}},
  {"id":"content","component":{"Text":{"text":{"literalString":"طلبات السحب المفتوحة: 7"},"usageHint":"body"}}}
]}}

// 2. إشارة للعارض لعرضها
{"beginRendering":{"surfaceId":"main","root":"root"}}

// 3. لاحقاً، تحديث البيانات بدون إعادة عرض كاملة
{"dataModelUpdate":{"surfaceId":"main","data":{"openPRs":12}}}

// 4. عند الانتهاء، تنظيف
{"deleteSurface":{"surfaceId":"main"}}
```

المكونات مصنّفة (`Column`، `Text`، `Row`، `Button`، إلخ) وتُعرض أصلياً على كل منصة. الوكيل لا يكتب HTML مباشرة؛ يصف بنية الواجهة تصريحياً.

للمحتوى الأغنى بـ HTML/CSS/JS (لوحات التحكم، الرسوم البيانية)، استخدم مهارة **Canvas OS**.

### Canvas OS

يوفر Canvas OS منصة تطبيقات لبناء وتخزين وتشغيل تطبيقات HTML/CSS/JS غنية داخل نافذة Canvas:

```bash
# تثبيت تطبيق Canvas OS
clawhub install canvas-os
```

### إعادة التحميل المباشر

يدعم Canvas إعادة التحميل المباشر — احفظ ملف canvas محلي ويتحدث فوراً.

---

## عقد الأجهزة: الكاميرا والشاشة والموقع والإشعارات

عقد الأجهزة هي تطبيقات مصاحبة (macOS، iOS، Android) تتصل ببوابتك وتكشف قدرات الأجهزة التي يمكن لوكيل الذكاء الاصطناعي استخدامها.

### قدرات الأجهزة المتاحة

| القدرة | الأمر | المنصات | ما يفعله |
|--------|------|---------|----------|
| **التقاط صورة** | `camera.snap` | macOS، iOS، Android | التقاط صورة وإرسالها للوكيل للتحليل |
| **مقطع كاميرا** | `camera.clip` | macOS، iOS، Android | تسجيل مقطع فيديو قصير |
| **تسجيل الشاشة** | `screen.record` | macOS | التقاط نشاط الشاشة لمراجعة الوكيل |
| **الموقع** | `location.get` | iOS، Android | الحصول على إحداثيات GPS الحالية |
| **الإشعارات** | `notify` | macOS، iOS، Android | إرسال إشعار للجهاز |

### بنية العقد

تتصل العقد بالبوابة عبر WebSocket وتسجل قدراتها. البوابة توجه استدعاءات الأدوات للعقدة المناسبة:

```
البوابة (VPS أو محلي)
    ├── عقدة macOS → الطرفية، المتصفح، الشاشة، الكاميرا
    ├── عقدة iOS → الكاميرا، الموقع، الإشعارات
    └── عقدة Android → الكاميرا، الموقع، الإشعارات
```

---

## مرجع البوابة: المنافذ وواجهات API وفحوصات الصحة

البوابة هي مستوى التحكم الدائم في OpenClaw، تربط على المنفذ 18789 افتراضياً.

### نقاط النهاية الافتراضية

| نقطة النهاية | الغرض |
|-------------|-------|
| `http://127.0.0.1:18789/` | واجهة التحكم (لوحة الويب) — تربط على 127.0.0.1 افتراضياً للأمان |
| `http://127.0.0.1:18789/health` | نقطة فحص الصحة |
| `ws://127.0.0.1:18789` | مستوى تحكم WebSocket (CLI، تطبيق macOS، واجهة الويب تتصل هنا) |

### واجهة API متوافقة مع OpenAI (v2026.3.22)

يمكن للبوابة كشف نقاط نهاية متوافقة مع OpenAI. **معطلة افتراضياً** ويجب تفعيلها في التكوين:

```json5
{
  gateway: {
    http: {
      endpoints: {
        chatCompletions: { enabled: true },
        responses: { enabled: true }
      }
    }
  }
}
```

| نقطة النهاية | الغرض | الافتراضي |
|-------------|-------|----------|
| `/v1/models` | عرض النماذج المتاحة | مفعّل |
| `/v1/embeddings` | توليد التضمينات | مفعّل |
| `/v1/chat/completions` | إكمالات الدردشة (مع دعم تجاوز النموذج) | **معطّل** |
| `/v1/responses` | متوافق مع OpenResponses | **معطّل** |

عند التفعيل، يمكنك توجيه أدوات مثل Cursor أو Continue إلى بوابتك المحلية. جميع الطلبات تتطلب رمز Bearer يطابق رمز البوابة المُكوّن.

### أوامر إدارة البوابة

```bash
# البدء في المقدمة (مفيد للتصحيح)
openclaw gateway --port 18789 --verbose

# البدء في المقدمة في حاوية
openclaw gateway start --foreground

# التحقق من الحالة
openclaw gateway status

# فتح لوحة التحكم
openclaw dashboard

# عرض السجلات
openclaw logs
```

### المقدمة مقابل الخدمة

| الوضع | الأمر | حالة الاستخدام |
|------|------|--------------|
| خدمة (Daemon) | `openclaw onboard --install-daemon` | الإنتاج — بدء تلقائي عند الإقلاع، إعادة تشغيل عند الفشل |
| المقدمة | `openclaw gateway --verbose` | التطوير/التصحيح — مشاهدة السجلات مباشرة |
| حاوية | `openclaw gateway start --foreground` | Docker — دع بيئة الحاوية تدير إعادة التشغيل |

---

## Docker والاستضافة الذاتية على VPS

### Docker Compose (الموصى به)

```yaml
# docker-compose.yml
services:
  openclaw:
    image: ghcr.io/openclaw/openclaw:latest
    ports:
      - "18789:18789"
    environment:
      - OPENCLAW_STATE_DIR=/data/openclaw
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
    volumes:
      - openclaw-data:/data/openclaw
    restart: unless-stopped

  # اختياري: تشغيل Ollama بجانبه للنماذج المحلية
  ollama:
    image: ollama/ollama:latest
    ports:
      - "11434:11434"
    volumes:
      - ollama-data:/root/.ollama
    deploy:
      resources:
        reservations:
          devices:
            - capabilities: [gpu]

volumes:
  openclaw-data:
  ollama-data:
```

*ملاحظة: بدون حقل `version` — أصبح قديماً في Docker Compose V2+.*

### أوامر الحاوية (v2026.3.22)

علامة `--container` الجديدة تتيح تشغيل أوامر CLI داخل حاوية قيد التشغيل:

```bash
# تشغيل أمر داخل حاوية OpenClaw
openclaw --container skills list
openclaw --container doctor
openclaw --container --version
```

### النشر على VPS

يوفر VPS تشغيلاً على مدار الساعة للبوابة. المواصفات الموصى بها:
- **المعالج:** 2+ vCPUs
- **الذاكرة:** 4 جيجابايت كحد أدنى (8 جيجابايت إذا كنت تشغل Ollama محلياً)
- **التخزين:** 20 جيجابايت SSD
- **المزودون:** DigitalOcean (~$12/شهر)، Hetzner (~$4.50/شهر)، Linode (~$12/شهر)

```bash
# على VPS الخاص بك (Ubuntu 22.04+)
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon

# وصول بعيد آمن مع Tailscale
curl -fsSL https://tailscale.com/install.sh | sh
tailscale up
# استخدم تكامل Tailscale المدمج في OpenClaw:
openclaw gateway --tailscale serve
# للوصول العام: openclaw gateway --tailscale funnel --auth password
```

### دعم NAS

يعمل OpenClaw على أجهزة NAS عبر Docker:
- **Unraid:** قالب Docker مجتمعي متاح
- **Synology:** النشر عبر Container Manager باستخدام Docker Compose أعلاه

---

## حالات الاستخدام العملية وسير العمل

### 1. إدارة صندوق البريد الإلكتروني

أخبر OpenClaw بمعالجة بريدك عبر واتساب:

```
أنت: "تحقق من بريدي ونظّف صندوق الوارد"

OpenClaw: سأفحص صندوق الوارد الآن...

وجدت 247 رسالة غير مقروءة:
- 180 نشرة/عروض → مؤرشفة
- 12 بريد مزعج → تم الإبلاغ عنها وحذفها
- 35 رسالة تتطلب إجراء → إليك ملخص الأولويات:

**عاجل (3):**
1. موعد تسليم عرض العميل غداً
2. تنبيه خادم من المراقبة
3. طلب مستند ضريبي

هل تريدني أن أصيغ ردوداً على أي منها؟
```

### 2. إعادة استخدام المحتوى

أعطه مقالة مدونة واحصل على نسخ مخصصة لكل منصة:

```
أنت: "خذ آخر مقالة مدونة لي وأنشئ نسخاً لتويتر ولينكدإن وإنستجرام"

OpenClaw: تم! إليك ما أعددته:

**سلسلة تويتر (7 تغريدات):**
1/ وكلاء الذكاء الاصطناعي يغيرون طريقة بناء البرمجيات...

**منشور لينكدإن:**
[نبرة مهنية، تنسيق أطول]

**تعليق إنستجرام:**
[نبرة عادية مع هاشتاغات ذات صلة]

هل تريدني أن أنشرها أم أحفظها كمسودات؟
```

### 3. أتمتة DevOps

أدر عمليات النشر من هاتفك:

```
أنت: "انشر فرع staging إلى الإنتاج"

OpenClaw: أشغّل فحوصات ما قبل النشر...
✓ الاختبارات ناجحة (142/142)
✓ لا ثغرات أمنية
✓ البناء ناجح

جاهز للنشر main ← production.
سيؤثر هذا على 3 خدمات. هل تريد المتابعة؟ (نعم/لا)
```

### 4. أتمتة المتصفح

```
أنت: "قارن أسعار AirPods Pro على Amazon و Best Buy و Walmart"

OpenClaw: أفتح المتصفحات وأتحقق من الأسعار...

| المتجر | السعر | متوفر | الشحن |
|--------|------|-------|------|
| Amazon | $199.99 | نعم | مجاني (Prime) |
| Best Buy | $189.99 | نعم | مجاني |
| Walmart | $194.00 | نعم | مجاني |

Best Buy لديه أقل سعر بـ $189.99.
هل تريدني أن أفتح صفحة الدفع؟
```

### 5. سير العمل المجدولة (Cron)

```
أنت: "كل صباح الساعة 8، تحقق من تقويمي، لخّص اجتماعات اليوم،
تحقق من الطقس، وأرسل لي ملخصاً على واتساب"

OpenClaw: تم! أعددت وظيفة cron يومية:
- المحفز: 8:00 صباحاً يومياً
- الإجراءات: فحص التقويم ← الطقس ← تحضير الاجتماعات ← إرسال الملخص
- القناة: واتساب
```

### 6. مساعد المستندات الخاص (بدون اتصال مع Ollama)

```
أنت: "لخّص العقد في ~/Documents/vendor-agreement.pdf
وحدد أي بنود مقلقة"

OpenClaw: [يعالج محلياً مع Ollama — بدون استدعاءات API سحابية]

ملخص اتفاقية المورد:
- المدة: 24 شهراً، تجديد تلقائي
- الدفع: 30 يوماً صافي

⚠️ بنود مقلقة:
1. القسم 4.2: عدم المنافسة يمتد لسنتين بعد الإنهاء
2. القسم 7.1: مسؤولية غير محدودة عن خروقات البيانات
3. القسم 9.3: يمكن للمورد تغيير الأسعار بإشعار 30 يوماً

التوصية: تفاوض على البندين 1 و 2 قبل التوقيع.
```

### 7. لوحة تحكم Canvas (ناتج مرئي)

```
أنت: "ابنِ لي لوحة تحكم تفاعلية تعرض إحصائيات مستودع GitHub الخاص بي"

OpenClaw: [يعرض لوحة تحكم Canvas تفاعلية تتضمن]:
- رسم بياني لعدد النجوم عبر الزمن
- ملخص المشاكل المفتوحة / طلبات السحب
- رسم بياني لأبرز المساهمين
- مؤشرات حالة البناء
- الكل يتحدث مباشرة عبر GitHub API
```

---

## الأمان والخصوصية والعزل

### نموذج الخصوصية

OpenClaw **محلي أولاً** بالتصميم:

| الجانب | كيف يعمل |
|--------|----------|
| **تخزين البيانات** | جميع البيانات تبقى على جهازك |
| **استدعاءات LLM** | مفتاح API الخاص بك، مباشرة للمزود (أو محلي بالكامل مع Ollama) |
| **بدون خدمة سحابية** | لا توجد خوادم OpenClaw — البوابة تعمل على جهازك |
| **بدون قياس عن بعد** | مفتوح المصدر، قابل للتدقيق، رخصة MIT |

### إقران الرسائل المباشرة والتحكم بالوصول

عندما يرسل شخص ما رسائل لحساباتك المتصلة، لا يرد OpenClaw تلقائياً على الغرباء:

- **وضع الإقران** (افتراضي): يرسل OpenClaw للمرسل المجهول رمزاً مكوناً من 6 أرقام (ينتهي بعد ساعة). توافق عبر `openclaw pairing approve <channel> <CODE>`
- **قائمة السماح**: فقط المستخدمون في `allowFrom` يحصلون على ردود؛ الآخرون يُسقطون بصمت
- **معطّل**: تجاهل جميع الرسائل المباشرة الواردة تماماً

### العزل (Sandboxing)

للجلسات غير الرئيسية (دردشات المجموعات، القنوات المشتركة)، يدعم OpenClaw عزل Docker:

```json5
// يمكن تكوين وضع العزل لكل وكيل أو كإعداد افتراضي
// "non-main" = جلسات الرسائل المباشرة الشخصية تعمل على المضيف،
// جلسات المجموعات/القنوات تعمل في حاويات Docker
```

أوضاع العزل: `"non-main"` (الموصى به افتراضياً)، `"always"` (كل الجلسات معزولة)، `"never"` (بدون عزل).

### تدقيق الأمان

شغّل مدقق الأمان المدمج:

```bash
openclaw doctor
```

يفحص: المنافذ المكشوفة، المصادقة المفقودة، صلاحيات الأدوات المفرطة، وتكوينات القنوات غير الآمنة.

### الثغرات المعروفة (مصلحة)

- **ثغرة (19 مارس 2026):** حقن أوامر في آلية البدء التلقائي لمهام Windows المجدولة. تؤثر على جميع الإصدارات قبل v2026.2.25. **الإصلاح:** حدّث إلى v2026.2.25 أو أحدث.

---

## التكوين المتقدم ونصائح الإنتاج

### توجيه متعدد الوكلاء

شغّل شخصيات وكلاء مختلفة لسياقات مختلفة. كل وكيل يحصل على مساحة عمل خاصة بمهارات وذاكرة معزولة:

```json5
{
  agents: {
    list: [
      {
        id: "personal",
        default: true,
        model: { primary: "anthropic/claude-opus-4-6" },
        workspace: "~/.openclaw/workspace-personal"
      },
      {
        id: "work",
        model: { primary: "anthropic/claude-opus-4-6" },
        workspace: "~/.openclaw/workspace-work"
      },
      {
        id: "family",
        model: { primary: "ollama/llama3.1:8b" },
        workspace: "~/.openclaw/workspace-family"
      }
    ]
  },
  bindings: [
    { agentId: "personal", match: { channel: "whatsapp" } },
    { agentId: "work", match: { channel: "slack" } },
    { agentId: "family", match: { channel: "telegram" } }
  ]
}
```

ثبّت مهارات مختلفة لكل مساحة عمل عبر التبديل لدليل المساحة وتشغيل `clawhub install`.

### التنبيه الصوتي ووضع المحادثة

على macOS وiOS وAndroid، يدعم OpenClaw التفاعل الصوتي عبر وضع المحادثة. يتطلب مفتاح API من ElevenLabs لتحويل النص إلى كلام:

- **التنبيه الصوتي**: اكتشاف كلمة التنبيه على macOS/iOS يبدأ الاستماع
- **وضع المحادثة**: محادثة صوتية مستمرة — يستمع (Whisper STT) ← يعالج مع الذكاء الاصطناعي ← ينطق الاستجابة (ElevenLabs TTS)
- **اضغط للتحدث**: اضغط مفتاح/زر للتحدث (تطبيق شريط القائمة في macOS)
- **المقاطعة**: إذا بدأت بالتحدث أثناء كلام المساعد، يتوقف التشغيل تلقائياً

### البحث المدمج في الويب (v2026.3.22)

أصبح Exa و Tavily و Firecrawl مدمجين في OpenClaw. سابقاً، كان البحث في الويب يتطلب تثبيت مهارات منفصلة. الآن فعّل البحث مباشرة بتكوين مفتاح API لأي من هذه المزودات.

### نصائح الأداء

| النصيحة | السبب |
|---------|------|
| استخدم pnpm بدلاً من npm | تثبيت أسرع، استخدام أفضل للقرص |
| ثبّت إصدار Node.js | يتجنب مشاكل التوافق (استخدم nvm) |
| شغّل البوابة كخدمة | إعادة تشغيل تلقائية عند الفشل، بدء عند الإقلاع |
| استخدم Tailscale للوصول البعيد | بدون تكوين، مشفر، بدون توجيه منافذ |
| قيّد الأدوات لجلسات المجموعات | يقلل سطح الهجوم |
| فعّل عزل Docker | يعزل الجلسات غير الموثوقة |
| استخدم Haiku للاستفسارات البسيطة | أرخص 5-10 مرات من Opus للمهام الأساسية |

---

## OpenClaw مقابل ChatGPT و AutoGPT و CrewAI

| الميزة | OpenClaw | ChatGPT/Claude Web | AutoGPT | CrewAI |
|--------|----------|-------------------|---------|--------|
| **أين يعمل** | جهازك (مستضاف ذاتياً) | خوادم سحابية | جهازك | جهازك (Python) |
| **الواجهة** | 20+ تطبيق مراسلة | تبويب متصفح | طرفية/ويب | كود Python |
| **تنفيذ الأوامر** | نعم — طرفية، ملفات، متصفح، cron | لا | نعم (محدود) | نعم (عبر أدوات) |
| **تكامل المراسلة** | 20+ قناة أصلية + إضافات مجتمعية | لا شيء | لا شيء | لا شيء |
| **نظام المهارات** | 13,700+ على ClawHub | GPTs (سحابي) | إضافات (محدودة) | أدوات مخصصة |
| **ناتج مرئي** | Canvas (A2UI) | واجهة ويب فقط | طرفية | لا شيء |
| **نماذج محلية** | Ollama، 20+ مزود | لا | نعم | نعم |
| **وقت الإعداد** | دقيقتان (أمر واحد) | تسجيل حساب | 15+ دقيقة | يتطلب معرفة Python |
| **التكلفة** | مجاني + تكاليف API | $20-200/شهر اشتراك | مجاني + تكاليف API | مجاني + تكاليف API |
| **نجوم GitHub** | 335,000+ | غير متاح | 183,000+ | 25,000+ |

### الفرق الفلسفي الجوهري

- **ChatGPT/Claude**: "ماذا يمكنني أن أجيب لك؟" — واجهة دردشة سحابية للمحادثات
- **AutoGPT**: "ما الذي يمكن للذكاء الاصطناعي استنتاجه؟" — إكمال مهام مستقلة عبر حلقات استدلال
- **OpenClaw**: "ما الذي يحتاج الناس فعلاً لإنجازه؟" — وكيل عملي في تطبيقات المراسلة يتخذ إجراءات حقيقية على حاسوبك

الميزة الفريدة لـ OpenClaw هي **بنيته المبنية على المراسلة أولاً**. بدلاً من فتح تطبيق منفصل، تراسل مساعدك الذكي في واتساب أو سلاك أو ديسكورد — نفس التطبيقات التي لديك مفتوحة طوال اليوم.

---

## استكشاف المشاكل الشائعة وحلها

### خطأ Canvas "bridge: missing"

يحدث عندما لا يستطيع WebView الخاص بـ Canvas الاتصال بالبوابة:

```bash
# تحقق مما إذا كانت البوابة تعمل
openclaw gateway status

# إذا كانت تعمل، تحقق من تطابق المنفذ
# Canvas يتوقع ws://127.0.0.1:18789 افتراضياً
openclaw gateway --port 18789 --verbose

# على iOS/Android، تأكد أن عقدة الجهاز متصلة بنفس الشبكة
```

### صحة البوابة تظهر "غير متصل"

```bash
# تحقق مما إذا كان المنفذ مستخدماً
lsof -i :18789  # macOS/Linux
netstat -ano | findstr :18789  # Windows

# أعد تشغيل البوابة
openclaw gateway stop
openclaw gateway start

# تحقق من السجلات للأخطاء
openclaw logs
```

### المتغيرات البيئية لا تُحمّل

تذكر قاعدة "عدم التجاوز" — القيمة الأولى المكتشفة تفوز[^7]:

```bash
# تصحيح: تحقق مما يراه OpenClaw
openclaw gateway status  # يعرض مسارات التكوين ومعلومات البيئة

# خطأ شائع: تعيين المتغيرات في .env وأيضاً في الطرفية
# بيئة الطرفية تفوز دائماً على ملفات .env
```

### متغيرات CLAWDBOT_*/MOLTBOT_* لم تعد تعمل

اعتباراً من v2026.3.22، تم إزالة جميع البادئات القديمة:

```bash
# ابحث واستبدل في ملف .env
sed -i 's/CLAWDBOT_/OPENCLAW_/g' ~/.openclaw/.env
sed -i 's/MOLTBOT_/OPENCLAW_/g' ~/.openclaw/.env
```

### مشاكل إصدار Node.js

يتطلب OpenClaw Node.js 22.14+:

```bash
# تحقق من إصدارك
node --version

# إذا كان أقل من v22، حدّث عبر nvm
nvm install 24  # الموصى به؛ الحد الأدنى هو 22.14
nvm use 24
```

### فشل تثبيت المهارات

```bash
# تحقق من توفر مدير الحزم
clawhub install <name> --verbose

# إذا كنت تستخدم pnpm، تأكد من تثبيته
npm install -g pnpm

# امسح ذاكرة التخزين المؤقت للمهارات وأعد المحاولة
rm -rf ~/.openclaw/skills/<skill-name>
clawhub install <skill-name>
```

### خطأ "unknown option" عند Gateway Start --foreground

إذا رأيت "unknown option" لـ `--foreground`، قد تكون على إصدار قديم:

```bash
# تحقق من الإصدار
openclaw --version

# حدّث للأحدث
openclaw update
```

---

## ما تكلفة تشغيل OpenClaw فعلياً؟

OpenClaw نفسه مجاني (رخصة MIT). تكاليفك تأتي من استخدام API لنموذج اللغة الكبير والبنية التحتية الاختيارية.

### تقديرات التكلفة الشهرية

| مستوى الاستخدام | النموذج | الرسائل/اليوم | التكلفة الشهرية المقدرة |
|---------------|---------|--------------|----------------------|
| استخدام شخصي خفيف | Claude Haiku 4.5 | 20-50 | $5-$15 |
| استخدام شخصي نشط | Claude Sonnet 4.6 | 50-100 | $20-$60 |
| مستخدم متقدم | Claude Opus 4.8 | 100-200 | $50-$150 |
| محلي بالكامل (Ollama) | Llama 3.1 70B | غير محدود | $0 (كهرباء فقط) |
| فريق (5 مستخدمين) | Claude Sonnet 4.6 | 500+ | $100-$300 |

*يفترض ~2,000 رمز إدخال و~500 رمز إخراج لكل رسالة في المتوسط.*

### تكاليف البنية التحتية (اختيارية)

| الإعداد | التكلفة الشهرية | متى تحتاجه |
|---------|--------------|------------|
| على حاسوبك المحمول | $0 | استخدام شخصي، دائماً على مكتبك |
| VPS (Hetzner CX22) | ~$4.50/شهر | تشغيل على مدار الساعة، وصول بعيد |
| VPS (DigitalOcean) | ~$12/شهر | ذاكرة أكثر لـ Ollama |
| VPS + GPU (للنماذج المحلية) | ~$50-100/شهر | تشغيل نماذج 70B محلياً على السحابة |

### نصائح تحسين التكلفة

- استخدم **Haiku** ($1/$5 لكل مليون رمز) للاستفسارات البسيطة، **Opus** ($5/$25) فقط للاستدلال المعقد
- فعّل **التخزين المؤقت للأوامر** — الإصابات المخزنة تكلف 10% من سعر الإدخال القياسي[^1]
- استخدم **وضع الدفعة** للمهام غير العاجلة (خصم 50% على API)
- شغّل **Ollama محلياً** للأحمال الحساسة أو كبيرة الحجم ($0 تكلفة API)

---

## وظائف Cron وتكوين Webhooks

### Cron: الأتمتة المجدولة

يتيح لك نظام cron في OpenClaw جدولة مهام متكررة. تُخزن الوظائف في `~/.openclaw/cron/jobs.json` وتُدار عبر CLI أو بسؤال وكيلك مباشرة.

**إنشاء وظيفة cron عبر المحادثة:**

```
أنت: "كل صباح الساعة 8، تحقق من تقويمي، احصل على الطقس،
لخّص رسائلي، وأرسل لي ملخصاً على واتساب"

OpenClaw: تم! أنشأت وظيفة cron "morning-briefing":
- الجدول: 0 8 * * * (يومياً الساعة 8:00 صباحاً)
- الإجراءات: التقويم ← الطقس ← ملخص البريد ← ملخص واتساب
```

**تكوين cron في `openclaw.json`:**

```json5
{
  cron: {
    enabled: true,
    store: "~/.openclaw/cron/jobs.json",
    maxConcurrentRuns: 1,
    retry: {
      maxAttempts: 3,
      backoffMs: [60000, 120000, 300000],
      retryOn: ["rate_limit", "overloaded", "network", "server_error"]
    }
  }
}
```

**أنواع الجداول:** تدعم الوظائف ثلاثة أنواع:
- `cron` — تعبير cron من 5 حقول (مثل `"0 8 * * *"`) مع `tz` اختياري للمنطقة الزمنية
- `every` — فترة بالمللي ثانية (مثل `1800000` لكل 30 دقيقة)
- `at` — تنفيذ لمرة واحدة في طابع زمني محدد

### Webhooks: الأتمتة المدفوعة بالأحداث

يمكن لوظائف cron تسليم النتائج عبر webhook. كوّن لكل وظيفة مع `delivery.mode = "webhook"`:

```json5
{
  delivery: {
    mode: "webhook",
    to: "https://your-server.com/openclaw-callback"
  }
}
```

**ملاحظة:** تُخزن الوظائف على القرص في `~/.openclaw/cron/jobs.json`. التعديل اليدوي آمن فقط عند إيقاف البوابة.

---

## مرجع أوامر OpenClaw السريع

مرجع سريع للأوامر الأكثر استخداماً. احفظ هذا القسم في المفضلة.

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

```bash
# التثبيت (macOS/Linux)
curl -fsSL https://openclaw.ai/install.sh | bash

# التثبيت (Windows PowerShell كمسؤول)
iwr -useb https://openclaw.ai/install.ps1 | iex

# التثبيت عبر npm
npm install -g openclaw@latest

# معالج الإعداد التفاعلي
openclaw onboard --install-daemon

# التحديث للأحدث
openclaw update
```

### إدارة البوابة

```bash
openclaw gateway status                  # هل تعمل؟
openclaw gateway --port 18789 --verbose  # بدء في المقدمة (تصحيح)
openclaw gateway stop                    # إيقاف البوابة
openclaw dashboard                       # فتح واجهة التحكم
openclaw logs                            # عرض السجلات الأخيرة
openclaw --version                         # التحقق من الإصدار المثبت
```

### المهارات

```bash
clawhub install <name>                   # تثبيت من ClawHub
openclaw skills list                     # عرض المهارات المثبتة
openclaw skills remove <name>            # إزالة مهارة
openclaw skills update --all             # تحديث جميع المهارات
openclaw /tools                          # عرض الأدوات المتاحة
```

### التفاعل مع الوكيل

```bash
openclaw agent --message "أمرك"          # إرسال رسالة
openclaw agent --message "مهمة معقدة" --thinking high  # استدلال عميق
```

### الأمان والتشخيص

```bash
openclaw doctor                          # تدقيق أمني
openclaw gateway status                  # يعرض مسارات التكوين ومعلومات البيئة
```

### Docker / الحاوية

```bash
# التشغيل في Docker
docker run -d --name openclaw -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw ghcr.io/openclaw/openclaw:latest

# تشغيل أوامر داخل الحاوية (v2026.3.22+)
openclaw --container skills list
openclaw --container doctor
```

### إدارة الملفات الشخصية

```bash
openclaw --profile personal gateway      # بدء بملف شخصي مسمى
openclaw --profile work gateway          # دليل حالة معزول
```

---

## البدء

مستعد لإعداد مساعدك الذكي الخاص؟ إليك المسار:

1. **ثبّت OpenClaw**: شغّل سكريبت التثبيت المكون من سطر واحد لمنصتك
2. **شغّل الإعداد الأولي**: `openclaw onboard --install-daemon` يرشدك خلال كل شيء
3. **اربط واتساب أو تيليجرام**: ابدأ بقناة واحدة تستخدمها يومياً
4. **جرّب أوامر أساسية**: اطلب منه التحقق من تقويمك أو تلخيص ملف أو البحث في الويب
5. **ثبّت مهارات**: تصفح [clawhub.ai](https://clawhub.ai) وثبّت مهارات لسير عملك
6. **أعد أتمتة**: أنشئ وظائف cron للمهام المتكررة
7. **جرّب Canvas**: اطلب من الوكيل بناء لوحة تحكم تفاعلية
8. **أضف قنوات أخرى**: اربط سلاك للعمل، ديسكورد للمجتمعات
9. **انتقل للمتقدم**: أعد توجيه متعدد الوكلاء أو عزل Docker أو نشر على خادم بعيد

OpenClaw يحول تطبيقات المراسلة إلى مركز قيادة. بدلاً من التبديل بين عشرات تبويبات المتصفح والأدوات، اكتب ما تحتاجه في واتساب ومساعدك الذكي يتولى الباقي — على أجهزتك، ببياناتك، تحت سيطرتك.

---

[^1]: تسعير Anthropic Claude API (مارس 2026). إصابات ذاكرة التخزين المؤقت تكلف 10% من سعر الإدخال القياسي.
[^2]: مدونة OpenClaw الرسمية، "250,000 نجمة: OpenClaw يتجاوز React" (مارس 2026). 60,000 نجمة في 72 ساعة عند الإطلاق.
[^3]: سجل مهارات ClawHub (clawhub.ai). العدد حتى 28 فبراير 2026: 13,729 مهارة مجتمعية.
[^4]: مستودع OpenClaw على GitHub (github.com/openclaw/openclaw). النجوم: 335,000+، المساهمون: 1,100+، الفروع: 57,000+ حتى 24 مارس 2026.
[^5]: ملاحظات إصدار OpenClaw v2026.3.22. أكثر من 45 ميزة جديدة، 13 تغييراً جذرياً، 82 إصلاح خطأ، أكثر من 20 تصحيحاً أمنياً.
[^6]: توثيق OpenClaw: مزودو النماذج (docs.openclaw.ai/concepts/model-providers).
[^7]: توثيق OpenClaw: المتغيرات البيئية (docs.openclaw.ai/help/environment). ترتيب التحميل وقاعدة عدم التجاوز.
[^8]: توثيق OpenClaw: Canvas (docs.openclaw.ai/platforms/mac/canvas). مواصفات بروتوكول A2UI v0.8.
[^9]: Yahoo Finance / مدونة OpenClaw. أعلن Peter Steinberger انضمامه لـ OpenAI في 14 فبراير 2026.

## الأسئلة الشائعة

### ما هو OpenClaw (المعروف سابقاً بـ Clawdbot)؟

OpenClaw هو مساعد ذكاء اصطناعي شخصي مجاني ومفتوح المصدر ومستضاف ذاتياً مع أكثر من 335,000 نجمة على GitHub — أسرع مشروع مفتوح المصدر نمواً في التاريخ. يعمل على أجهزتك الخاصة، يتصل بأكثر من 50 منصة مراسلة، ويمكنه تنفيذ مهام حقيقية: أوامر الطرفية، إدارة الملفات، أتمتة المتصفح، وظائف cron، وسير العمل.

### لماذا تمت إعادة تسمية Clawdbot إلى OpenClaw؟

مر المشروع بإعادتي تسمية في 3 أيام. كان في الأصل 'Clawdbot'، طلب فريق Anthropic القانوني تغيير الاسم. أصبح 'Moltbot' في 27 يناير 2026، ثم 'OpenClaw' في 29 يناير بعد اختطاف المحتالين للحسابات القديمة. في فبراير 2026، أعلن المؤسس Peter Steinberger انضمامه لـ OpenAI ونقل المشروع لمؤسسة مفتوحة المصدر.

### كيف أثبت OpenClaw على Windows؟

ثلاث طرق: (1) أمر PowerShell: `iwr -useb https://openclaw.ai/install.ps1 | iex` (يتطلب Node.js 22+)، (2) WSL2 + مثبت Linux (موصى به للتطوير)، (3) Docker Desktop مع WSL2 (موصى به للعزل). يتطلب Windows 10 Build 19041+ أو Windows 11، يُوصى بـ 8GB ذاكرة.

### ما هي OPENCLAW_HOME و OPENCLAW_STATE_DIR و OPENCLAW_CONFIG_PATH؟

هذه المتغيرات البيئية تتحكم في مكان تخزين OpenClaw للبيانات. OPENCLAW_HOME يستبدل دليل النظام الرئيسي. OPENCLAW_STATE_DIR يتجاوز دليل الحالة (افتراضي: ~/.openclaw). OPENCLAW_CONFIG_PATH يشير لملف تكوين محدد. يتبع OpenClaw قاعدة 'عدم التجاوز' حيث القيمة الأولى تفوز.

### ما هو OpenClaw Canvas و A2UI؟

Canvas هو مساحة عمل مرئية موجهة بالوكيل حيث يمكن للمساعد الذكي عرض HTML وCSS وJavaScript والمحتوى التفاعلي مباشرة على جهازك. A2UI (واجهة الوكيل للمستخدم) v0.8 هو البروتوكول الذي يشغلها. يعمل Canvas على macOS وiOS وAndroid والمتصفحات.

### ما منصات المراسلة التي يدعمها OpenClaw؟

يدعم OpenClaw أكثر من 50 قناة مراسلة بما في ذلك واتساب وتيليجرام وسلاك وديسكورد وGoogle Chat وسيجنال وBlueBubbles وMicrosoft Teams وMatrix (إضافة رسمية جديدة في v2026.3.22) وIRC وFeishu وLINE وMattermost وNextcloud Talk وNostr وSynology Chat وTlon وTwitch وZalo وWeChat وWebChat.

### ما نماذج الذكاء الاصطناعي التي يعمل معها OpenClaw؟

يعمل OpenClaw مع أكثر من 20 مزود ذكاء اصطناعي. ترتيب الأولوية: Anthropic > OpenAI > OpenRouter > Google > GitHub Copilot > xAI > Groq > Mistral والمزيد. للخصوصية التامة، استخدم Ollama مع النماذج المحلية — لا تغادر أي بيانات جهازك.

### ما هي مهارات OpenClaw وكيف أثبتها؟

المهارات هي ملفات SKILL.md تعلّم الوكيل كيفية أداء المهام. يستضيف ClawHub أكثر من 13,700 مهارة مجتمعية. ثبّت من سطر الأوامر: `clawhub install <name>`. المهارات تعيش في ~/.openclaw/skills/ (مُدارة) أو <project>/skills/ (نطاق مساحة العمل).

### هل OpenClaw آمن؟ هل يمكن للآخرين الوصول لمساعدي؟

لدى OpenClaw نموذج أمان متعدد الطبقات. الوصول عبر الرسائل المباشرة يتطلب افتراضياً أكواد موافقة. الجلسات غير الرئيسية يمكن عزلها في Docker. البوابة تعمل محلياً. استخدم 'openclaw doctor' لتدقيق الأمان. ملاحظة: تم تصحيح ثغرة في Windows في v2026.2.25.

### هل يمكنني تشغيل OpenClaw على خادم بعيد؟

نعم. شغّل البوابة على VPS أو في Docker بينما تتولى عقد الأجهزة الإجراءات المحلية. استخدم Tailscale للوصول البعيد الآمن. علامة --container الجديدة (v2026.3.22) تتيح تشغيل أوامر openclaw داخل حاوية Docker أو Podman.

### كيف يقارن OpenClaw مع ChatGPT أو AutoGPT؟

ChatGPT/Claude هي واجهات دردشة سحابية. OpenClaw هو وكيل مستضاف ذاتياً يعيش في تطبيقات المراسلة ويتخذ إجراءات على حاسوبك. مقابل AutoGPT: يتميز OpenClaw بدعم 20+ منصة أصلية، نظام مهارات ناضج (13,700+ على ClawHub)، وتثبيت بأمر واحد.