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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

شغّل OpenClaw Gateway دائمًا على DigitalOcean Droplet (حوالي 6 دولارات شهريًا لخطة Basic بسعة 1 GB). DigitalOcean هو أبسط مسار VPS مدفوع. إذا كنت تفضل خيارات أرخص أو مجانية:
  • Hetzner — 3.79 يورو/شهر، مع أنوية/RAM أكثر مقابل كل دولار.
  • Oracle Cloud — Always Free ARM (حتى 4 OCPU و24 GB RAM)، لكن التسجيل قد يكون متقلبًا وهو ARM فقط.

​
المتطلبات الأساسية

  • حساب DigitalOcean (التسجيل)
  • زوج مفاتيح SSH (أو الاستعداد لاستخدام مصادقة كلمة المرور)
  • حوالي 20 دقيقة

​
الإعداد

1

إنشاء Droplet

استخدم صورة أساسية نظيفة (Ubuntu 24.04 LTS). تجنّب صور Marketplace ذات التثبيت بنقرة واحدة من جهات خارجية ما لم تكن قد راجعت سكربتات بدء التشغيل وإعدادات الجدار الناري الافتراضية الخاصة بها.
  1. سجّل الدخول إلى DigitalOcean.
  2. انقر على Create > Droplets.
  3. اختر:
    • المنطقة: الأقرب إليك
    • الصورة: Ubuntu 24.04 LTS
    • الحجم: Basic، Regular، ‏1 vCPU / ‏1 GB RAM / ‏25 GB SSD
    • المصادقة: مفتاح SSH (موصى به) أو كلمة مرور
  4. انقر على Create Droplet ودوّن عنوان IP.
2

الاتصال والتثبيت

ssh root@YOUR_DROPLET_IP

apt update && apt upgrade -y

# Install Node.js 24
curl -fsSL https://deb.nodesource.com/setup_24.x | bash -
apt install -y nodejs

# Install OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash

# Create the non-root user that will own OpenClaw state and services.
adduser openclaw
usermod -aG sudo openclaw
loginctl enable-linger openclaw

su - openclaw
openclaw --version
استخدم صدفة root فقط لتهيئة النظام الأساسية. شغّل أوامر OpenClaw كمستخدم غير root باسم openclaw حتى تكون الحالة ضمن /home/openclaw/.openclaw/ ويُثبَّت Gateway كخدمة systemd لذلك المستخدم.
3

تشغيل الإعداد الأولي

openclaw onboard --install-daemon
يرشدك المعالج خلال مصادقة النموذج، وإعداد القناة، وتوليد رمز Gateway، وتثبيت daemon ‏(systemd).
4

إضافة swap (موصى به لـ Droplets بسعة 1 GB)

fallocate -l 2G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
echo '/swapfile none swap sw 0 0' >> /etc/fstab
5

التحقق من Gateway

openclaw status
systemctl --user status openclaw-gateway.service
journalctl --user -u openclaw-gateway.service -f
6

الوصول إلى واجهة التحكم

يرتبط Gateway بـ loopback افتراضيًا. اختر أحد هذه الخيارات.الخيار أ: نفق SSH (الأبسط)
# From your local machine
ssh -L 18789:localhost:18789 root@YOUR_DROPLET_IP
ثم افتح http://localhost:18789.الخيار ب: Tailscale Serve
curl -fsSL https://tailscale.com/install.sh | sudo sh
sudo tailscale up
openclaw config set gateway.tailscale.mode serve
openclaw gateway restart
ثم افتح https://<magicdns>/ من أي جهاز على tailnet الخاص بك.يصادق Tailscale Serve حركة مرور واجهة التحكم وWebSocket عبر ترويسات هوية tailnet، وهذا يفترض أن مضيف Gateway نفسه موثوق. تتبع نقاط نهاية HTTP API وضع المصادقة العادي الخاص بـ Gateway (رمز/كلمة مرور) بغض النظر عن ذلك. لطلب بيانات اعتماد shared-secret صريحة عبر Serve، عيّن gateway.auth.allowTailscale: false واستخدم gateway.auth.mode: "token" أو "password".الخيار ج: ربط Tailnet (بدون Serve)
openclaw config set gateway.bind tailnet
openclaw gateway restart
ثم افتح http://<tailscale-ip>:18789 (يتطلب رمزًا).

​
الاستمرارية والنسخ الاحتياطية

توجد حالة OpenClaw ضمن:
  • ~/.openclaw/ — openclaw.json، وauth-profiles.json لكل وكيل، وحالة القنوات/المزوّدين، وبيانات الجلسات.
  • ~/.openclaw/workspace/ — مساحة عمل الوكيل (SOUL.md، والذاكرة، والآثار).
تبقى هذه البيانات بعد إعادة تشغيل Droplet. لأخذ لقطة محمولة: 
openclaw backup create
تنسخ لقطات DigitalOcean كامل Droplet احتياطيًا؛ أما openclaw backup create فهو قابل للنقل بين المضيفين.

​
نصائح RAM بسعة 1 GB

يمتلك Droplet بسعر 6 دولارات RAM بسعة 1 GB فقط. للحفاظ على سلاسة التشغيل:
  • تأكد من أن خطوة swap أعلاه موجودة في /etc/fstab حتى تبقى بعد إعادة التشغيل.
  • فضّل النماذج المعتمدة على API ‏(Claude، GPT) على النماذج المحلية — استدلال LLM المحلي لا يناسب 1 GB.
  • عيّن agents.defaults.model.primary إلى نموذج أصغر إذا واجهت أخطاء OOM مع المطالبات الكبيرة.
  • راقب باستخدام free -h وhtop.

​
استكشاف الأخطاء وإصلاحها

Gateway لا يبدأ — شغّل openclaw doctor --non-interactive وتحقق من السجلات باستخدام journalctl --user -u openclaw-gateway.service -n 50. المنفذ مستخدم بالفعل — شغّل lsof -i :18789 للعثور على العملية، ثم أوقفها. نفاد الذاكرة — تحقق من أن swap نشط باستخدام free -h. إذا استمرت أخطاء OOM، فاستخدم النماذج المعتمدة على API ‏(Claude، GPT) بدلًا من النماذج المحلية، أو رقّ إلى Droplet بسعة 2 GB.

​
الخطوات التالية

​
ذو صلة