Platforms overview

EasyRunner

EasyRunner โฮสต์ OpenClaw Gateway เป็นแอปแบบคอนเทนเนอร์ขนาดเล็กที่อยู่หลังพร็อกซี Caddy คู่มือนี้ถือว่าคุณมีโฮสต์ EasyRunner ที่เรียกใช้แอป Compose ที่เข้ากันได้กับ Podman และยุติการเชื่อมต่อ HTTPS ผ่าน Caddy

ก่อนเริ่มต้น

เซิร์ฟเวอร์ EasyRunner ที่มีโดเมนกำหนดเส้นทางมายังเซิร์ฟเวอร์
อิมเมจ OpenClaw อย่างเป็นทางการ (ghcr.io/openclaw/openclaw) หรืออิมเมจที่คุณสร้างเอง
วอลุ่มการกำหนดค่าแบบถาวรสำหรับ /home/node/.openclaw
วอลุ่มพื้นที่ทำงานแบบถาวรสำหรับ /home/node/.openclaw/workspace
โทเค็นหรือรหัสผ่าน Gateway ที่คาดเดาได้ยาก

เปิดใช้การยืนยันตัวตนอุปกรณ์ไว้เมื่อเป็นไปได้ หากรีเวิร์สพร็อกซีของคุณไม่สามารถส่งต่อ ข้อมูลประจำตัวของอุปกรณ์ได้อย่างถูกต้อง ให้แก้ไขการตั้งค่าพร็อกซีที่เชื่อถือก่อน (ดู การยืนยันตัวตนผ่านพร็อกซีที่เชื่อถือ) ใช้การข้าม การยืนยันตัวตนที่เป็นอันตรายเฉพาะบนเครือข่ายส่วนตัวทั้งหมดที่ผู้ดำเนินการควบคุมเท่านั้น

แอป Compose

สร้างแอป EasyRunner พร้อมไฟล์ Compose ที่มีโครงสร้างดังนี้:

yaml

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 เข้าถึงได้ผ่านพร็อกซีเท่านั้น และกำหนดให้ต้องยืนยันตัวตน:

json5

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

หาก Caddy ยุติ TLS ให้ Gateway ให้กำหนดการตั้งค่าพร็อกซีที่เชื่อถือสำหรับ เส้นทางพร็อกซีที่แน่นอน แทนการปิดใช้การตรวจสอบการยืนยันตัวตนทั่วทั้งระบบ ดู การยืนยันตัวตนผ่านพร็อกซีที่เชื่อถือ

ตรวจสอบ

จากเครื่องเวิร์กสเตชันของคุณ:

bash

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 และในคำสั่ง ไคลเอนต์ภายในเครื่องพร้อมกัน
ไฟล์มี root เป็นเจ้าของหลังการกู้คืน: อิมเมจทำงานในฐานะ node (uid 1000) ให้แก้ไขวอลุ่มที่เมานต์เพื่อให้ผู้ใช้ดังกล่าวเขียนไปยัง /home/node/.openclaw และ /home/node/.openclaw/workspace ได้
เบราว์เซอร์หรือ Plugin ช่องทางทำงานล้มเหลว: ตรวจสอบว่าไบนารีภายนอกที่จำเป็น การเชื่อมต่อเครือข่ายขาออก และข้อมูลประจำตัวที่เมานต์พร้อมใช้งานภายใน คอนเทนเนอร์หรือไม่

Was this useful?