​

تثبيت Ansible

​

المتطلبات المسبقة

​

ما الذي ستحصل عليه

• أمان يعتمد على الجدار الناري أولًا — عزل UFW + Docker (إتاحة SSH + Tailscale فقط)
• Tailscale VPN — وصول بعيد آمن من دون تعريض الخدمات للعامة
• Docker — حاويات sandbox معزولة وعمليات bind على localhost فقط
• دفاع متعدد الطبقات — بنية أمنية من 4 طبقات
• تكامل Systemd — بدء تلقائي عند الإقلاع مع تقوية أمنية
• إعداد بأمر واحد — نشر كامل خلال دقائق

​

البدء السريع

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

​

ما الذي سيتم تثبيته

1. Tailscale — VPN شبكي للوصول البعيد الآمن
2. UFW firewall — منافذ SSH + Tailscale فقط
3. Docker CE + Compose V2 — من أجل sandboxes الخاصة بالوكلاء
4. Node.js 24 + pnpm — تبعيات وقت التشغيل (ما زال Node 22 LTS، حاليًا 22.14+، مدعومًا)
5. OpenClaw — على المضيف مباشرة، وليس داخل حاوية
6. خدمة Systemd — بدء تلقائي مع تقوية أمنية

​

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

sudo -i -u openclaw

openclaw channels login

sudo systemctl status openclaw
sudo journalctl -u openclaw -f

​

أوامر سريعة

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

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

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

# تسجيل دخول المزوّد (شغّله كمستخدم openclaw)
sudo -i -u openclaw
openclaw channels login

​

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

1. الجدار الناري (UFW) — تعريض SSH (22) + Tailscale (41641/udp) فقط للعامة
2. VPN (Tailscale) — لا يمكن الوصول إلى البوابة إلا عبر شبكة VPN
3. عزل Docker — تمنع سلسلة DOCKER-USER في iptables تعريض المنافذ خارجيًا
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

# تحقق من صورة sandbox
sudo docker images | grep openclaw-sandbox

# ابنِ صورة sandbox إذا كانت مفقودة
cd /opt/openclaw/openclaw
sudo -u openclaw ./scripts/sandbox-setup.sh

sudo -i -u openclaw
openclaw channels login

​

التكوين المتقدم

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

​

ذو صلة

• openclaw-ansible — دليل النشر الكامل
• Docker — إعداد البوابة داخل حاوية
• Sandboxing — تكوين sandbox الخاصة بالوكلاء
• Multi-Agent Sandbox and Tools — العزل لكل وكيل