دليل إعداد OpenClaw الشامل 2026

هذا هو الدليل الشامل والعملي لإعداد OpenClaw. سواء كنت تشغّله على Mac Mini أو خادم سحابي أو Raspberry Pi — هذا الدليل يغطي كل شيء من التثبيت إلى تحسين التكاليف إلى الميزات المتقدمة.

جدول المحتويات

• ما هو OpenClaw؟
• المتطلبات الأساسية
• التثبيت (4 طرق)
• إعداد المصادقة
• ربط القنوات (Telegram، WhatsApp، Discord)
• تحسين التكاليف والنماذج المجانية
• تثبيت المهارات والإضافات
• إدارة الذاكرة والسياق
• الإعدادات المتقدمة
• حل المشكلات الشائعة
• أفضل ممارسات الأمان
• مصادر إضافية

ما هو OpenClaw؟

OpenClaw هو مساعد ذكاء اصطناعي يعمل على أجهزتك الخاصة. على عكس تطبيقات ChatGPT أو Claude على الويب، OpenClaw:

• يعمل 24/7 على جهازك (Mac Mini، خادم سحابي، سيرفر منزلي)
• يتصل بتطبيقات المراسلة (Telegram، WhatsApp، Discord، Signal، iMessage، Slack، والمزيد)
• لديه ذاكرة دائمة — يتذكر المحادثات عبر الجلسات
• يمكنه اتخاذ إجراءات — تصفح الويب، تشغيل أكواد، إدارة ملفات، إرسال رسائل
• يعمل مع مزودين متعددين — Anthropic، OpenAI، Google، وبدائل مجانية

تخيّل أن لديك Claude أو GPT كمساعد شخصي يعيش في تطبيقات المراسلة ولديه صلاحية الوصول لجهازك.

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

متطلبات الأجهزة

OpenClaw نفسه خفيف — بشكل افتراضي، الذكاء الاصطناعي يعمل في السحابة عبر API. الحد الأدنى:

• أي كمبيوتر حديث: Mac Mini M1/M2/M4، لابتوب قديم، Raspberry Pi 4+، خادم سحابي بـ 1 جيجا رام
• اتصال دائم: جهازك يحتاج أن يبقى مشغّلاً ومتصلاً
• تخزين: ~500 ميجا لـ OpenClaw + سجلات المحادثات

متطلبات البرمجيات

• Node.js 22 أو أحدث — تحقق بـ node --version
• وصول للطرفية — Terminal في macOS، shell في Linux، أو WSL2 على Windows

تثبيت Node.js

إذا لم يكن لديك Node.js 22+:

# macOS (باستخدام Homebrew)
brew install node@22

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

# باستخدام nvm (أي منصة)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
nvm install 22
nvm use 22

التثبيت

الطريقة 1: سكربت التثبيت السريع (الموصى بها)

أسرع طريقة للبدء:

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

# Windows (PowerShell في WSL2)
curl -fsSL https://openclaw.ai/install.sh | bash

هذا يثبّت OpenClaw ويفتح معالج الإعداد.

الطريقة 2: تثبيت npm

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

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

الطريقة 3: من المصدر (للمطورين)

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

الطريقة 4: تثبيت VPS المحصّن (مُوصى به للخوادم)

للنشر الإنتاجي على خادم سحابي، استخدم مُثبِّت openclaw-ansibleمع تقوية أمان مدمجة:

curl -fsSL https://raw.githubusercontent.com/openclaw/openclaw-ansible/main/install.sh | bash

هذا المُثبِّت يوفر بنية أمان من 4 طبقات:

• جدار حماية UFW — فقط SSH (22) مكشوف للعامة
• Tailscale VPN — البوابة متاحة فقط عبر شبكة VPN آمنة
• عزل Docker — صناديق رمل الوكيل تعمل في حاويات معزولة
• تقوية Systemd — NoNewPrivileges، PrivateTmp، مستخدم بدون صلاحيات

معالج الإعداد

بعد التثبيت، معالج openclaw onboard يرشدك خلال:

1. إعداد المصادقة (مفاتيح API أو OAuth)
2. ربط أول قناة (Telegram، WhatsApp، إلخ)
3. تثبيت خدمة الخلفية (ليعمل 24/7)
4. اختبار أول رسالة

إعداد المصادقة

OpenClaw يحتاج الوصول لمزود ذكاء اصطناعي. إليك خياراتك:

الخيار 1: اشتراك Claude Pro/Max من Anthropic (الموصى به)

التكلفة: 20-200 دولار/شهرياً (غير محدود ضمن حدود السرعة)
الأفضل لـ: المستخدمين المكثفين الذين يريدون أفضل النماذج

اشتراك Claude Pro (20$/شهر) أو Max (200$/شهر) يمنحك وصول OAuth بحدود سخية.

# تشغيل أمر إعداد التوكن
claude setup-token

