OpenClaw（جراد البحر） هو مشروع مفتوح المصدر لوكلاء الذكاء الاصطناعي (AI agent) الأسرع نموًا حاليًا على GitHub، يتيح لك إعداد مساعد ذكاء اصطناعي خاص يعمل دائمًا ومتصلًا على جهازك الشخصي، والتحدث معه عبر تطبيقات المراسلة التي تستخدمها عادةً مثل Telegram وWhatsApp وDiscord.
هذا الدليل الإرشادي يبدأ من الصفر، ويأخذك من التثبيت إلى الإعداد ثم إرسال أول رسالة—كل ذلك في حوالي 10 دقائق.
ما هو OpenClaw؟ وما الفرق بينه وبين ChatGPT؟
ChatGPT هو أداة للأسئلة والأجوبة؛ تسأله سؤالًا فيعطيك إجابة، وبعد اكتمال المحادثة تنتهي العملية. أما OpenClaw فهو وكيل ذكاء اصطناعي (AI agent): أنت تسلمه مهمة، فيفكر بنفسه، ويستدعي الأدوات، وينفذ الإجراءات—مثل التحقق من Gmail لديك، ومراجعة التقويم، والبحث على الويب، وكتابة البرامج—ثم يعرض لك النتائج.
والفرق الأكثر أهمية هو أن OpenClaw يعمل على جهازك أنت، والبيانات تحت سيطرتك بالكامل، ولن يتم رفعها إلى أي خوادم تابعة لجهات خارجية. وهو بذاته لا يتضمن نموذج ذكاء اصطناعي؛ إذ تحتاج إلى تزويده بنفسك بمفتاح API Key (Anthropic Claude أو OpenAI GPT أو Google Gemini أو غيرها كلها مناسبة). وتُدفع تكاليف النموذج مباشرة من قبلك إلى المزود.
التحضير قبل التثبيت
متطلبات النظام
macOS أو Linux أو Windows (يوصى باستخدام WSL2 لأن الاستقرار أعلى)
Node.js 22.14 أو أحدث (موصى به Node 24)
مفتاح API Key واحد على الأقل لمجموعة نماذج ذكاء اصطناعي
تثبيت Node.js
أولًا تحقق مما إذا كان مثبتًا وهل الإصدار مناسب:
node -v
إذا كان الإصدار أقل من v22.14 أو لم يكن مثبتًا بعد، اختر طريقة التثبيت حسب نظامك:
الحصول على AI model API Key
يدعم OpenClaw عدة مزودي نماذج؛ فيما يلي أكثر ثلاثة خيارات استخدامًا:
Anthropic Claude: انتقل إلى console.anthropic.com لإنشاء حساب، ثم أضف مفتاحًا في صفحة API Keys. يعد Claude Sonnet 4.x حاليًا الخيار الأكثر شيوعًا.
OpenAI GPT: انتقل إلى platform.openai.com وأنشئ API Key.
Google Gemini: انتقل إلى aistudio.google.com ويمكنك الحصول مجانًا على API Key.
انسخ API Key للاحتفاظ به؛ فستحتاج إلى لصقه أثناء التثبيت لاحقًا.
الخطوة الأولى: تثبيت OpenClaw
على macOS وLinux يكفي أمر واحد:
curl -fsSL | bash
بالنسبة لمستخدمي Windows، نفّذ في PowerShell:
iwr -useb | iex
بعد اكتمال التثبيت، تأكد أن الأمر يعمل:
openclaw --version
الخطوة الثانية: تشغيل مرشد Onboarding
نفّذ الأمر التالي لبدء معالج الإعداد التفاعلي، مع جعل OpenClaw يبدأ تلقائيًا كخدمة تعمل في الخلفية مع النظام:
openclaw onboard --install-daemon
سوف يطرح المرشد عدة أسئلة بالتسلسل:
اختيار مزود النموذج: اختر الجهة التي حصلت منها على API Key للتو (Anthropic أو OpenAI أو Google… إلخ)
لصق API Key: الصق المفتاح الذي نسخته للتو
اختيار النموذج: يُنصح باختيار أحدث النموذج الرئيسي (مثل claude-sonnet-4-5)
اختيار وضع التثبيت: للمبتدئين اختر QuickStart فقط؛ لأنه سيستخدم القيم الافتراضية لإكمال جميع الإعدادات
تستغرق العملية بالكامل حوالي 2 دقيقة؛ ومعظم الخيارات يمكن قبولها بالضغط على Enter لاستخدام القيم الافتراضية.
الخطوة الثالثة: تأكيد أن Gateway يعمل
openclaw gateway status
إذا رأيت أن Gateway يستمع على port 18789، فهذا يعني أن التثبيت ناجح.
افتح واجهة التحكم لتجربة ذلك في المتصفح:
openclaw dashboard
سيتم فتح Control UI في المتصفح، حيث يمكنك إرسال رسائل مباشرة إلى مساعد الذكاء الاصطناعي للتأكد أن كل شيء يعمل بشكل صحيح.
الخطوة الرابعة: ربط Telegram (أسرع طريقة للبدء)
Telegram هو قناة المراسلة المدعومة رسميًا من OpenClaw وهي الأكثر اكتمالًا، كما أن الإعداد سهل جدًا ولا يتطلب سوى Bot Token واحد.
4-1 التقدم بطلب Bot Token من BotFather
افتح Telegram وابحث عن @BotFather ثم افتحه (تأكد أن هناك علامة اختيار زرقاء رسمية بجانبه)
أرسل /newbot
اتبع التعليمات لإدخال اسم Bot (الاسم المعروض) وحساب Bot (يجب أن ينتهي بـ bot مثل my_ai_assistant_bot)
سيعطيك BotFather Token، بصيغة مثل 123456789:AAGxxxxxxxxxxxxxxxxx؛ انسخه
4-2 إعداد Token
حرر ملف إعدادات OpenClaw (المسار الافتراضي
~/.openclaw/config.json5
)، وأضف إعداد Telegram:
{ channels: { telegram: { enabled: true, botToken: “الصق Token الخاص بك هنا”, dmPolicy: “pairing”, }, }, }
4-3 إعادة تشغيل Gateway وإجراء الاقتران
openclaw gateway restart openclaw pairing list telegram
بعد ذلك، في Telegram ابحث عن Bot الذي أنشأته للتو وأرسل له أي رسالة—ستحصل على رمز اقتران. نفّذ:
openclaw pairing approve telegram <رمز الاقتران>
بعد الانتهاء، أرسل رسالة إلى Bot في Telegram، وستتلقى رد مساعد الذكاء الاصطناعي.
الأسئلة الشائعة FAQ
ماذا أفعل إذا ظهر خطأ في إصدار Node؟
نفّذ
node -v
للتحقق من الإصدار. إذا كان أقل من v22.14، أعد تثبيت Node.js وفقًا للجدول أعلاه. بالنسبة لمستخدمي macOS الذين قاموا بتثبيت Homebrew، يمكن الترقية عبر تشغيل brew upgrade node.
تعذر تشغيل Gateway؟
نفّذ
openclaw gateway status
لعرض رسالة الخطأ. أكثر الأسباب شيوعًا هي أن port 18789 مشغول، أو أن تنسيق API Key غير صحيح. يمكنك تشغيل openclaw configure لإعادة الإعداد.
كيف أغير API Key؟
نفّذ
openclaw configure
، ثم اختر خطوة Model/Auth لإعادة الإعداد.
هل يتم “حرق” Token باستمرار؟
في الحالة الافتراضية، يقوم OpenClaw باستدعاء واجهة API فقط عند استلام رسالة، وليس من أجل استهلاك Token بشكل عشوائي. لكن إذا قمت بتمكين بعض المهارات الآلية أو مهام الجدولة، يُنصح بإعداد حد أقصى للاستخدام الشهري في لوحة تحكم مزود النموذج لتجنب أي تجاوز غير مقصود في التكاليف.
ماذا يمكنني فعله بعد ذلك
ربط Gmail وGoogle Calendar بحيث يساعدك المساعد في إدارة رسائل البريد والجدول الزمني
تثبيت Skills لتوسيع قدرات المساعد (مثل بحث الويب وتنفيذ البرامج وإدارة الذاكرة وغيرها)
النشر على السحابة: عبر Cloudflare Tunnel ليظل جراد البحر متصلًا لمدة 24 ساعة (دروس متقدمة، وسيتم إصدارها قريبًا)
ظهر هذا المقال OpenClaw（جراد البحر AI）—دليل تثبيت كامل 2026: إعداد مساعد ذكاء اصطناعي شخصي من الصفر وربطه بـ Telegram لأول مرة في 链新闻 ABMedia.
