إعداد OpenClaw مع Claude Code و Gemini 3 Pro (بسرعة وسهولة)

ماذا لو تمكنت من التحكم في Claude Code أو Gemini 3 Pro من واتساب أو تيليجرام دون الحاجة إلى استخدام طرفية؟ يجعل OpenClaw هذا ممكنًا، محولًا نماذج الذكاء الاصطناعي المفضلة لديك إلى مساعدين يعتمدون على الرسائل يمكنك الدردشة معهم من أي مكان.

المشكلة: الوصول إلى الذكاء الاصطناعي مقيدًا بالطرفية

تشغل Claude Code و Gemini 3 Pro نماذج ذكاء اصطناعي قوية، لكنها تربطك بالطرفية أو نافذة المتصفح. لا يمكنك إرسال الأوامر أثناء ابتعادك عن مكتبك. لا يمكنك التحقق من الحالة أثناء تنقلك. لا يمكنك تفويض المهام دون الجلوس أمام لوحة المفاتيح.

يحل OpenClaw هذه المشكلة بإنشاء بوابة بين نماذج الذكاء الاصطناعي ومنصات المراسلة. يعمل محليًا على جهازك، ويتصل بـ Claude Code أو Gemini 3 Pro باستخدام بيانات اعتماد واجهة برمجة التطبيقات (API) الحالية لديك، وينقل الرسائل عبر تيليجرام أو واتساب أو ديسكورد أو سلاك. تحصل على إمكانيات الذكاء الاصطناعي الكاملة من خلال واجهات الدردشة المألوفة.

تثبيت OpenClaw

OpenClaw يتطلب Node.js 22 أو أعلى. تحقق من تثبيتك:

node -v

• قم بتثبيت OpenClaw باستخدام المثبت الرسمي:

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

يكتشف المثبت نظام التشغيل الخاص بك، ويتحقق من التبعيات، ويتعامل مع الإعداد تلقائيًا. لا حاجة لاستنساخ المستودعات أو التكوين اليدوي.

• يقوم مستخدمو Windows بتشغيل ما يعادله في PowerShell:

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

بعد اكتمال التثبيت، يطلق OpenClaw واجهة مستخدم طرفية تفاعلية (TUI). ترشدك هذه الواجهة القائمة على المحادثة خلال الإعداد باستخدام مطالبات باللغة الطبيعية بدلاً من ملفات التكوين المعقدة.

التحقق بعد التثبيت

تحقق من تثبيت OpenClaw بشكل صحيح عن طريق التحقق من إصداره:

openclaw --version

يجب أن تعرض الطرفية رقم الإصدار الحالي. إذا رأيت خطأ "لم يتم العثور على الأمر"، فتأكد من أن Node.js موجود في مسار PATH الخاص بك وأعد تشغيل الطرفية. يضيف المثبت OpenClaw إلى مسار التنفيذ الخاص بنظامك تلقائيًا، ولكن بعض واجهات الأوامر تتطلب إعادة تشغيل للتعرف على الأوامر الجديدة.

تكوين Claude Code و Gemini 3 Pro

يدعم OpenClaw العديد من موفري الذكاء الاصطناعي. يمكنك استخدام Claude Code عبر واجهة برمجة تطبيقات Anthropic أو Gemini 3 Pro عبر واجهة برمجة تطبيقات Google — أيهما تملك بيانات اعتماده بالفعل.

لـ Gemini 3 Pro (جوجل):

حدد "Google" (لـ Google Gemini 3 Pro) من قائمة موفري النموذج. اختر طريقة المصادقة الخاصة بك:

• مفتاح API لـ Google Gemini - مصادقة مباشرة بواسطة مفتاح API
• Google Antigravity OAuth - يستخدم مكونًا إضافيًا للمصادقة المدمجة
• Google Gemini CLI OAuth - تدفق OAuth عبر سطر الأوامر

