تثبيت Docker

استخدم Docker لتشغيل OpenClaw في بيئة معزولة مع إعداد سريع وسهل.

البداية السريعة

# Pull الصورة الرسمية
docker pull openclaw/openclaw:latest

# تشغيل Container
docker run -d \
  --name openclaw \
  -p 3000:3000 \
  -v ~/.config/openclaw:/config \
  openclaw/openclaw:latest

استخدام Docker Compose

أنشئ ملف docker-compose.yml:

version: '3.8'

services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw-gateway
    ports:
      - "3000:3000"
    volumes:
      - ./config:/config
      - ./data:/data
    environment:
      - NODE_ENV=production
      - GATEWAY_PORT=3000
    restart: unless-stopped
    
  # خدمات إضافية اختيارية
  redis:
    image: redis:alpine
    container_name: openclaw-redis
    restart: unless-stopped
    
  postgres:
    image: postgres:15-alpine
    container_name: openclaw-db
    environment:
      - POSTGRES_DB=openclaw
      - POSTGRES_USER=openclaw
      - POSTGRES_PASSWORD=${DB_PASSWORD}
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgres_data:

ثم شغّل:

docker-compose up -d

متغيرات البيئة

المتغيرات المهمة:

  • GATEWAY_PORT - منفذ Gateway (افتراضي: 3000)
  • NODE_ENV - البيئة (افتراضي: production)
  • CONFIG_DIR - دليل التكوين (افتراضي: /config)
  • DATA_DIR - دليل البيانات (افتراضي: /data)

Volumes والبيانات المستمرة

Volumes الموصى بها:

  • /config - ملفات التكوين
  • /data - قاعدة البيانات والبيانات المستمرة
  • /logs - سجلات التطبيق

الشبكات

لربط OpenClaw بخدمات أخرى، استخدم شبكة Docker مخصصة:

# إنشاء شبكة
docker network create openclaw-network

# تشغيل مع الشبكة
docker run -d \
  --name openclaw \
  --network openclaw-network \
  -p 3000:3000 \
  openclaw/openclaw:latest

بناء صورة مخصصة

للتخصيص المتقدم، يمكنك بناء صورتك الخاصة:

# Clone المستودع
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# بناء الصورة
docker build -t my-openclaw:latest .

# تشغيل الصورة المخصصة
docker run -d --name openclaw my-openclaw:latest

فحوصات الصحة

للتأكد من عمل Container بشكل صحيح:

# فحص الحالة
docker ps
docker logs openclaw

# فحص الصحة
docker exec openclaw openclaw gateway status

التحديثات

# Pull أحدث صورة
docker pull openclaw/openclaw:latest

# إيقاف وحذف Container القديم
docker stop openclaw
docker rm openclaw

# تشغيل Container جديد
docker run -d \
  --name openclaw \
  -p 3000:3000 \
  -v ~/.config/openclaw:/config \
  openclaw/openclaw:latest

# أو باستخدام Docker Compose
docker-compose pull
docker-compose up -d

استكشاف الأخطاء

Container يتوقف فورًا

تحقق من السجلات:

docker logs openclaw

مشاكل الصلاحيات

تأكد من صلاحيات المجلدات:

chmod -R 755 ~/.config/openclaw