Get started
ClawDock
ClawDock یک لایهٔ کوچک از ابزارهای کمکی پوسته برای نصبهای مبتنی بر Docker در OpenClaw است.
این لایه بهجای فراخوانیهای طولانیتر docker compose ...، فرمانهای کوتاهی مانند clawdock-start، clawdock-dashboard و clawdock-fix-token در اختیارتان میگذارد.
اگر هنوز 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 |
بازکردن نشانی رابط کاربری کنترل |
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 را دوباره راهاندازی میکند.
برای بررسی سریع openclaw.json و هر دو فایل .env از clawdock-show-config استفاده کنید؛ این فرمان مقادیر .env را در خروجی چاپشده میپوشاند.
