نشر الخادم: التشغيل لمدة 7×24 على Docker/VPS
السيناريوهات المناسبة
لقد نجحت بالفعل في تشغيل OpenClaw على جهازك المحلي، والآن تريد نقله إلى خادم VPS ليعمل بشكل دائم لمدة 7×24: قنوات الرسائل متاحة في أي وقت، والمهام تستمر في التنفيذ في الخلفية. أو أن خادمك لا تريد تثبيت بيئة Node عليه، وتحتاج إلى Gateway معزول داخل حاوية يمكن التخلص منها.
لنوضّح الموقع الرسمي أولًا: Docker خيار اختياري. إذا كنت تستخدمه يوميًا على حاسوبك الشخصي فقط، فالاستمرار في مسار التثبيت المعتاد أبسط؛ يستهدف Docker فئتين من الاحتياجات: «أجهزة استضافة بدون تثبيت محلي» و«بيئات معزولة للاستخدام مرة واحدة».
التحضيرات
تأكد من أربعة أمور قبل البدء:
- بيئة الحاويات: Docker Desktop أو Docker Engine، إضافة إلى Docker Compose v2.
- الذاكرة: بناء الصورة من المصدر محليًا يتطلب 6 GB من RAM على الأقل؛ يمكن استخدام الصورة المبنية مسبقًا لتجاوز هذا الحد.
- القرص: اترك مساحة كافية للصورة والسجلات.
- خط الأمان الأساسي: على VPS أو أي مضيف على الشبكة العامة، اقرأ أولًا وثيقة تحصين أمان الشبكة الرسمية، والتركيز على سلسلة جدار الحماية
DOCKER-USERالمدمجة في Docker — فقواعد iptables/ufw المعتادة قد لا تغطي حركة الحاويات.
قراءة تمهيدية: طرق تثبيت بديلة: تطبيق سطح المكتب وDocker وnpm.
اتبع خطواتي
الخطوة 1: الحصول على الصورة الرسمية
شغّل في الدليل الجذري للمستودع:
./scripts/docker/setup.shسيقوم هذا ببناء openclaw:local محليًا. الطريقة الأوفر للموارد هي استخدام الصورة المبنية مسبقًا مباشرة:
export OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw:latest"
./scripts/docker/setup.shGHCR هو السجل الرسمي الرئيسي، وهو المسؤول عن أتمتة النشر ونشر الإصدارات الثابتة والتحقق من المصدر؛ يُزامَن الإصدار نفسه أيضًا مع صورة Docker Hub openclaw/openclaw. اعتمد على هذين المصدرين فقط، ولا تستخدم صورًا من أطراف ثالثة — فوتيرة نشرها وسياسات الاحتفاظ لديها تختلف عن الرسمية.
يُنصح في بيئة الإنتاج بتثبيت وسم إصدار محدد (مثل 2026.9.3)، ولا تلاحق latest بشكل أعمى: إصدارات الإصدار المستقر تحرّك latest وmain، بينما إصدارات الصيانة في الشهر الختامي فقط هي التي تحرّك extended-stable. توجد أيضًا متغيرات أخرى اختيارية مثل slim وmain-slim وlatest-browser.
الخطوة 2: تشغيل حاوية Gateway
يقوم setup.sh بإتمام الإعداد الأولي تلقائيًا: يطلب إدخال مفتاح API للنموذج، ويولّد رمز Gateway ويكتبه في .env، ثم يشغّل Gateway عبر Docker Compose في النهاية.
تدفق الإعداد الأولي مطابق تمامًا للتثبيت المحلي: عملية Gateway واحدة هي حدود ثقة واحدة، والنماذج والقنوات تُضبط هنا.
الخطوة 3: التحصين للشبكة العامة والتشغيل الدائم
- جدار الحماية: شدّد المنافذ وفق قواعد التعرض للشبكة الرسمية، وتأكد من أن سلسلة
DOCKER-USERتغطي حركة الحاويات. - إعادة التشغيل التلقائي: اضبط سياسة إعادة تشغيل للحاوية، بحيث يستعيد Gateway عمله تلقائيًا بعد إعادة تشغيل VPS.
- عزل عدة مستخدمين: عند خدمة مستخدمين غير موثوقين ببعضهم، لا تشترك في Gateway واحد — شغّل Gateway مستقلًا لكل حدود ثقة، ويُفضَّل تحت مستخدمي نظام تشغيل مختلفين أو أجهزة مختلفة.
- الصندوق المعزول: يستخدم الواجهة الخلفية الافتراضية لصندوق Docker المعزول CLI الخاص بـ
dockerفقط؛ إذا أردت التبديل إلى Podman الأصلي فاضبط الواجهة الخلفية على"podman"؛ الصندوق المعزول معطل افتراضيًا، ولا يُشترط أن يعمل Gateway نفسه داخل حاوية.
نقاط التحقق
- حاوية Gateway في
docker psفي حالة تشغيل، وتعود تلقائيًا بعد إعادة تشغيل VPS. - الصورة مصدرها
ghcr.io/openclaw/openclawأوopenclaw/openclaw، ووسم الإصدار مثبّت. - قواعد سلسلة
DOCKER-USERمضبوطة وفق وثيقة التعرض للشبكة العامة. - كل مجموعة من المستخدمين غير الموثوقين ببعضهم تقابلها Gateway مستقلة، بدلًا من حاوية واحدة تخدم الجميع.
الحدود
- تسريع السحب داخل الصين: لم توفر الوثائق الرسمية تسريعًا لمرايا ghcr.io / Docker Hub، وهذه الصفحة لا تخمّن عناوين المرايا @@I18N_KEEP_000029@@؛ عند فشل السحب تحقق أولًا من اتصال الخادم بالإنترنت الخارجي ومن DNS.
- الإعدادات لا تتغير: Docker يغيّر وسيلة التشغيل فقط، وطريقة إعداد النماذج والقنوات وSkills مطابقة للنشر المحلي.
- فخ الإصدارات: سجّلت الوثائق الرسمية خطأً في رقم إصدار واحد — الإصدار
2026.9.1-beta.1المنشور على npm يقابل فعليًا2026.8.1-beta.4، وعند تثبيت وسوم الإصدارات التجريبية اعتمد على ملاحظات الإصدار.
الخطوة التالية
- انتقل إلىالدليل المتقدم: Skills وتحصين الأمان، واقرأ أولًاتحصين الأمان (3): الدفاع ضد حقن التعليمات وتدقيق الأمان — خط الدفاع التالي بعد التعرض للشبكة العامة.
- عند الحاجة إلى مقارنة مسارات التثبيت، راجعطرق تثبيت بديلة: تطبيق سطح المكتب وDocker وnpm.