Ansible

​

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

​

ما ستحصل عليه

• أمان يبدأ بجدار الحماية: UFW + عزل Docker (لا يمكن الوصول إلا إلى SSH + Tailscale)
• شبكة Tailscale VPN للوصول عن بُعد دون كشف الخدمات علنًا
• Docker لحاويات بيئة الاختبار المعزولة ذات الارتباطات المحلية فقط
• تكامل Systemd مع التعزيز الأمني والتشغيل التلقائي عند الإقلاع
• إعداد بأمر واحد

​

البدء السريع

curl -fsSL https://raw.githubusercontent.com/openclaw/openclaw-ansible/main/install.sh | bash

​

ما يتم تثبيته

1. Tailscale (شبكة VPN شبكية للوصول الآمن عن بُعد)
2. جدار حماية UFW (منافذ SSH + Tailscale فقط)
3. Docker CE + Compose V2 (الواجهة الخلفية الافتراضية لبيئة اختبار الوكيل)
4. Node.js وpnpm (يتطلب OpenClaw إصدار Node 22.22.3+ أو 24.15+ أو 25.9+؛ ويوصى باستخدام Node 24)
5. OpenClaw، مثبّت على المضيف وليس داخل حاوية
6. خدمة systemd مزودة بتعزيز أمني

​

الإعداد بعد التثبيت

sudo -i -u openclaw

openclaw channels login --channel <name>

sudo systemctl status openclaw
sudo journalctl -u openclaw -f

​

أوامر سريعة

# التحقق من حالة الخدمة
sudo systemctl status openclaw

# عرض السجلات المباشرة
sudo journalctl -u openclaw -f

# إعادة تشغيل Gateway
sudo systemctl restart openclaw

# تسجيل الدخول إلى القناة (يُشغّل كمستخدم openclaw)
sudo -i -u openclaw
openclaw channels login --channel <name>

​

البنية الأمنية

1. جدار الحماية (UFW): لا يُكشف علنًا إلا SSH (22) وTailscale (41641/udp)
2. شبكة VPN ‏(Tailscale): لا يمكن الوصول إلى Gateway إلا عبر شبكة VPN الشبكية
3. عزل Docker: تمنع سلسلة iptables ‏DOCKER-USER كشف المنافذ خارجيًا
4. تعزيز Systemd: ‏NoNewPrivileges، وPrivateTmp، ومستخدم بلا امتيازات

nmap -p- YOUR_SERVER_IP

​

التثبيت اليدوي

sudo apt update && sudo apt install -y ansible git

git clone https://github.com/openclaw/openclaw-ansible.git
cd openclaw-ansible

ansible-galaxy collection install -r requirements.yml

./run-playbook.sh

ansible-playbook playbook.yml --ask-become-pass
# ثم شغّل: /tmp/openclaw-setup.sh

​

التحديث

cd openclaw-ansible
./run-playbook.sh

​

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

# التحقق من السجلات
sudo journalctl -u openclaw -n 100

# التحقق من الأذونات
sudo ls -la /opt/openclaw

# اختبار التشغيل اليدوي
sudo -i -u openclaw
cd ~/openclaw
openclaw gateway run

# التحقق من أن Docker قيد التشغيل
sudo systemctl status docker

# التحقق من صورة بيئة الاختبار
sudo docker images | grep openclaw-sandbox

# بناء صورة بيئة الاختبار إذا كانت مفقودة (يتطلب نسخة مصدر)
cd /opt/openclaw/openclaw
sudo -u openclaw ./scripts/sandbox-setup.sh
# لعمليات تثبيت npm دون نسخة مصدر، راجع
# https://docs.openclaw.ai/gateway/sandboxing#images-and-setup

sudo -i -u openclaw
openclaw channels login --channel <name>

​

التهيئة المتقدمة

• البنية الأمنية
• التفاصيل التقنية
• دليل استكشاف الأخطاء وإصلاحها

​

ذو صلة

• openclaw-ansible: دليل النشر الكامل
• Docker: إعداد Gateway داخل حاوية
• العزل في بيئة اختبار: تهيئة بيئة اختبار الوكيل
• بيئة اختبار متعددة الوكلاء والأدوات: عزل كل وكيل على حدة