Hetzner

จัดเตรียม VPS

สร้าง Ubuntu หรือ Debian VPS ใน Hetzner จากนั้นเชื่อมต่อด้วยสิทธิ์ root:

ssh root@YOUR_VPS_IP

ให้ถือว่า VPS เป็นโครงสร้างพื้นฐานที่มีสถานะ ไม่ใช่โครงสร้างพื้นฐานที่สามารถทิ้งและสร้างใหม่ได้ตลอดเวลา

ติดตั้ง Docker (บน VPS)

apt-get updateapt-get install -y git curl ca-certificatescurl -fsSL https://get.docker.com | sh

ตรวจสอบ:

docker --versiondocker compose version

โคลนรีโพซิทอรี OpenClaw

git clone https://github.com/openclaw/openclaw.gitcd openclaw

คู่มือนี้สร้างอิมเมจแบบกำหนดเอง เพื่อให้ไบนารีที่คุณรวมไว้ยังคงอยู่หลังการรีสตาร์ต

สร้างไดเรกทอรีถาวรบนโฮสต์

คอนเทนเนอร์ Docker เป็นแบบชั่วคราว สถานะที่ต้องคงอยู่ระยะยาวทั้งหมดจึงต้องอยู่บนโฮสต์

mkdir -p /root/.openclaw/workspace # Set ownership to the container user (uid 1000):chown -R 1000:1000 /root/.openclaw

กำหนดค่าตัวแปรสภาพแวดล้อม

สร้าง .env ที่รากของรีโพซิทอรี:

OPENCLAW_IMAGE=openclaw:latestOPENCLAW_GATEWAY_TOKEN=OPENCLAW_GATEWAY_BIND=lanOPENCLAW_GATEWAY_PORT=18789 OPENCLAW_CONFIG_DIR=/root/.openclawOPENCLAW_WORKSPACE_DIR=/root/.openclaw/workspace GOG_KEYRING_PASSWORD=XDG_CONFIG_HOME=/home/node/.openclaw

ตั้งค่า OPENCLAW_GATEWAY_TOKEN เพื่อจัดการโทเค็น Gateway แบบคงที่ผ่าน .env มิฉะนั้น ให้กำหนดค่า gateway.auth.token ก่อนใช้งานไคลเอนต์ ข้ามการรีสตาร์ต หากไม่ได้ตั้งค่าทั้งสองอย่าง OpenClaw จะใช้โทเค็นที่ใช้ได้ เฉพาะในรันไทม์สำหรับการเริ่มทำงานครั้งนั้น สร้างรหัสผ่านพวงกุญแจสำหรับ GOG_KEYRING_PASSWORD:

openssl rand -hex 32

ห้ามคอมมิตไฟล์นี้ ไฟล์นี้เก็บตัวแปรสภาพแวดล้อมของคอนเทนเนอร์/รันไทม์ เช่น OPENCLAW_GATEWAY_TOKEN ส่วนข้อมูลยืนยันตัวตน OAuth/คีย์ API ของผู้ให้บริการที่จัดเก็บไว้จะอยู่ใน ~/.openclaw/agents/<agentId>/agent/auth-profiles.json ที่เมานต์ไว้

การกำหนดค่า Docker Compose

สร้างหรืออัปเดต docker-compose.yml:

services:  openclaw-gateway:    image: ${OPENCLAW_IMAGE}    build: .    restart: unless-stopped    env_file:      - .env    environment:      - HOME=/home/node      - NODE_ENV=production      - TERM=xterm-256color      - OPENCLAW_GATEWAY_BIND=${OPENCLAW_GATEWAY_BIND}      - OPENCLAW_GATEWAY_PORT=${OPENCLAW_GATEWAY_PORT}      - OPENCLAW_GATEWAY_TOKEN=${OPENCLAW_GATEWAY_TOKEN}      - GOG_KEYRING_PASSWORD=${GOG_KEYRING_PASSWORD}      - XDG_CONFIG_HOME=${XDG_CONFIG_HOME}      - PATH=/home/linuxbrew/.linuxbrew/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin    volumes:      - ${OPENCLAW_CONFIG_DIR}:/home/node/.openclaw      - ${OPENCLAW_WORKSPACE_DIR}:/home/node/.openclaw/workspace    ports:      # Recommended: keep the Gateway loopback-only on the VPS; access via SSH tunnel.      # To expose it publicly, remove the `127.0.0.1:` prefix and firewall accordingly.      - "127.0.0.1:${OPENCLAW_GATEWAY_PORT}:18789"    command:      [        "node",        "dist/index.js",        "gateway",        "--bind",        "${OPENCLAW_GATEWAY_BIND}",        "--port",        "${OPENCLAW_GATEWAY_PORT}",        "--allow-unconfigured",      ]

--allow-unconfigured มีไว้เพื่อความสะดวกในการเริ่มต้นระบบเท่านั้น ไม่สามารถใช้แทนการกำหนดค่า Gateway ที่เหมาะสมได้ คุณยังต้องตั้งค่าการยืนยันตัวตน (gateway.auth.token หรือรหัสผ่าน) และโหมดการผูกเครือข่ายที่ปลอดภัยสำหรับการปรับใช้ของคุณ

ขั้นตอนรันไทม์ Docker VM ที่ใช้ร่วมกัน

ทำตามคู่มือรันไทม์ที่ใช้ร่วมกันสำหรับขั้นตอนทั่วไปบนโฮสต์ Docker:

• รวมไบนารีที่จำเป็นไว้ในอิมเมจ
• สร้างและเริ่มใช้งาน
• ข้อมูลใดคงอยู่ที่ตำแหน่งใด
• การอัปเดต

การเข้าถึงเฉพาะสำหรับ Hetzner

หลังจากทำขั้นตอนสร้างและเริ่มใช้งานในคู่มือที่ใช้ร่วมกันแล้ว ให้เปิดทันเนล

ข้อกำหนดเบื้องต้น: ตรวจสอบว่าการกำหนดค่า sshd ของ VPS อนุญาตการส่งต่อ TCP หากคุณ เพิ่มความเข้มงวดให้การกำหนดค่า SSH ให้ตรวจสอบ /etc/ssh/sshd_config และตั้งค่า:

AllowTcpForwarding local

local อนุญาตการส่งต่อภายในด้วย ssh -L จากแล็ปท็อปของคุณ พร้อมทั้งบล็อก การส่งต่อระยะไกลจากเซิร์ฟเวอร์ หากตั้งค่าเป็น no ทันเนลจะล้มเหลวพร้อมข้อความ: channel 3: open failed: administratively prohibited: open failed

หลังจากยืนยันว่าเปิดใช้งานการส่งต่อ TCP แล้ว ให้รีสตาร์ตบริการ SSH (systemctl restart ssh) และเรียกใช้ทันเนลจากแล็ปท็อป:

ssh -N -L 18789:127.0.0.1:18789 root@YOUR_VPS_IP

เปิด http://127.0.0.1:18789/ แล้ววางข้อมูลลับที่ใช้ร่วมกันซึ่งกำหนดค่าไว้ โดยค่าเริ่มต้น คู่มือนี้ใช้โทเค็น Gateway หากคุณเปลี่ยนไปใช้การยืนยันตัวตน ด้วยรหัสผ่าน ให้ใช้รหัสผ่านที่กำหนดค่าไว้แทน