الانتقال إلى المحتوى الرئيسي

تطبيق Linux

تُدعَم Gateway بالكامل على Linux. Node هو وقت التشغيل الموصى به. ولا يُنصح باستخدام Bun مع Gateway (بسبب أخطاء WhatsApp/Telegram). التطبيقات المرافقة الأصلية لـ Linux مخطط لها. والمساهمات مرحب بها إذا كنت تريد المساعدة في بناء واحد منها.

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

  1. ثبّت Node 24 (موصى به؛ وما زال Node 22 LTS، حاليًا 22.14+، يعمل من أجل التوافق)
  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/ وصادق باستخدام السر المشترك المكوَّن (token افتراضيًا؛ أو password إذا ضبطت gateway.auth.mode: "password")
الدليل الكامل لخادم Linux: خادم Linux. ومثال VPS خطوة بخطوة: exe.dev

التثبيت

Gateway

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

استخدم إحدى الطرق التالية:
openclaw onboard --install-daemon
أو:
openclaw gateway install
أو:
openclaw configure
اختر Gateway service عندما يُطلب منك ذلك. الإصلاح/الترحيل:
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