الدليل العملي لـ OpenClaw: مساعدك الذكي المستضاف ذاتياً

{/* آخر تحديث: 2026-02-10 | OpenClaw أحدث إصدار | Node.js 22+ | رخصة MIT */}

ملاحظة الإصدار: يغطي هذا الدليل OpenClaw (المعروف سابقاً بـ Clawdbot، ثم Moltbot) حتى فبراير 2026. المشروع لديه أكثر من 185,000 نجمة على GitHub وهو أحد أسرع المشاريع مفتوحة المصدر نمواً في التاريخ. OpenClaw تحت تطوير نشط — قد تتغير الميزات والأوامر. تحقق دائماً من docs.openclaw.ai لأحدث التوثيق.

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

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

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

• تشغيل أوامر الطرفية والسكريبتات
• قراءة وكتابة وتعديل الملفات على نظام ملفاتك
• التحكم بالمتصفح (التنقل، النقر، ملء النماذج، لقطات الشاشة)
• جدولة مهام cron والاستجابة لـ webhooks
• إدارة البريد الإلكتروني والتقويمات وسير العمل
• أتمتة أي شيء يمكنك وصفه بلغة طبيعية

القصة وراء الاسم

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

أنشأ المشروع Peter Steinberger (مؤسس PSPDFKit) وانتشر بشكل فيروسي في أواخر يناير 2026، قافزاً من مشروع شخصي إلى أكثر من 185,000 نجمة على GitHub في أسابيع.

OpenClaw مقابل مساعدي الذكاء الاصطناعي السحابيين

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

يستخدم OpenClaw بنية البوابة — طبقة تحكم محلية مبنية على WebSocket تنسق كل شيء:

┌─────────────────────────────────────────────────┐
│                    البوابة                        │
│              ws://127.0.0.1:18789                │
│                                                  │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐        │
│  │ الجلسات  │ │ القنوات  │ │ الأدوات  │        │
│  └──────────┘ └──────────┘ └──────────┘        │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐        │
│  │ الأحداث │ │  Cron    │ │ المهارات │        │
│  └──────────┘ └──────────┘ └──────────┘        │
└────────┬──────────┬───────────┬─────────────────┘
         │          │           │
    ┌────▼────┐ ┌──▼────┐ ┌───▼──────┐
    │واتساب  │ │ سلاك │ │ WebChat  │  ...أكثر من 13 قناة
    └─────────┘ └───────┘ └──────────┘
         │          │           │
    ┌────▼──────────▼───────────▼────┐
    │        نموذج الذكاء الاصطناعي  │
    │  Claude / GPT-4 / Ollama       │
    └────────────────────────────────┘

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

الحزمة التقنية

• اللغة: TypeScript
• وقت التشغيل: Node.js 22+
• مدير الحزم: pnpm (المفضل)، npm، أو bun
• حزم SDK للقنوات: Baileys (واتساب)، grammY (تيليجرام)، Bolt (سلاك)، discord.js (ديسكورد)، signal-cli (سيجنال)
• أتمتة المتصفح: Chrome/Chromium مُدار من OpenClaw عبر CDP
• الرخصة: MIT — مجاني ومفتوح المصدر بالكامل

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

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