يعمل خيار مفتاح API لـ Gemini على الفور إذا كان لديك مفتاح من Google AI Studio. تتطلب خيارات OAuth مصادقة المتصفح ولكنها توفر أمانًا محسنًا.

لـ Claude Code (Anthropic):

أثناء معالج الإعداد الأولي، حدد "Anthropic" (لـ Claude Code) كمزود للنموذج الخاص بك. أدخل مفتاح API الخاص بك عند المطالبة:

openclaw onboard
# Select: Anthropic API Key
# Enter: sk-ant-api03-your-key-here

مفاتيح API لـ Anthropic متاحة على console.anthropic.com. يخزن OpenClaw مفتاحك بأمان في ~/.openclaw/openclaw.json.

هيكل ملف التكوين

يتم حفظ اختياراتك في ~/.openclaw/openclaw.json:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-opus-4-5"
      }
    }
  },
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-..."
  }
}

قم بتبديل النماذج في أي وقت عن طريق تعديل هذا الملف أو إعادة تشغيل openclaw onboard.

استراتيجية اختيار النموذج

اختر نموذجك الأساسي بناءً على متطلبات المهمة. يتفوق Claude Code في الاستدلال المعقد، وتوليد الشفرات، وسير العمل القائم على الوكلاء الذي يتطلب استخدام الأدوات. يقدم Gemini 3 Pro أوقات استجابة أسرع وقدرات قوية متعددة الوسائط لمهام الرؤية. يدعم كلا النموذجين استدعاء الدوال ونوافذ سياق موسعة. يمكنك تكوين نماذج احتياطية في نفس ملف التكوين. إذا واجه نموذجك الأساسي حدودًا للمعدل أو أخطاء، يتحول OpenClaw تلقائيًا إلى النموذج الاحتياطي:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-opus-4-5",
        "fallback": "google/gemini-3-pro"
      }
    }
  }
}

يضمن هذا التشغيل المستمر حتى عندما يواجه أحد الموفرين توقفًا عن العمل.

التخزين المؤقت للمطالبات (Anthropic فقط)

يقوم OpenClaw بتمكين التخزين المؤقت للمطالبات تلقائيًا لنماذج Anthropic. يقلل هذا من التكاليف للمطالبات المتكررة المتشابهة. مدة التخزين المؤقت الافتراضية هي 5 دقائق (احتفاظ short). قم بتمديدها إلى ساعة واحدة بإضافة علامة بيتا extended-cache-ttl-2025-04-11 في تكوينك.

إعداد قنوات المراسلة في OpenClaw

يدعم OpenClaw ثماني منصات مراسلة. يوفر تيليجرام وواتساب الإعداد الأكثر بساطة للمستخدمين الذين يفضلون واجهات الدردشة على الطرفيات.

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

يستخدم تيليجرام واجهة برمجة تطبيقات البوت (Bot API)، مما يوفر مصادقة نظيفة بدون أكواد QR.

أنشئ بوتًا عبر @BotFather في تيليجرام:

1. افتح تيليجرام وابحث عن @BotFather
2. أرسل /newbot واتبع المطالبات
3. اختر اسمًا (مثل "مساعد OpenClaw الخاص بي")
4. اختر اسم مستخدم ينتهي بـ "bot" (مثل "myclawbot")
5. انسخ رمز API المقدم

أثناء الإعداد الأولي لـ OpenClaw، الصق هذا الرمز عند المطالبة. تتصل البوابة على الفور وتعرض رسالة تأكيد.

إعداد واتساب

يستخدم واتساب اقتران رمز الاستجابة السريعة (QR) عبر بروتوكول واتساب ويب.

قم بتشغيل أمر تسجيل الدخول للقناة:

openclaw channels login

يظهر رمز QR في طرفيتك. امسحه ضوئيًا باستخدام هاتفك:

