تثبيت Clawdbot باستخدام Docker

نظرة عامة على Clawdbot Docker

Docker اختياري لـ Clawdbot. استخدمه فقط إذا كنت تريد بوابة محتواة أو للتحقق من صحة مسار Docker.

هل Docker مناسب لي؟

ملاحظة: يستخدم صندوق الحماية للوكلاء Docker أيضاً، لكنه لا يتطلب تشغيل البوابة الكاملة في Docker.

المتطلبات

• Docker Desktop (أو Docker Engine) + Docker Compose v2
• مساحة قرص كافية للصور + السجلات

البوابة المحتواة (Docker Compose)

البدء السريع (موصى به)

من جذر المستودع:

./docker-setup.sh

هذا السكريبت:

1. يبني صورة البوابة
2. يشغّل معالج الإعداد الأولي
3. يطبع تلميحات إعداد المزود الاختيارية
4. يبدأ البوابة عبر Docker Compose
5. ينشئ رمز البوابة ويكتبه في .env

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

بعد الانتهاء:

1. افتح http://127.0.0.1:18789/ في متصفحك
2. الصق الرمز في واجهة التحكم (الإعدادات → الرمز)

هل تحتاج إلى عنوان URL المرمز مرة أخرى؟

docker compose run --rm clawdbot-cli dashboard --no-open

المسار اليدوي (Compose)

docker build -t clawdbot:local -f Dockerfile .
docker compose run --rm clawdbot-cli onboard
docker compose up -d clawdbot-gateway

رمز واجهة التحكم + الإقران (Docker)

إذا رأيت "غير مصرح" أو "غير متصل (1008): الإقران مطلوب":

docker compose run --rm clawdbot-cli dashboard --no-open
docker compose run --rm clawdbot-cli devices list
docker compose run --rm clawdbot-cli devices approve <requestId>

التركيبات الإضافية (اختياري)

تركيب مجلدات مضيف إضافية في الحاويات:

export CLAWDBOT_EXTRA_MOUNTS="$HOME/.codex:/home/node/.codex:ro,$HOME/github:/home/node/github:rw"
./docker-setup.sh

الاحتفاظ بـ Home الحاوية (اختياري)

الاحتفاظ بـ /home/node عبر إعادة إنشاء الحاوية:

export CLAWDBOT_HOME_VOLUME="clawdbot_home"
./docker-setup.sh

تثبيت حزم إضافية (اختياري)

تثبيت حزم النظام داخل الصورة:

export CLAWDBOT_DOCKER_APT_PACKAGES="ffmpeg build-essential"
./docker-setup.sh

صندوق حماية الوكيل (أدوات Docker)

يمكن لـ Clawdbot استخدام Docker لصندوق حماية الوكلاء، مما يعزل أدوات الوكيل في حاويات.

ماذا يفعل

• يشغّل أدوات الوكيل (exec، browser، إلخ) في حاويات Docker معزولة
• يوفر حدود أمان بين الوكلاء
• يسمح بملفات تعريف صندوق الحماية لكل وكيل

تمكين صندوق الحماية

في clawdbot.json الخاص بك:

{
  "agents": {
    "defaults": {
      "sandbox": {
        "mode": "non-main"
      }
    }
  }
}

بناء صورة صندوق الحماية

clawdbot sandbox build

ملفات تعريف صندوق الحماية لكل وكيل

{
  "routing": {
    "agents": {
      "main": {
        "workspace": "~/.clawdbot/workspace",
        "sandbox": {
          "mode": "off"
        }
      },
      "untrusted": {
        "sandbox": {
          "mode": "always"
        }
      }
    }
  }
}

فحص الصحة

docker compose run --rm clawdbot-cli health
docker compose run --rm clawdbot-cli status

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

أخطاء الأذونات (EACCES)

إذا رأيت أخطاء في الأذونات، تحقق من أن المجلدات المركبة لديها الأذونات الصحيحة.

الحاوية لا تبدأ

1. تحقق من سجلات Docker: docker compose logs clawdbot-gateway
2. تأكد من أن المنفذ 18789 غير مستخدم
3. تأكد من أن Docker لديه موارد كافية

مشاكل الرمز

أعد إنشاء رمز البوابة:

docker compose run --rm clawdbot-cli configure --reset-token

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

• تثبيت Clawdbot - طرق تثبيت أخرى
• بوابة Clawdbot - تكوين البوابة
• إعداد Clawdbot - دليل الإعداد الكامل