تطبيق 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. مثال 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.targetWants=network-online.target [Service]ExecStart=/usr/local/bin/openclaw gateway --port 18789Restart=alwaysRestartSec=5TimeoutStopSec=30TimeoutStartSec=30SuccessExitStatus=0 143OOMPolicy=continueKillMode=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.

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

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

ذو صلة

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