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 # مالکیت را روی کاربر کانتینر تنظیم کنید (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

این فایل را commit نکنید. این فایل شامل متغیرهای محیطی کانتینر/محیط اجرا مانند 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:      # توصیه می‌شود: Gateway را روی VPS فقط به loopback محدود کنید؛ از طریق تونل SSH دسترسی داشته باشید.      # برای در دسترس قراردادن عمومی، پیشوند `127.0.0.1:` را حذف و دیوار آتش را متناسب با آن پیکربندی کنید.      - "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 استفاده می‌کند؛ اگر احراز هویت را به روش گذرواژه تغییر داده‌اید، به‌جای آن از گذرواژه پیکربندی‌شده استفاده کنید.