> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# تطبيق Linux

يدعم Gateway نظام Linux بالكامل. **Node هو وقت التشغيل الموصى به**.
لا يوصى باستخدام Bun مع Gateway (بسبب أخطاء WhatsApp/Telegram).

تطبيقات Linux المرافقة الأصلية مخطط لها. المساهمات مرحب بها إذا أردت المساعدة في بناء أحدها.

## المسار السريع للمبتدئين (VPS)

1. ثبّت Node 24 (موصى به؛ Node 22 LTS، حاليًا `22.19+`، لا يزال يعمل للتوافق)
2. `npm i -g openclaw@latest`
3. `openclaw onboard --install-daemon`
4. من حاسوبك المحمول: `ssh -N -L 18789:127.0.0.1:18789 <user>@<host>`
5. افتح `http://127.0.0.1:18789/` وصادِق باستخدام السر المشترك المكوَّن (الرمز افتراضيًا؛ أو كلمة المرور إذا عيّنت `gateway.auth.mode: "password"`)

دليل خادم Linux الكامل: [خادم Linux](/ar/vps). مثال VPS خطوة بخطوة: [exe.dev](/ar/install/exe-dev)

## التثبيت

* [بدء الاستخدام](/ar/start/getting-started)
* [التثبيت والتحديثات](/ar/install/updating)
* تدفقات اختيارية: [Bun (تجريبي)](/ar/install/bun)، [Nix](/ar/install/nix)، [Docker](/ar/install/docker)

## Gateway

* [دليل تشغيل Gateway](/ar/gateway)
* [التكوين](/ar/gateway/configuration)

## تثبيت خدمة Gateway (CLI)

استخدم أحد هذه الأوامر:

```
openclaw onboard --install-daemon
```

أو:

```
openclaw gateway install
```

أو:

```
openclaw configure
```

اختر **خدمة Gateway** عند مطالبتك.

الإصلاح/الترحيل:

```
openclaw doctor
```

## التحكم في النظام (وحدة مستخدم systemd)

يثبّت OpenClaw خدمة **مستخدم** في systemd افتراضيًا. استخدم خدمة **نظام**
للخوادم المشتركة أو التي تعمل دائمًا. يقوم `openclaw gateway install` و
`openclaw onboard --install-daemon` بالفعل بإنشاء الوحدة المرجعية الحالية
نيابةً عنك؛ اكتب واحدة يدويًا فقط عندما تحتاج إلى إعداد نظام/مدير خدمة
مخصص. توجد إرشادات الخدمة الكاملة في [دليل تشغيل Gateway](/ar/gateway).

الإعداد الأدنى:

أنشئ `~/.config/systemd/user/openclaw-gateway[-<profile>].service`:

```
[Unit]
Description=OpenClaw Gateway (profile: <profile>, v<version>)
After=network-online.target
Wants=network-online.target

[Service]
ExecStart=/usr/local/bin/openclaw gateway --port 18789
Restart=always
RestartSec=5
TimeoutStopSec=30
TimeoutStartSec=30
SuccessExitStatus=0 143
OOMPolicy=continue
KillMode=control-group

[Install]
WantedBy=default.target
```

فعّلها:

```
systemctl --user enable --now openclaw-gateway[-<profile>].service
```

## ضغط الذاكرة وعمليات القتل بسبب OOM

على Linux، تختار النواة ضحية OOM عندما تنفد الذاكرة في مضيف أو VM أو cgroup
لحاوية. قد يكون Gateway ضحية سيئة لأنه يملك جلسات واتصالات قنوات طويلة العمر.
لذلك يوجّه OpenClaw عمليات الأبناء العابرة لتُقتل قبل Gateway عندما يكون ذلك
ممكنًا.

بالنسبة إلى عمليات الأبناء المؤهلة على Linux، يبدأ OpenClaw العملية الفرعية عبر
غلاف قصير من `/bin/sh` يرفع قيمة `oom_score_adj` الخاصة بالعملية الفرعية إلى
`1000`، ثم ينفّذ الأمر الحقيقي باستخدام `exec`. هذه عملية لا تتطلب امتيازات
لأن العملية الفرعية تزيد فقط من احتمال قتلها بسبب OOM.

تشمل أسطح عمليات الأبناء المشمولة:

* عمليات أوامر فرعية يديرها المشرف،
* عمليات أبناء لأصداف PTY،
* عمليات أبناء لخوادم MCP stdio،
* عمليات المتصفح/Chrome التي يشغّلها OpenClaw.

الغلاف خاص بـ Linux فقط ويُتخطى عندما لا يكون `/bin/sh` متاحًا. كما يُتخطى إذا
عيّنت بيئة العملية الفرعية `OPENCLAW_CHILD_OOM_SCORE_ADJ=0` أو `false` أو
`no` أو `off`.

للتحقق من عملية فرعية:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
cat /proc/<child-pid>/oom_score_adj
```

القيمة المتوقعة للعمليات الفرعية المشمولة هي `1000`. يجب أن تحتفظ عملية Gateway
بدرجتها العادية، وغالبًا ما تكون `0`.

تعيّن وحدة systemd الموصى بها أيضًا `OOMPolicy=continue`. يحافظ ذلك على وحدة
Gateway حيّة عندما يختار قاتل OOM عملية فرعية عابرة؛ يمكن أن يفشل أمر/جلسة
العملية الفرعية ويبلّغ عن الخطأ دون أن يعتبر systemd خدمة Gateway بالكامل
فاشلة ويعيد تشغيل كل القنوات.

لا يحل هذا محل ضبط الذاكرة العادي. إذا كان VPS أو حاوية يقتل العمليات الفرعية
مرارًا، فزِد حد الذاكرة، أو قلّل التوازي، أو أضف عناصر تحكم أقوى في الموارد مثل
`MemoryMax=` في systemd أو حدود الذاكرة على مستوى الحاوية.

## ذو صلة

* [نظرة عامة على التثبيت](/ar/install)
* [خادم Linux](/ar/vps)
* [Raspberry Pi](/ar/install/raspberry-pi)