> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# OpenClaw
# OpenClaw 🦞
> *«قَشِّر! قَشِّر!»* — جراد بحر فضائي، على الأرجح
بوابة تعمل على أي نظام تشغيل لوكلاء الذكاء الاصطناعي عبر WhatsApp وTelegram وDiscord وiMessage وغيرها.
أرسل رسالة، واحصل على رد من وكيل مباشرة من جيبك. تضيف الإضافات دعم Mattermost وغيرها.
ثبّت OpenClaw وشغّل Gateway خلال دقائق.
إعداد موجّه باستخدام `openclaw onboard` وتدفّقات الاقتران.
شغّل لوحة التحكم في المتصفح للدردشة والتهيئة والجلسات.
## ما هو OpenClaw؟
OpenClaw هو **Gateway مُستضاف ذاتيًا** يربط تطبيقات الدردشة المفضلة لديك — WhatsApp وTelegram وDiscord وiMessage وغيرها — بوكلاء ذكاء اصطناعي للبرمجة مثل Pi. تقوم بتشغيل عملية Gateway واحدة على جهازك (أو على خادم)، لتصبح الجسر بين تطبيقات المراسلة ومساعد ذكاء اصطناعي متاح دائمًا.
**لمن هو؟** للمطوّرين والمستخدمين المتقدمين الذين يريدون مساعد ذكاء اصطناعي شخصيًا يمكن مراسلته من أي مكان — من دون التخلّي عن التحكم في بياناتهم أو الاعتماد على خدمة مُستضافة.
**ما الذي يجعله مختلفًا؟**
* **استضافة ذاتية**: يعمل على عتادك، وفق قواعدك
* **تعدد القنوات**: Gateway واحد يخدم WhatsApp وTelegram وDiscord وغيرها في الوقت نفسه
* **مُهيّأ للوكلاء**: مبني لوكلاء البرمجة مع استخدام الأدوات والجلسات والذاكرة والتوجيه متعدد الوكلاء
* **مفتوح المصدر**: بترخيص MIT ومدفوع بالمجتمع
**ما الذي تحتاجه؟** Node 22+، ومفتاح API (يوصى بـ Anthropic)، و5 دقائق.
## كيف يعمل
```mermaid theme={"theme":{"light":"min-light","dark":"min-dark"}}
flowchart LR
A["Chat apps + plugins"] --> B["Gateway"]
B --> C["Pi agent"]
B --> D["CLI"]
B --> E["Web Control UI"]
B --> F["macOS app"]
B --> G["iOS and Android nodes"]
```
Gateway هو مصدر الحقيقة الوحيد للجلسات والتوجيه واتصالات القنوات.
## القدرات الرئيسية
WhatsApp وTelegram وDiscord وiMessage باستخدام عملية Gateway واحدة.
أضف Mattermost وغيرها عبر حزم التوسعة.
جلسات معزولة لكل وكيل أو مساحة عمل أو مُرسِل.
إرسال واستقبال الصور والصوتيات والمستندات.
لوحة تحكم في المتصفح للدردشة والتهيئة والجلسات والعُقد.
إقران عُقد iOS وAndroid مع دعم Canvas.
## البدء السريع
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
npm install -g openclaw@latest
```
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --install-daemon
```
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw channels login
openclaw gateway --port 18789
```
هل تحتاج إلى التثبيت الكامل وإعداد التطوير؟ راجع [البدء السريع](/start/quickstart). انظر [البداية السريعة](/start/quickstart).
## لوحة التحكم
افتح واجهة التحكّم في المتصفح بعد بدء Gateway.
* الإعداد الافتراضي المحلي: [http://127.0.0.1:18789/](http://127.0.0.1:18789/)
* الوصول عن بُعد: [واجهات الويب](/web) و[Tailscale](/gateway/tailscale)
## التهيئة (اختياري)
توجد التهيئة في `~/.openclaw/openclaw.json`.
* إذا **لم تفعل شيئًا**، يستخدم OpenClaw ملف Pi التنفيذي المضمّن في وضع RPC مع جلسات لكل مُرسِل.
* إذا أردت تقييد الإعدادات، فابدأ بـ `channels.whatsapp.allowFrom` ومع (للمجموعات) قواعد الذِكر.
مثال:
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
channels: {
whatsapp: {
allowFrom: ["+15555550123"],
groups: { "*": { requireMention: true } },
},
},
messages: { groupChat: { mentionPatterns: ["@openclaw"] } },
}
```
## ابدأ من هنا
جميع المستندات والأدلة، منظّمة حسب حالة الاستخدام.
إعدادات Gateway الأساسية والرموز وتهيئة الموفّرين.
أنماط الوصول عبر SSH وtailnet.
إعدادات خاصة بالقنوات لـ WhatsApp وTelegram وDiscord وغيرها.
عُقد iOS وAndroid مع الاقتران وCanvas.
حلول شائعة ونقطة بدء لاستكشاف الأخطاء وإصلاحها.
## تعرّف على المزيد
قدرات القنوات والتوجيه والوسائط بالكامل.
عزل مساحات العمل والجلسات لكل وكيل.
الرموز وقوائم السماح وضوابط السلامة.
تشخيص Gateway والأخطاء الشائعة.
أصول المشروع والمساهمون والترخيص.