# كيفية تثبيت OpenClaw وربطه بـTelegram

خصّص نحو نصف ساعة للانتقال من جهاز غير مُعدّ إلى وكيل يجيبك على Telegram. الأوامر الواردة مأخوذة من الوثائق الرسمية، لذا قارنها بالإصدار الذي تثبّته.

## ما تحتاج إليه

- حاسوب أو VPS يعمل بنظام macOS أو Linux أو WSL2 أو Windows
- Node 24.16+ أو Node 26، ويمكن للمثبّت إضافتهما نيابةً عنك
- مفتاح API أو اشتراك لاستخدام أحد النماذج، أو نموذج محلي
- حساب Telegram

## خطوة بخطوة

### 1. اختر جهازًا وأنشئ روبوتًا

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

### 2. ثبّت OpenClaw

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

```bash
# 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 لضبط كل خيار. عند انتهاء الإعداد الأولي، أوقف البوابة التي تعمل في الواجهة الأمامية وثبّتها كخدمة تعمل في الخلفية كي يُعاد تشغيلها بعد إعادة تشغيل الجهاز.

```bash
openclaw onboard
# after the quick start, stop the foreground gateway (Ctrl+C), then:
openclaw gateway install
```

### 4. أضف قناة Telegram

أضف Telegram كقناة باستخدام رمز البوت. ثم تحقّق من حالة القناة للتأكد من أن الاتصال يعمل.

```bash
openclaw channels add --channel telegram --token <bot-token>
openclaw channels status --probe
```

### 5. وافق على الاقتران

أرسل أي رسالة إلى البوت. سيتلقى المرسلون غير المعروفين رمز اقتران بدلاً من رد، لذا اعرض الطلبات المعلّقة ووافق على الرمز الخاص بك خلال ساعة.

```bash
openclaw pairing list telegram
openclaw pairing approve telegram <CODE>
```

### 6. أجرِ تدقيقاً وحدّث

شغّل تدقيق الأمان المدمج وحدّث من القناة المستقرة. الإصدارات الأقدم من 2026.4.22 تتضمن ثغرات خطيرة معروفة، لذا لا تبقَ على إصدار قديم.

```bash
openclaw security audit
openclaw update --channel stable
```

## أول ما ينبغي فعله بعد الإعداد

- اترك dmPolicy مضبوطاً على pairing حتى لا يتمكن الغرباء الذين يعثرون على البوت من استخدامه.
- اضبط موافقات exec على السؤال دائماً إلى أن تثق بإعدادك.
- كرّر تدقيق الأمان والتحديث بانتظام.

## أخطاء شائعة

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