إذا كنت تريد مساعدًا يمكنك مراسلته من أي مكان (واتساب، تيليغرام، ديسكورد، سلاك، وغيرها) مع إبقاء “العقل” الخاص به يعمل على جهازك أنت، فإن OpenClaw صُمّم لهذا الأسلوب من العمل.

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

هذا المقال هو دليل البداية مع OpenClaw: ما هو، في ماذا يُستخدم، كيفية تثبيته على macOS وLinux وWindows (ويُفضَّل استخدام WSL2 على ويندوز)، كيفية تشغيل أول دردشة بنجاح، كيفية ربط قنوات الدردشة بشكل آمن، وماذا تفعل إذا واجهت مشكلة.

ما هو OpenClaw؟

OpenClaw هو Gateway مستضاف ذاتيًا (Self-Hosted) يربط تطبيقات المراسلة مثل واتساب وتيليغرام بمساعد تتحكم أنت فيه.

تشغّل عملية Gateway واحدة على جهازك أو الخادم الخاص بك، وهي توفر:

• واجهة تحكم (Control UI) يمكنك فتحها في المتصفح
• مكانًا واحدًا لربط عدة قنوات دردشة
• نظام تحكم محلي للجلسات وسير العمل المدعوم بالأدوات

بعبارة بسيطة:
أنت تراسل المساعد عبر التطبيقات التي تستخدمها بالفعل، بينما يقوم OpenClaw بتشغيل البنية التحتية على جهازك.

لماذا يستخدم الناس OpenClaw؟ (حالات الاستخدام)

إليك بعض الطرق الواقعية لاستخدام OpenClaw بعد تشغيله:

1. إنتاجية تعتمد على الدردشة

• اطلب تلخيص النصوص
• إعادة صياغة المسودات
• إنشاء قوائم مهام
• التخطيط ليومك من داخل محادثة واحدة

يمكنك الاحتفاظ بمحادثة واحدة تعمل كـ صندوق وارد موحّد للمهام وتحويل الرسائل إلى إجراءات.

2. الوصول من عدة قنوات إلى مساعد واحد

• مراسلة المساعد من واتساب عندما تكون بعيدًا عن جهازك
• استخدام تيليغرام في المجموعات لتذكيرات الفريق
• استخدام ديسكورد أو سلاك لأتمتة المجتمع أو العمل الداخلي

3. تحكم محلي وخصوصية أعلى

• تشغيل Gateway والإعدادات على جهازك الخاص
• تحديد القنوات المسموح لها بالاتصال
• تحديد من يمكنه إرسال الرسائل للمساعد
• تجنب فتح نقطة وصول عامة على الإنترنت عند عدم الحاجة

4. سير عمل آلي (اختياري)

بعد أن تصبح مرتاحًا في استخدام النظام، يمكنك إضافة قدرات أكثر تدريجيًا مثل:

• الموافقات (Approvals)
• قواعد الربط (Pairing rules)
• تنفيذ الأدوات
• سير عمل آلي لتنفيذ المهام

وكل ذلك دون تغيير طريقة الدردشة.

كيف يعمل OpenClaw؟ (نموذج مبسط)

فهم هذا الجزء يجعل التثبيت واستكشاف الأخطاء أسهل بكثير.

يتكون OpenClaw من:

• OpenClaw CLI
  أداة سطر الأوامر التي تقوم بتثبيتها (أوامر openclaw)
• Gateway
  خادم محلي (HTTP + WebSocket) يشغل واجهة التحكم ويتعامل مع القنوات
• Control UI
  لوحة التحكم التي تعمل في المتصفح وتتواصل مع Gateway
• Channels
  موصلات لتطبيقات مثل واتساب وتيليغرام وديسكورد وسلاك
• Config
  ملف الإعدادات (غالبًا داخل مجلد المستخدم)

عادة يعمل Gateway على المنفذ:

18789

لذلك تكون لوحة التحكم غالبًا على الرابط:

http://127.0.0.1:18789/

المتطلبات قبل التثبيت

قم بهذه الخطوات أولًا لتجنب المشاكل أثناء التثبيت.

1. تثبيت Node.js (الإصدار 22 أو أحدث)

تحقق من الإصدار عبر:

node --version

إذا لم يكن مثبتًا أو كان الإصدار قديمًا، يمكن لبرنامج تثبيت OpenClaw اكتشاف Node وتثبيته تلقائيًا.

2. مستخدمو Windows

يدعم OpenClaw ويندوز، لكن التجربة تكون أفضل غالبًا باستخدام WSL2.

3. التأكد من أن المنفذ 18789 غير مستخدم

إذا كان هناك تطبيق آخر يستخدم هذا المنفذ فلن يعمل Gateway أو لوحة التحكم.

يمكن تغييره لاحقًا لكن الأفضل البدء بالمنفذ الافتراضي.

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

هذه الطريقة هي الأسهل لأنها تقوم بكل شيء:

