إيزي رانر

​

قبل البدء

• خادم EasyRunner مع نطاق موجّه إليه.
• صورة OpenClaw الرسمية (ghcr.io/openclaw/openclaw) أو إصدارك الخاص.
• وحدة تخزين دائمة للإعدادات للمسار /home/node/.openclaw.
• وحدة تخزين دائمة لمساحة العمل للمسار /home/node/.openclaw/workspace.
• رمز مميز أو كلمة مرور قوية لـ Gateway.

​

تطبيق 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

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

​

التحقق

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

​

التحديثات والنسخ الاحتياطية

• اسحب صورة 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.
• فشل المتصفح أو Plugins الخاصة بالقنوات: تحقّق مما إذا كانت الملفات التنفيذية الخارجية المطلوبة، وإمكانية الوصول الصادر إلى الشبكة، وبيانات الاعتماد المركّبة متاحة داخل الحاوية.