ایزی‌رانر

EasyRunner، Gateway متعلق به OpenClaw را به‌صورت یک برنامهٔ کوچک کانتینری پشت پراکسی Caddy خود میزبانی می‌کند. این راهنما فرض می‌کند میزبان EasyRunner برنامه‌های Compose سازگار با Podman را اجرا می‌کند و HTTPS را از طریق Caddy خاتمه می‌دهد.

پیش از شروع

• یک سرور EasyRunner که دامنه‌ای به آن هدایت شده باشد.
• ایمیج رسمی OpenClaw (ghcr.io/openclaw/openclaw) یا بیلد خودتان.
• یک والیوم پیکربندی پایدار برای /home/node/.openclaw.
• یک والیوم فضای کاری پایدار برای /home/node/.openclaw/workspace.
• یک توکن یا گذرواژهٔ قوی برای Gateway.

در صورت امکان، احراز هویت دستگاه را فعال نگه دارید. اگر پراکسی معکوس شما نمی‌تواند هویت دستگاه را به‌درستی منتقل کند، ابتدا تنظیمات پراکسی مورداعتماد را اصلاح کنید (به احراز هویت پراکسی مورداعتماد مراجعه کنید)؛ تنها در یک شبکهٔ کاملاً خصوصی و تحت کنترل گرداننده از دور زدن‌های خطرناک احراز هویت استفاده کنید.

برنامهٔ Compose

در EasyRunner برنامه‌ای با یک فایل Compose به شکل زیر ایجاد کنید:

services:  openclaw:    image: ghcr.io/openclaw/openclaw:latest    restart: unless-stopped    environment:      OPENCLAW_GATEWAY_TOKEN: ${OPENCLAW_GATEWAY_TOKEN}      OPENCLAW_HOME: /home/node      OPENCLAW_STATE_DIR: /home/node/.openclaw      OPENCLAW_CONFIG_PATH: /home/node/.openclaw/openclaw.json      OPENCLAW_WORKSPACE_DIR: /home/node/.openclaw/workspace    volumes:      - openclaw-config:/home/node/.openclaw      - openclaw-workspace:/home/node/.openclaw/workspace    labels:      caddy: openclaw.example.com      caddy.reverse_proxy: "{{upstreams 1455}}"    command: ["node", "openclaw.mjs", "gateway", "--bind", "lan", "--port", "1455"] volumes:  openclaw-config:  openclaw-workspace:

openclaw.example.com را با نام میزبان Gateway خود جایگزین کنید. OPENCLAW_GATEWAY_TOKEN را به‌جای ثبت در تعریف برنامه، در مدیر اسرار/محیط EasyRunner ذخیره کنید. ایمیج به‌طور پیش‌فرض به local loopback متصل می‌شود، بنابراین --bind lan --port 1455 صریح در command لازم است تا Caddy بتواند به کانتینر دسترسی پیدا کند.

پیکربندی OpenClaw

درون والیوم پیکربندی پایدار، Gateway را فقط از طریق پراکسی قابل دسترس نگه دارید و احراز هویت را الزامی کنید:

{  gateway: {    bind: "lan",    port: 1455,    auth: {      token: "${OPENCLAW_GATEWAY_TOKEN}",    },  },}

اگر Caddy اتصال TLS را برای Gateway خاتمه می‌دهد، به‌جای غیرفعال کردن سراسری بررسی‌های احراز هویت، تنظیمات پراکسی مورداعتماد را برای مسیر دقیق پراکسی پیکربندی کنید. به احراز هویت پراکسی مورداعتماد مراجعه کنید.

بررسی

از ایستگاه کاری خود:

openclaw gateway probe --url https://openclaw.example.com --token <token>openclaw gateway status --url https://openclaw.example.com --token <token>

در میزبان EasyRunner، GET /healthz (فعال‌بودن) و GET /readyz (آمادگی) به احراز هویت نیاز ندارند و مبنای بررسی سلامت داخلی کانتینر در ایمیج هستند. همچنین گزارش‌های برنامه را بررسی کنید تا Gateway در حال گوش‌دادن باشد و هیچ خطای احراز هویت هنگام راه‌اندازی برای SecretRef، Plugin یا کانال وجود نداشته باشد.

به‌روزرسانی‌ها و پشتیبان‌گیری

• ایمیج جدید OpenClaw را دریافت یا بیلد کنید، سپس برنامهٔ EasyRunner را دوباره مستقر کنید.
• پیش از به‌روزرسانی‌ها از والیوم openclaw-config پشتیبان بگیرید. این والیوم شامل openclaw.json،‏ agents/<agentId>/agent/auth-profiles.json و وضعیت بسته‌های Plugin نصب‌شده است.
• اگر عامل‌ها داده‌های پایدار پروژه را در openclaw-workspace می‌نویسند، از آن پشتیبان بگیرید.
• پس از به‌روزرسانی‌های عمده، openclaw doctor را اجرا کنید تا مهاجرت‌های پیکربندی و هشدارهای سرویس شناسایی شوند.

عیب‌یابی

• gateway probe نمی‌تواند متصل شود: تأیید کنید نام میزبان Caddy به برنامه اشاره می‌کند و کانتینر روی 0.0.0.0:1455 در حال گوش‌دادن است.
• احراز هویت ناموفق است: توکن را به‌طور هم‌زمان در اسرار EasyRunner و فرمان کارخواه محلی تعویض کنید.
• پس از بازیابی، مالک فایل‌ها کاربر ریشه است: ایمیج با کاربر node (uid 1000) اجرا می‌شود؛ والیوم‌های متصل‌شده را اصلاح کنید تا آن کاربر بتواند در /home/node/.openclaw و /home/node/.openclaw/workspace بنویسد.
• مرورگر یا Pluginهای کانال ناموفق هستند: بررسی کنید فایل‌های اجرایی خارجی موردنیاز، دسترسی خروجی شبکه و اطلاعات اعتبارسنجی متصل‌شده درون کانتینر در دسترس باشند.