• التحقق من Node
• تثبيت CLI
• إعداد النظام

macOS / Linux / WSL2

افتح Terminal وشغّل:

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

Windows (PowerShell)

افتح PowerShell وشغّل:

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

بعد انتهاء التثبيت يجب أن يصبح أمر:

openclaw

متاحًا في النظام.

طريقة التثبيت الثانية (يدويًا): عبر npm أو pnpm

إذا كنت تفضّل التثبيت اليدوي:

npm

npm install -g openclaw@latest

pnpm

pnpm add -g openclaw@latest

بعد ذلك انتقل إلى مرحلة الإعداد.

الإعداد خطوة بخطوة وتشغيل أول دردشة

الخطوة 1: تشغيل معالج الإعداد

يقوم هذا بإعداد Gateway والمصادقة والقنوات.

openclaw onboard --install-daemon

اختيارات مقترحة أثناء الإعداد:

• Gateway location: محلي (Local)
• Auth: Token (أفضل للأمان)
• Channels: يمكنك تخطيها الآن لتجربة أول دردشة بسرعة

الخطوة 2: التأكد من أن Gateway يعمل

openclaw gateway status

الخطوة 3: فتح لوحة التحكم

openclaw dashboard

أو افتح المتصفح مباشرة:

http://127.0.0.1:18789/

الخطوة 4 (اختياري): تشغيل Gateway مع عرض السجلات

openclaw gateway --port 18789

ربط قنوات الدردشة

بعد التأكد من عمل لوحة التحكم يمكنك ربط القنوات.

بدء تسجيل الدخول للقنوات

openclaw channels login

يدعم OpenClaw:

• WhatsApp
• Telegram
• Discord
• Slack
• IRC
• Google Chat
• Feishu / Lark
• وغيرها عبر إضافات

إعداد واتساب

يتم غالبًا عبر QR Code.

نصائح:

• استخدم رقم واتساب مخصص للمساعد
• لا تسمح للجميع بالوصول

مثال إعداد بسيط يسمح لرقم واحد فقط:

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+15555550123"]
    }
  }
}

بعد حفظ الإعدادات أعد تشغيل Gateway.

إعداد تيليغرام

يتم عادة عبر Bot Token.

الخطوات:

1. إنشاء بوت
2. إدخال التوكن أثناء الإعداد
3. اختباره في محادثة خاصة
4. إضافته إلى مجموعة لاحقًا

إعداد Discord و Slack

يتم عبر إنشاء تطبيق Bot في بوابة المطورين الخاصة بكل منصة ثم إدخال بيانات الاعتماد.

ابدأ دائمًا بسيرفر أو Workspace تجريبي.

إعدادات الأمان المهمة

1. إبقاء Gateway محليًا

لا تعرضه مباشرة على الإنترنت.

استخدم:

127.0.0.1

2. استخدام المصادقة

استخدم Token authentication.

3. الحذر من المحتوى غير الموثوق

تعامل مع أي إضافات أو محتوى خارجي بحذر.

إذا احتجت وصولًا عن بعد استخدم نفق خاص (Private Tunnel) بدل فتح المنفذ للعامة.

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

يمكنك التحكم بمكان تخزين البيانات عبر:

OPENCLAW_HOME
OPENCLAW_STATE_DIR
OPENCLAW_CONFIG_PATH

استكشاف الأخطاء

المشكلة: الأمر openclaw غير موجود

openclaw: command not found

تحقق من PATH:

npm prefix -g
echo "$PATH"

الحل الشائع:

export PATH="$(npm prefix -g)/bin:$PATH"

المشكلة: لوحة التحكم لا تعمل

تحقق من Gateway:

openclaw gateway status

إذا لم يعمل:

openclaw gateway --port 18789

أو استخدم منفذًا آخر:

openclaw gateway --port 18889

ثم افتح:

http://127.0.0.1:18889/

المشكلة: الرسائل لا تصل

تحقق من:

• تسجيل الدخول للقناة
• قواعد السماح allowlist
• إعادة تشغيل Gateway بعد تعديل الإعدادات

اختبار سريع

يمكنك إرسال رسالة اختبار عبر CLI:

openclaw message send --target +15555550123 --message "Hello from OpenClaw"

الخطوات التالية بعد أول دردشة

بعد نجاح التشغيل الأول:

1. استمر باستخدام لوحة التحكم حتى يستقر النظام
2. أضف قناة واحدة فقط (واتساب أو تيليغرام)
3. فعّل قواعد السماح
4. بعدها استكشف ميزات الأتمتة

الخلاصة

يعمل OpenClaw بأفضل شكل عندما يكون الإعداد بسيطًا:

1. تثبيت CLI
2. تشغيل معالج الإعداد
3. التأكد من تشغيل Gateway
4. فتح لوحة التحكم
5. إضافة القنوات واحدة تلو الأخرى

باتباع هذا الترتيب ستحصل على بداية نظيفة وإعداد موثوق على المدى الطويل.