# التحقق من أنه يعمل
openclaw models status

الخيار 2: مفتاح API من Anthropic

التكلفة: الدفع بالاستخدام (~3-15$ لكل مليون توكن)
الأفضل لـ: الاستخدام الخفيف، فواتير متوقعة

1. اذهب إلى console.anthropic.com
2. أنشئ مفتاح API
3. أضفه لـ OpenClaw:

openclaw config set auth.profiles.anthropic.key "sk-ant-..."

# أو عبر متغير بيئة
export ANTHROPIC_API_KEY="sk-ant-..."

الخيار 3: OpenAI (اشتراك ChatGPT Plus / Codex)

التكلفة: 20-200 دولار/شهرياً أو API بالاستخدام
الأفضل لـ: من يفضلون نماذج GPT

# إعداد OAuth (اشتراك)
openclaw onboard  # اختر OpenAI أثناء المعالج

# أو مفتاح API
openclaw config set auth.profiles.openai.key "sk-..."

الخيار 4: نماذج مجانية (OpenRouter، Kimi، MiniMax)

التكلفة: مجانية (مع قيود)
الأفضل لـ: التجربة، الاستخدام الخفيف، الميزانية المحدودة

عدة مزودين يقدمون طبقات مجانية:

• OpenRouter — نماذج مجانية من مزودين متعددين
• Kimi (Moonshot) — طبقة مجانية متاحة
• MiniMax — طبقة مجانية متاحة
• Google AI Studio — وصول مجاني لـ Gemini

# البحث عن نماذج مجانية
openclaw models scan --no-probe

# تعيين نموذج مجاني كأساسي
openclaw models set openrouter/meta-llama/llama-3.3-70b-instruct:free

النماذج البديلة (تحسين التكاليف)

اضبط البدائل ليتحول OpenClaw تلقائياً عند وصول مزود لحد السرعة:

openclaw models fallbacks add openai/gpt-4o
openclaw models fallbacks add openrouter/anthropic/claude-3.5-sonnet

ربط القنوات

Telegram (الأسهل)

Telegram هو أسهل قناة للإعداد:

1. أرسل رسالة لـ @BotFather على Telegram
2. أرسل /newbot واتبع التعليمات
3. انسخ توكن البوت
4. أضفه لـ OpenClaw:

openclaw config set channels.telegram.enabled true
openclaw config set channels.telegram.botToken "123456:ABC..."
openclaw config set channels.telegram.dmPolicy "pairing"

# أعد التشغيل للتطبيق
openclaw gateway restart

الآن أرسل رسالة لبوتك على Telegram. أول مرة، ستحصل على رمز اقتران للموافقة على حسابك:

# الموافقة على حسابك في Telegram
openclaw pairing approve telegram <CODE>

WhatsApp

WhatsApp يستخدم جسر WhatsApp Web:

openclaw config set channels.whatsapp.enabled true
openclaw config set channels.whatsapp.allowFrom "+1234567890"

# أعد التشغيل وامسح رمز QR
openclaw gateway restart

Discord

1. أنشئ تطبيق Discord في discord.com/developers
2. أنشئ بوت وانسخ التوكن
3. ادعُ البوت لسيرفرك

openclaw config set channels.discord.enabled true
openclaw config set channels.discord.botToken "..."
openclaw config set channels.discord.dmPolicy "pairing"

قنوات أخرى

OpenClaw يدعم العديد من القنوات الأخرى:

• Signal — يحتاج إعداد signal-cli
• iMessage — macOS فقط، يستخدم BlueBubbles
• Slack — يحتاج إعداد تطبيق Slack
• Google Chat — يحتاج Google Workspace
• Matrix — مستضاف ذاتياً أو matrix.org
• Microsoft Teams — يحتاج تسجيل تطبيق Azure

تحسين التكاليف

تكاليف API قد تتراكم بسرعة. إليك كيف تبقيها تحت السيطرة:

1. استخدم الاشتراكات بدل مفاتيح API

Claude Pro (20$/شهر) أو Max (200$/شهر) يمنحك استخدام غير محدود ضمن حدود السرعة. المستخدمون المكثفون غالباً يجدون الاشتراكات أرخص.

2. اضبط نماذج بديلة

عندما يصل نموذجك الأساسي لحد السرعة، OpenClaw يتحول للبدائل تلقائياً.

3. استخدم نماذج أرخص للمهام البسيطة

بدّل النماذج أثناء المحادثة بـ /model:

/model sonnet      # استخدم Sonnet للمهام السريعة
/model opus        # تحوّل لـ Opus للعمل المعقد

4. فعّل الضغط

المحادثات الطويلة تستهلك توكنات. فعّل الضغط لتلخيص السياق القديم.

5. راقب الاستخدام

# تحقق من استخدام الجلسة الحالية
/status

# شاهد حالة النموذج والمصادقة
openclaw models status