1. افتح واتساب ← الإعدادات ← الأجهزة المرتبطة
2. اضغط على "ربط جهاز"
3. امسح رمز QR المعروض

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

الأمان: اقتران القناة

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

openclaw pairing approve telegram <CODE>

يمنع هذا الوصول غير المصرح به حتى لو اكتشف شخص ما اسم مستخدم البوت الخاص بك. يمكنك تكوين الموافقة التلقائية لجهات الاتصال الموثوق بها في ~/.openclaw/openclaw.json إذا كنت تفضل ذلك.

قنوات متعددة

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

تكوين أمان القناة

تحكم في من يمكنه التفاعل مع مساعد الذكاء الاصطناعي الخاص بك باستخدام قوائم السماح (allowlists). قم بتكوينها في ~/.openclaw/openclaw.json:

قائمة السماح لتليجرام:

{
  "channels": {
    "telegram": {
      "token": "YOUR_BOT_TOKEN",
      "allowedChatIds": [123456789, 987654321]
    }
  }
}

قائمة السماح لواتساب:

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+1234567890", "+0987654321"]
    }
  }
}

يمنع تقييد الوصول المستخدمين غير المصرح لهم من استهلاك حصة واجهة برمجة التطبيقات (API) الخاصة بك أو الوصول إلى مساعد الذكاء الاصطناعي الخاص بك. بدون قائمة سماح، يمكن لأي شخص يكتشف اسم مستخدم البوت الخاص بك إرسال رسائل وتشغيل طلبات الذكاء الاصطناعي.

إدارة وكيل OpenClaw للذكاء الاصطناعي الخاص بك

بمجرد التكوين، تفاعل مع وكيل الذكاء الاصطناعي الخاص بك من خلال رسائل اللغة الطبيعية. يقوم OpenClaw بمعالجة نصك، وإرساله إلى Claude Code أو Gemini 3 Pro، وإرجاع الاستجابة عبر منصة المراسلة الخاصة بك.

الأوامر الأساسية

أرسل أي مطالبة مباشرة:

Analyze the code in ~/projects/myapp and suggest optimizations

تحقق من حالة النظام:

/status

يعرض هذا النموذج النشط، واستخدام الرموز، والتكلفة الحالية.

المهارات والإضافات

يستخدم OpenClaw "مهارات" — مجلدات من الأدوات التي توسع الإمكانيات. قم بتمكين المهارات أثناء الإعداد الأولي أو أضفها لاحقًا:

• الوصول إلى نظام الملفات - قراءة الملفات وكتابتها وإدارتها
• أتمتة المتصفح - تصفح المواقع الإلكترونية، استخراج البيانات
• البحث عبر الويب - محركات البحث مع ملخصات النتائج
• تكامل البريد الإلكتروني - إرسال واستقبال رسائل البريد الإلكتروني
• الوصول إلى التقويم - جدولة واسترداد الأحداث

تُكوّن المهارات تلقائيًا عند تمكينها. يتعلم البوت الأدوات المتاحة ويستدعيها بناءً على طلباتك باللغة الطبيعية.

لوحة التحكم على الويب

يمكنك الوصول إلى واجهة الإدارة على http://localhost:18789 (أو المنفذ الذي قمت بتكوينه). تعرض لوحة التحكم ما يلي:

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

يوفر هذا بديلاً لإدارة الطرفية للمستخدمين الذين يفضلون الواجهات الرسومية.

الذاكرة المستمرة

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

قم بتكوين الاستبقاء في ~/.openclaw/openclaw.json:

{
  "memory": {
    "enabled": true,
    "database": "./data/openclaw.db",
    "retention_days": 90
  }
}

أوامر إدارة الذاكرة

امسح سجل المحادثات إذا أصبحت الاستجابات غير متناسقة أو كنت ترغب في البدء من جديد: openclaw memory clear

صدر الذاكرة للنسخ الاحتياطي أو التحليل: openclaw memory export > backup.json

