Containers
ClawDock
ClawDock عبارة عن طبقة صغيرة من الأدوات المساعدة للصدفة لعمليات تثبيت OpenClaw المستندة إلى Docker.
وهي توفر لك أوامر قصيرة مثل clawdock-start وclawdock-dashboard وclawdock-fix-token بدلًا من استدعاءات docker compose ... الأطول.
إذا لم تكن قد أعددت Docker بعد، فابدأ بـDocker.
التثبيت
mkdir -p ~/.clawdock && curl -sL https://raw.githubusercontent.com/openclaw/openclaw/main/scripts/clawdock/clawdock-helpers.sh -o ~/.clawdock/clawdock-helpers.shecho 'source ~/.clawdock/clawdock-helpers.sh' >> ~/.zshrc && source ~/.zshrcإذا سبق لك تثبيت ClawDock من scripts/shell-helpers/clawdock-helpers.sh، فأعد تثبيته من المسار الحالي scripts/clawdock/clawdock-helpers.sh؛ فقد أُزيل مسار GitHub الخام القديم.
تكتشف الأدوات المساعدة نسخة OpenClaw المحلية تلقائيًا عند أول استخدام (عبر التحقق من المسارات الشائعة مثل ~/openclaw و~/projects/openclaw) وتخزّن النتيجة مؤقتًا في ~/.clawdock/config. عيّن CLAWDOCK_DIR بنفسك إذا كانت نسختك المحلية موجودة في مكان آخر.
ما الذي ستحصل عليه
العمليات الأساسية
| الأمر | الوصف |
|---|---|
clawdock-start |
تشغيل Gateway |
clawdock-stop |
إيقاف Gateway |
clawdock-restart |
إعادة تشغيل Gateway |
clawdock-status |
التحقق من حالة الحاوية |
clawdock-logs |
متابعة سجلات Gateway |
الوصول إلى الحاوية
| الأمر | الوصف |
|---|---|
clawdock-shell |
فتح صدفة داخل حاوية Gateway |
clawdock-cli <command> |
تشغيل أوامر CLI الخاصة بـOpenClaw في Docker |
clawdock-exec <command> |
تنفيذ أمر عشوائي داخل الحاوية |
واجهة الويب والإقران
| الأمر | الوصف |
|---|---|
clawdock-dashboard |
فتح عنوان URL لواجهة التحكم |
clawdock-devices |
عرض عمليات إقران الأجهزة المعلّقة |
clawdock-approve <id> |
الموافقة على طلب إقران |
الإعداد والصيانة
| الأمر | الوصف |
|---|---|
clawdock-fix-token |
كتابة رمز Gateway في إعدادات الحاوية |
clawdock-update |
السحب وإعادة البناء وإعادة التشغيل |
clawdock-rebuild |
إعادة بناء صورة Docker فقط |
clawdock-clean |
إزالة الحاويات ووحدات التخزين |
الأدوات المساعدة
| الأمر | الوصف |
|---|---|
clawdock-health |
إجراء فحص سلامة Gateway |
clawdock-token |
طباعة رمز Gateway |
clawdock-cd |
الانتقال إلى دليل مشروع OpenClaw |
clawdock-config |
فتح ~/.openclaw |
clawdock-show-config |
طباعة ملفات الإعدادات مع حجب القيم الحساسة |
clawdock-workspace |
فتح دليل مساحة العمل |
clawdock-help |
عرض جميع أوامر ClawDock |
سير العمل في المرة الأولى
clawdock-startclawdock-fix-tokenclawdock-dashboardإذا أشار المتصفح إلى أن الإقران مطلوب:
clawdock-devicesclawdock-approve <request-id>الإعدادات والأسرار
يقرأ ClawDock ملفي .env منفصلين، بما يتوافق مع التقسيم الموضح في Docker:
- ملف
.envالخاص بالمشروع بجوارdocker-compose.yml: قيم خاصة بـDocker مثل اسم الصورة والمنافذ وOPENCLAW_GATEWAY_TOKEN. يقرأclawdock-tokenالرمز من هنا. ~/.openclaw/.env(يُركّب داخل الحاوية): أسرار مدعومة بمتغيرات البيئة يديرها OpenClaw نفسه، إلى جانبopenclaw.jsonوagents/<agentId>/agent/auth-profiles.json.
ينسخ clawdock-fix-token الرمز من ملف .env الخاص بالمشروع إلى قيمتي الإعداد gateway.remote.token وgateway.auth.token داخل الحاوية، ثم يعيد تشغيل Gateway.
استخدم clawdock-show-config لفحص openclaw.json وملفي .env بسرعة؛ إذ يحجب قيم .env في المخرجات المطبوعة.
