AgentDots
مرجع الوكلاء الشخصيين للذكاء الاصطناعي
  1. الصفحة الرئيسية
  2. الإعداد
  3. OpenClaw
الإعداد · نحو 30 دقيقة

كيفية تثبيت OpenClaw: دليل إعداد مع Telegram

خصّص نحو نصف ساعة للانتقال من جهاز خالٍ إلى وكيل تستضيفه بنفسك، ويرد عبر Telegram ويتبع قواعد تكتبها بنفسك.

خطوة بخطوة

  1. اختر مكان تشغيله

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

  2. ثبّت OpenClaw

    استخدم برنامج التثبيت الرسمي المناسب لنظامك. فهو يكتشف نظام التشغيل، ويثبّت Node إذا لم يكن موجوداً، ويُعدّ OpenClaw، ثم ينقلك إلى الإعداد الأولي.

    # macOS / Linux / WSL2
    curl -fsSL https://openclaw.ai/install.sh | bash
    
    # Windows (PowerShell)
    iwr -useb https://openclaw.ai/install.ps1 | iex
  3. أكمل الإعداد الأولي وشغّل البوابة كخدمة

    يتيح لك الإعداد الأولي اختيار Quick start، الذي يعيد استخدام أي وسيلة وصول إلى الذكاء الاصطناعي يعثر عليها، أو Custom setup الذي يعرض كل الخيارات. بعد إتمام الإعداد، أوقف البوابة التي تعمل في الواجهة الأمامية وسجّلها كخدمة تعمل في الخلفية، لتعود تلقائياً بعد إعادة التشغيل.

    openclaw onboard
    # stop the foreground gateway with Ctrl+C, then run it as a service:
    openclaw gateway install
  4. اربط Telegram

    في Telegram، افتح محادثة مع @BotFather وتحقق من اسم المستخدم بدقة، ثم أرسل /newbot واحتفظ بالرمز الذي تحصل عليه. سجّل Telegram كقناة باستخدام هذا الرمز، وأجرِ اختباراً للحالة للتحقق من الاتصال.

    openclaw channels add --channel telegram --token <bot-token>
    openclaw channels status --probe
  5. وافق على الاقتران

    أرسل رسالة إلى روبوتك. بدلاً من الرد، يمنح المرسلين غير المعروفين رمز اقتران؛ لذا راجع الطلبات المنتظرة ووافق على طلبك قبل انقضاء ساعة.

    openclaw pairing list telegram
    openclaw pairing approve telegram <CODE>
  6. أجرِ تدقيق الأمان وواكب التحديثات

    دع تدقيق الأمان المدمج في OpenClaw يفحص الإعدادات، وعالج كل ما يكشفه، ثم نزّل التحديثات من قناة الإصدارات المستقرة. كل إصدار صدر قبل 2026.4.22 معرّض لثغرات حرجة معروفة، لذا اجعل تشغيل كلا الأمرين جزءاً من روتينك.

    openclaw security audit
    openclaw update --channel stable
  7. اكتب قواعده الدائمة

    اكتب قواعدك بلغة واضحة في AGENTS.md داخل مساحة عمل الوكيل، وضع حدوداً صارمة مقابلة لها في ~/.openclaw/openclaw.json، مع التحقق من أسماء المفاتيح في وثائق إصدارك. أبقِ dmPolicy على وضع الاقتران، واجعل exec يطلب الموافقة في كل مرة إلى أن تطمئن إلى الإعداد.

الأسبوع الأول

اعتبر الأسبوع الأول فترة تجريبية. ينبغي أن تبقى البوابة على loopback، وأن يكون الوصول إليها عبر Tailscale أو SSH لا عبر منفذ مكشوف. أبقِ أوامر shell خاضعة للموافقة، وأضف مهارات الجهات الخارجية بحذر، ومن ناشرين تعرفهم فقط، وراقب استخدام النموذج يومياً، لأن الوكيل العالق في حلقة يواصل استهلاك الرموز. أعد تدقيق الأمان بعد كل تغيير في الإعدادات.

أخطاء ينبغي تجنبها

  • كشف البوابة على الإنترنت بدلاً من إبقاء gateway.bind مضبوطاً على loopback.
  • تثبيت عدد كبير من مهارات الجهات الخارجية، التي تستحق الحذر نفسه الذي تتعامل به مع إضافات المتصفح.
  • تشغيل إصدار قديم؛ فجميع الإصدارات الأقدم من 2026.4.22 تنطوي على ثغرات حرجة معروفة.