استورد الذكريات التي تم تصديرها مسبقًا: openclaw memory import backup.json

تحتوي ملفات الذاكرة على سجل المحادثات والتفضيلات المتعلمة. قم بتخزين النسخ الاحتياطية بأمان — قد تحتوي على معلومات حساسة من التفاعلات السابقة.

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

يتطلب OpenClaw نماذج بطول سياق لا يقل عن 64 ألف رمز. يتجاوز Claude Code و Gemini 3 Pro هذا المتطلب. إذا كنت تستخدم نماذج محلية عبر Ollama، فتحقق من طول السياق:

ollama show <model> --modelfile

زد الطول باستخدام Modelfile مخصص إذا لزم الأمر:

FROM <model>
PARAMETER num_ctx 65536

التشغيل كخدمة

قم بتمكين التشغيل التلقائي عند الإقلاع عن طريق تثبيت الخفي (daemon) أثناء الإعداد الأولي:

openclaw onboard --install-daemon

أو ابدأ يدويًا:

openclaw gateway --port 18789 --verbose

تعمل البوابة بشكل مستمر، وتعالج الرسائل وتحافظ على اتصالات القنوات. تحقق من الحالة في أي وقت:

openclaw gateway status

اعتبارات الأمان

قم بتشغيل OpenClaw كمستخدم غير مميز. اعزلها على خادم افتراضي خاص (VPS) أو جهاز مخصص إذا أمكن. راجع أذونات المهارات قبل التمكين — يتيح الوصول إلى نظام الملفات للبوت قراءة وكتابة الملفات في أي مكان يملك فيه المستخدم أذونات.

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

تحديث OpenClaw

حافظ على تحديث OpenClaw لتلقي التصحيحات الأمنية والميزات الجديدة:

npm update -g openclaw

أو أعد تشغيل المثبت:

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

راجع سجل التغييرات قبل التحديثات الرئيسية. تظل ملفات التكوين متوافقة عبر الإصدارات، ولكن قد تتطلب الميزات الجديدة تعديلات في التكوين.

أنماط أوامر OpenClaw المتقدمة

استخدم أوامر الشرطة المائلة للتحكم في سلوك OpenClaw مباشرة من الدردشة: /run default "Analyze this codebase"

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

فرض مستويات استدلال محددة: Ship checklist /think high

تنشط علامة /think high وضع الاستدلال الموسع للمشكلات المعقدة. استخدم /think low للاستعلامات البسيطة لتقليل وقت الاستجابة واستهلاك الرموز.

تشغيل أتمتة المتصفح: Book the cheapest flight to Berlin next month

يطلق OpenClaw متصفحًا، ويبحث في مجمعات الرحلات الجوية، ويقارن الأسعار، ويعيد أفضل خيار مع روابط الحجز.

الخلاصة

يحول OpenClaw كلاً من Claude Code و Gemini 3 Pro من أدوات مقيدة بالطرفية إلى مساعدين للرسائل يسهل الوصول إليهم. تقوم بتكوينه مرة واحدة باستخدام بيانات اعتماد واجهة برمجة التطبيقات (API) الموجودة لديك، وتربط منصة المراسلة المفضلة لديك، وتتفاعل من خلال الدردشة الطبيعية. يتعامل الذكاء الاصطناعي الخاص بك مع المهام المعقدة بينما تظل متنقلاً.

عند بناء عمليات تكامل واجهة برمجة التطبيقات (API) — سواء كنت تختبر نقاط نهاية OpenClaw، أو تصحح تدفقات المصادقة، أو تدير تكوينات موفرين متعددين — قم بتبسيط تطويرك باستخدام Apidog. إنه يوفر اختبارًا مرئيًا لواجهة برمجة التطبيقات، وإنشاء وثائق تلقائيًا، وأدوات تصحيح الأخطاء التعاونية التي تكمل سير عمل مساعد الذكاء الاصطناعي الخاص بك.