Hetzner

آماده‌سازی VPS

یک VPS مبتنی بر Ubuntu یا Debian در 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

برای مدیریت توکن پایدار Gateway از طریق .env، مقدار OPENCLAW_GATEWAY_TOKEN را تنظیم کنید؛ در غیر این صورت، پیش از اتکا به کلاینت‌ها در راه‌اندازی‌های مجدد، 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

برای فرایند مشترک میزبان 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 استفاده می‌کند؛ اگر به احراز هویت با گذرواژه تغییر داده‌اید، به‌جای آن گذرواژهٔ پیکربندی‌شدهٔ خود را وارد کنید.