تطبيق Linux

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

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

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

1. ثبّت Node 24 (موصى به؛ Node 22 LTS، حاليًا 22.16+، ما زال يعمل للتوافق)
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. مثال VPS خطوة بخطوة: exe.dev

# التثبيت

• البدء
• التثبيت والتحديثات
• مسارات اختيارية: Bun (تجريبي)، Nix، Docker

# Gateway

• دليل تشغيل Gateway
• التكوين

# تثبيت خدمة 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.

إعداد بسيط:

أنشئ ~/.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
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.

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

cat /proc/<child-pid>/oom_score_adj

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

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

# ذات صلة

• نظرة عامة على التثبيت
• خادم Linux
• Raspberry Pi