• Node.js 22 أو أحدث (تحقق: node --version)
• macOS أو Linux أو Windows (يتطلب WSL2 على 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. المصادقة — تكوين مفاتيح API لنموذج اللغة
2. إعدادات البوابة — المنفذ، دليل مساحة العمل
3. إعداد القناة — ربط أول منصة مراسلة
4. تثبيت الخدمة — تشغيل البوابة تلقائياً عند الإقلاع

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

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

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

التكوين

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

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

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

{
  agent: {
    // تشغيل مع Ollama لخصوصية تامة
    model: "ollama/llama3.1:70b",
  },
}

متغيرات البيئة

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

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

ربط قنوات المراسلة

يدعم OpenClaw أكثر من 13 منصة مراسلة جاهزة:

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

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

{
  channels: {
    whatsapp: {
      enabled: true,
      // الرسائل الشخصية تذهب للوكيل الرئيسي
    },
    slack: {
      enabled: true,
      // سلاك العمل يوجه لوكيل مختلف بمهارات خاصة بالعمل
      agent: {
        model: "anthropic/claude-opus-4-6",
        skills: ["jira-integration", "github-pr-review"],
      },
    },
  },
}

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

يدعم OpenClaw توجيه قنوات أو حسابات مختلفة لوكلاء معزولين بنماذج ومهارات وأذونات مختلفة. واتساب الشخصي يمكن أن يكون له وصول كامل للنظام، بينما قناة سلاك مشتركة تعمل في بيئة معزولة.

المهارات وClawHub: توسيع OpenClaw

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

المهارات هي إضافات توسع ما يمكن لـ OpenClaw فعله. تتراوح من قوالب توجيهات بسيطة إلى تكاملات TypeScript معقدة مع واجهات برمجة خارجية.

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

ClawHub (clawhub.ai) هو دليل المهارات المجتمعي مع آلاف المهارات عبر فئات مثل:

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

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

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

---
name: daily-standup
description: Generate a daily standup update from git commits
---

# Daily Standup Generator

Look at the git log for the last 24 hours in the current project directory.
Summarize what was accomplished, what's in progress, and any blockers.

Format the output as:

**Done:**
- [completed items]

**In Progress:**
- [current work]

**Blockers:**
- [any issues]

كتابة مهارة بـ TypeScript

للمنطق الأكثر تعقيداً:

import { Skill, SkillContext } from "openclaw/skills";

export default class PriceChecker extends Skill {
  name = "price-checker";
  description = "Check and compare prices across shopping sites";

  async execute(ctx: SkillContext) {
    const { query } = ctx.params;

    // استخدام أداة المتصفح المدمجة في OpenClaw
    const results = await ctx.browser.navigate(
      `https://www.google.com/search?q=${encodeURIComponent(query)}&tbm=shop`
    );

    const prices = await ctx.browser.extract("price listings");

    return ctx.reply(`Found ${prices.length} results for "${query}":\n${
      prices.map(p => `- ${p.title}: ${p.price}`).join("\n")
    }`);
  }
}

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

# من ClawHub
openclaw skill install daily-standup

# من مستودع GitHub
openclaw skill install github:username/my-skill

# قائمة المهارات المثبتة
openclaw skill list

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

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

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

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

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

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

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

**هذا الأسبوع (8):**
...

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

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

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

أنت: "خذ آخر مقالة مدونة في /posts/ai-agents.mdx وأنشئ
نسخاً لتويتر ولينكد إن وإنستجرام"

OpenClaw: تم! إليك ما حضّرته:

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

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

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

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

3. أتمتة DevOps

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

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

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

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

أنت: "نعم"

OpenClaw: جارٍ النشر...
✓ الخدمة A: نُشرت (v2.4.1)
✓ الخدمة B: نُشرت (v1.8.0)
✓ الخدمة C: نُشرت (v3.1.2)
جميع فحوصات الصحة ناجحة. اكتمل النشر.

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، لا تغادر بياناتك جهازك أبداً:

{
  agent: {
    model: "ollama/llama3.1:70b",
  },
}

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

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

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

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

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

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

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

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

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

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

• وضع الإقران (الافتراضي): المرسلون غير المعروفين يجب أن يقدموا كود إقران تحدده
• قائمة السماح: الموافقة صراحة على جهات اتصال محددة
• الحظر: رفض جميع المرسلين غير المعروفين

العزل

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

{
  agents: {
    defaults: {
      sandbox: {
        mode: "non-main",
        // الجلسات الرئيسية (الشخصية) تعمل على المضيف
        // جلسات المجموعات/القنوات تعمل في حاويات Docker
      },
    },
  },
}

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

تدقيق الأمان

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

openclaw doctor

هذا يفحص تكوينك بحثاً عن:

• منافذ أو نقاط نهاية مكشوفة
• مصادقة مفقودة
• وصول أدوات مفرط السماحية
• تكوينات قنوات غير آمنة

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

التشغيل على خادم بعيد

يمكنك تشغيل البوابة على VPS أو VM سحابي بينما التطبيقات المصاحبة على أجهزتك تتولى الإجراءات المحلية:

┌─────────────────────┐     ┌──────────────┐
│  خادم بعيد (VPS)     │     │    Mac خاصتك │
│  ┌───────────────┐  │     │  ┌────────┐  │
│  │   البوابة     │◄─┼─────┼──│ عقدة   │  │
│  │   + الوكيل   │  │ SSH/ │  │ macOS  │  │
│  └───────────────┘  │ Tail │  └────────┘  │
└─────────────────────┘ scale└──────────────┘
                              ┌──────────────┐
                              │  iPhone خاصتك │
                              │  ┌────────┐  │
                              │  │ عقدة   │  │
                              │  │  iOS   │  │
                              │  └────────┘  │
                              └──────────────┘

خيارات الوصول البعيد:

• Tailscale Serve/Funnel: موصى به — آمن، بدون تكوين للشبكة
• نفق SSH: النهج التقليدي، يتطلب إعادة توجيه المنافذ
• Docker: تشغيل البوابة بالكامل في حاوية

نشر Docker

docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  openclaw/openclaw:latest

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

تشغيل شخصيات وكيل مختلفة لسياقات مختلفة:

{
  agents: {
    personal: {
      model: "anthropic/claude-opus-4-6",
      skills: ["email-manager", "calendar", "meal-planner"],
      channels: ["whatsapp"],
    },
    work: {
      model: "anthropic/claude-opus-4-6",
      skills: ["jira", "github-pr", "slack-standup"],
      channels: ["slack"],
      sandbox: { mode: "always" },
    },
    family: {
      model: "ollama/llama3.1:8b",
      skills: ["recipes", "shopping-list"],
      channels: ["telegram"],
    },
  },
}

وضع الصوت والتنبيه الصوتي

على macOS و iOS و Android، يدعم OpenClaw التفاعل الصوتي الدائم:

• التنبيه الصوتي: قل كلمة التنبيه للتفعيل (يستخدم ElevenLabs)
• وضع الحديث: محادثة صوتية مستمرة، بدون أيدي
• اضغط للتحدث: اضغط مفتاحاً/زراً للتحدث (تطبيق شريط القوائم macOS)

اللوحة الحية

اللوحة الحية هي مساحة عمل بصرية يقودها الوكيل (A2UI — Agent-to-UI). يمكن للذكاء الاصطناعي إنشاء ومعالجة واجهات بصرية على جهازك، متجاوزاً الاستجابات النصية فقط.

نصائح الأداء

أوامر مفيدة

# إدارة البوابة
openclaw gateway --port 18789 --verbose    # تشغيل في المقدمة
openclaw gateway status                     # التحقق من التشغيل
openclaw dashboard                          # فتح واجهة التحكم

# المراسلة
openclaw message send --target +1234567890 --message "Hello"

# التفاعل مع الوكيل
openclaw agent --message "Ship checklist" --thinking high

# المهارات
openclaw skill install <skill-name>
openclaw skill list
openclaw skill remove <skill-name>

# الأمان
openclaw doctor                             # تدقيق التكوين

# التشخيص
openclaw logs                               # عرض السجلات الأخيرة
openclaw version                            # التحقق من الإصدار

البدء

هل أنت مستعد لإعداد مساعد الذكاء الاصطناعي الخاص بك؟ إليك المسار:

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

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