الدليل الشامل لـ OpenClaw: التثبيت والتكوين والمهارات والكانفاس والاستضافة الذاتية

{/* آخر تحديث: 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 لأحدث التوثيق.

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

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

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

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

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

المقياس	القيمة
نجوم GitHub	أكثر من 335,000 (تجاوز رقم React القياسي الذي استغرق 10 سنوات في 60 يوماً)12
المساهمون	أكثر من 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؛ المشروع ينتقل إلى مؤسسة مفتوحة المصدر4
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:

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

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

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

أو عبر npm/pnpm:

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

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

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

openclaw onboard --install-daemon

يرشدك خلال:

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

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

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

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

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

التكوين

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

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

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

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

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

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 كمسؤول
iwr -useb https://openclaw.ai/install.ps1 | iex

المتطلبات:

• Windows 10 Build 19041+ أو Windows 11
• Node.js 22.14+ مثبت (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:

# 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 (الأفضل للعزل)

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

# 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:

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

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

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

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

# 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:

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

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

---

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

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

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

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

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

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

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

{
  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:

# تثبيت 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:

{
  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.

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

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

{
  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) هو دليل مهارات المجتمع مع أكثر من 13,729 مهارة³ عبر فئات:

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

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

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

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

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

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

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

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

كتابة مهارة Markdown

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

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

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

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

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

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

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

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

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

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

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

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

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

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⁷. يستخدم أربعة أنواع رسائل:

نوع الرسالة	الغرض
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 مباشرة:

// 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:

# تثبيت تطبيق 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. معطلة افتراضياً ويجب تفعيلها في التكوين:

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

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

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

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

# البدء في المقدمة (مفيد للتصحيح)
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 (الموصى به)

# 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 داخل حاوية قيد التشغيل:

# تشغيل أمر داخل حاوية 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/شهر)

# على 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:

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

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

تدقيق الأمان

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

openclaw doctor

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

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

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

---

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

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

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

{
  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 الاتصال بالبوابة:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

# تحقق من توفر مدير الحزم
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، قد تكون على إصدار قديم:

# تحقق من الإصدار
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.6	100-200	$50-$150
محلي بالكامل (Ollama)	Llama 3.1 70B	غير محدود	$0 (كهرباء فقط)
فريق (5 مستخدمين)	Claude Sonnet 4.6	500+	$100-$300

⚠ Prices change frequently. The values above are for illustration only and may be out of date. Always verify current pricing directly with the provider before making cost decisions: Anthropic · OpenAI · Google Gemini · Google Vertex AI · AWS Bedrock · Azure OpenAI · Mistral · Cohere · Together AI · DeepSeek · Groq · Cursor · GitHub Copilot · Windsurf.

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

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

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

⚠ Prices change frequently. The values above are for illustration only and may be out of date. Always verify current pricing directly with the provider before making cost decisions: Anthropic · OpenAI · Google Gemini · Google Vertex AI · AWS Bedrock · Azure OpenAI · Mistral · Cohere · Together AI · DeepSeek · Groq · Cursor · GitHub Copilot · Windsurf.

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

• استخدم Haiku ($1/$5 لكل مليون رمز) للاستفسارات البسيطة، Opus ($5/$25) فقط للاستدلال المعقد
• فعّل التخزين المؤقت للأوامر — الإصابات المخزنة تكلف 10% من سعر الإدخال القياسي⁹
• استخدم وضع الدفعة للمهام غير العاجلة (خصم 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:

{
  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":

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

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

---

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

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

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

# التثبيت (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

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

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

المهارات

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

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

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

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

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

Docker / الحاوية

# التشغيل في 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

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

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

---

البدء

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

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

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

---

Footnotes

1. مدونة OpenClaw الرسمية، "250,000 نجمة: OpenClaw يتجاوز React" (مارس 2026). 60,000 نجمة في 72 ساعة عند الإطلاق. ↩

2. مستودع OpenClaw على GitHub (github.com/openclaw/openclaw). النجوم: 335,000+، المساهمون: 1,100+، الفروع: 57,000+ حتى 24 مارس 2026. ↩

3. سجل مهارات ClawHub (clawhub.ai). العدد حتى 28 فبراير 2026: 13,729 مهارة مجتمعية. ↩ ↩²

4. Yahoo Finance / مدونة OpenClaw. أعلن Peter Steinberger انضمامه لـ OpenAI في 14 فبراير 2026. ↩

5. ملاحظات إصدار OpenClaw v2026.3.22. أكثر من 45 ميزة جديدة، 13 تغييراً جذرياً، 82 إصلاح خطأ، أكثر من 20 تصحيحاً أمنياً. ↩

6. توثيق OpenClaw: مزودو النماذج (docs.openclaw.ai/concepts/model-providers). ↩

7. توثيق OpenClaw: Canvas (docs.openclaw.ai/platforms/mac/canvas). مواصفات بروتوكول A2UI v0.8. ↩

8. توثيق OpenClaw: المتغيرات البيئية (docs.openclaw.ai/help/environment). ترتيب التحميل وقاعدة عدم التجاوز. ↩

9. تسعير Anthropic Claude API (مارس 2026). إصابات ذاكرة التخزين المؤقت تكلف 10% من سعر الإدخال القياسي. ↩