تثبيت المهارات والإضافات

المهارات توسّع قدرات OpenClaw. إنها مثل الإضافات التي تضيف ميزات جديدة.

البحث عن مهارات

• ClawHub — دليل مهارات المجتمع
• مهارات مدمجة في ~/.npm-global/lib/node_modules/openclaw/skills/

تثبيت مهارة

# استنسخ لمساحة عملك
cd ~/.openclaw/workspace
git clone https://github.com/user/skill-name.git skills/skill-name

# أو أنشئ مهارتك الخاصة
mkdir -p skills/my-skill
# أضف SKILL.md مع التعليمات

المهارات المدمجة الشائعة

• weather — الحصول على الطقس الحالي والتوقعات
• tmux — التحكم بجلسات الطرفية
• video-frames — استخراج إطارات من الفيديوهات
• nano-banana-pro — توليد صور مع Gemini

إدارة الذاكرة والسياق

أحد أقوى ميزات OpenClaw هي الذاكرة الدائمة عبر الجلسات.

كيف تعمل الذاكرة

• MEMORY.md — ذاكرة طويلة المدى منسّقة (مثل يوميات)
• memory/*.md — ملاحظات يومية وسجلات جلسات
• نصوص الجلسات — سجل محادثات قابل للبحث

الإعدادات المتقدمة

التشغيل كخدمة (24/7)

معالج الإعداد يمكنه تثبيت خدمة نظام. للقيام بذلك يدوياً:

# macOS (launchd)
openclaw daemon install

# Linux (systemd)
openclaw daemon install

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

المهام المجدولة (Cron)

جدوِل المساعد ليفعل أشياء تلقائياً:

{
  "cron": {
    "jobs": [
      {
        "name": "morning-briefing",
        "schedule": { "kind": "cron", "expr": "0 9 * * *", "tz": "Asia/Dubai" },
        "payload": { "kind": "agentTurn", "message": "صباح الخير! أعطني ملخصي اليومي." },
        "sessionTarget": "isolated"
      }
    ]
  }
}

نبضات القلب (الفحوصات الاستباقية)

اضبط OpenClaw ليتحقق دورياً:

{
  "agents": {
    "defaults": {
      "heartbeat": {
        "every": "30m"
      }
    }
  }
}

حل المشكلات

"النموذج غير مسموح"

نموذجك ليس في قائمة السماح. الحل:

# أضف النموذج لقائمة السماح
openclaw config set agents.defaults.models.\["anthropic/claude-sonnet-4-5"\].alias "Sonnet"

# أو امسح قائمة السماح
openclaw config unset agents.defaults.models

البوت لا يستجيب في المجموعات

1. تحقق من وضع خصوصية Telegram: /setprivacy → عطّله في BotFather
2. أزل البوت وأعد إضافته للمجموعة
3. أو اجعل البوت مديراً للمجموعة

البوابة لا تبدأ

# تحقق من أخطاء الإعدادات
openclaw doctor

# إصلاح تلقائي
openclaw doctor --fix

# تحقق من السجلات
openclaw logs --follow

انتهاء صلاحية توكن OAuth

# أعد المصادقة
claude setup-token

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

أفضل ممارسات الأمان

1. استخدم وضع الاقتران (الافتراضي)

استخدم دائماً dmPolicy: "pairing" (الافتراضي) حتى يجب الموافقة على المرسلين غير المعروفين قبل التفاعل مع مساعدك.

2. حافظ على أمان مفاتيح API

لا تضع مفاتيح API في git أو تشارك ملفات الإعدادات علنياً. استخدم متغيرات البيئة أو مخزن المصادقة الآمن.

3. حدّد الوصول في المجموعات

استخدم groupPolicy: "allowlist" وحدد المرسلين المسموحين صراحة.

4. راجع وحدّد صلاحيات الأدوات

OpenClaw يمكنه تشغيل أوامر shell والوصول للملفات افتراضياً. يمكنك تقييد الأدوات المتاحة والأوامر القابلة للتشغيل.

5. استخدم جهازاً مخصصاً + تثبيت محصّن

للعزل الأقصى، شغّل OpenClaw على جهاز مخصص بدلاً من محطة عملك الرئيسية.

6. كن حذراً مع التكاملات الخارجية

عند الربط بالبريد أو التقويم أو خدمات أخرى، استخدم وصول القراءة فقط حيث أمكن.

7. راقب السجلات

تحقق دورياً من openclaw logs لرؤية ما يفعله مساعدك.

مصادر إضافية

• التوثيق الرسمي
• مجتمع Discord
• مستودع GitHub
• ClawHub (دليل المهارات)

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

الآن بعد تشغيل OpenClaw:

• استكشف 15 حالة استخدام حقيقية
• افهم لماذا الوكلاء أفضل من الـ Chatbot
• شاهد تحليل التكاليف الكامل