GCP

نصب gcloud CLI (یا استفاده از Console)

آن را از cloud.google.com/sdk/docs/install نصب کنید، سپس:

gcloud initgcloud auth login

یا تمام مراحل زیر را از طریق رابط وب Cloud Console انجام دهید.

ایجاد پروژه GCP

gcloud projects create my-openclaw-project --name="OpenClaw Gateway"gcloud config set project my-openclaw-projectgcloud services enable compute.googleapis.com

صورت‌حساب را در console.cloud.google.com/billing فعال کنید (برای Compute Engine الزامی است).

معادل آن در Console: ‏IAM & Admin > Create Project، صورت‌حساب را فعال کنید، سپس APIs & Services > Enable APIs > "Compute Engine API" > Enable.

ایجاد ماشین مجازی

gcloud compute instances create openclaw-gateway \  --zone=us-central1-a \  --machine-type=e2-small \  --boot-disk-size=20GB \  --image-family=debian-12 \  --image-project=debian-cloud

ورود به ماشین مجازی از طریق SSH

gcloud compute ssh openclaw-gateway --zone=us-central1-a

در Console: در داشبورد Compute Engine، کنار ماشین مجازی روی "SSH" کلیک کنید.

انتشار کلید SSH پس از ایجاد ماشین مجازی ممکن است 1-2 دقیقه طول بکشد؛ اگر اتصال رد شد، صبر کنید و دوباره تلاش کنید.

نصب Docker (روی ماشین مجازی)

sudo apt-get updatesudo apt-get install -y git curl ca-certificatescurl -fsSL https://get.docker.com | sudo shsudo usermod -aG docker $USER

برای اعمال تغییر گروه، خارج شوید و دوباره وارد شوید، سپس مجدداً از طریق SSH متصل شوید:

exit

gcloud compute ssh openclaw-gateway --zone=us-central1-a

بررسی کنید:

docker --versiondocker compose version

کلون‌کردن مخزن OpenClaw

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

این راهنما یک ایمیج سفارشی می‌سازد تا همه فایل‌های اجرایی تعبیه‌شده در راه‌اندازی‌های مجدد باقی بمانند.

ایجاد دایرکتوری‌های ماندگار میزبان

کانتینرهای Docker موقتی هستند؛ تمام وضعیت بلندمدت باید روی میزبان نگهداری شود.

mkdir -p ~/.openclawmkdir -p ~/.openclaw/workspace

پیکربندی متغیرهای محیطی

فایل .env را در ریشه مخزن ایجاد کنید:

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

برای مدیریت توکن پایدار Gateway از طریق .env، مقدار OPENCLAW_GATEWAY_TOKEN را تنظیم کنید؛ در غیر این صورت، پیش از اتکا به کلاینت‌ها در راه‌اندازی‌های مجدد، gateway.auth.token را پیکربندی کنید. اگر هیچ‌کدام تنظیم نشده باشد، OpenClaw برای همان راه‌اندازی از توکنی استفاده می‌کند که فقط در زمان اجرا معتبر است. برای GOG_KEYRING_PASSWORD یک گذرواژه keyring ایجاد کنید:

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 را فقط روی 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، راهنمای زمان اجرای مشترک را دنبال کنید:

• تعبیه فایل‌های اجرایی لازم در ایمیج
• ساخت و راه‌اندازی
• محل ماندگاری هر بخش
• به‌روزرسانی‌ها

نکات راه‌اندازی ویژه GCP

اگر ساخت هنگام pnpm install --frozen-lockfile با Killed یا exit code 137 شکست خورد، حافظه ماشین مجازی تمام شده است. حداقل از e2-small یا برای ساخت اولیه مطمئن‌تر از e2-medium استفاده کنید.

هنگام اتصال به LAN ‏(OPENCLAW_GATEWAY_BIND=lan)، پیش از ادامه یک origin مرورگر مورد اعتماد پیکربندی کنید:

docker compose run --rm openclaw-cli config set gateway.controlUi.allowedOrigins '["http://127.0.0.1:18789"]' --strict-json

اگر پورت را تغییر داده‌اید، 18789 را با پورت پیکربندی‌شده خود جایگزین کنید.

دسترسی از لپ‌تاپ

برای انتقال پورت Gateway، یک تونل SSH ایجاد کنید:

gcloud compute ssh openclaw-gateway --zone=us-central1-a -- -L 18789:127.0.0.1:18789

http://127.0.0.1:18789/ را در مرورگر خود باز کنید.

یک پیوند پاک داشبورد را دوباره نمایش دهید:

docker compose run --rm openclaw-cli dashboard --no-open

اگر رابط کاربری برای احراز هویت با راز مشترک درخواست داد، توکن یا گذرواژه پیکربندی‌شده را در تنظیمات Control UI وارد کنید (این روند Docker به‌طور پیش‌فرض یک توکن می‌نویسد؛ اگر به احراز هویت با گذرواژه تغییر داده‌اید، به‌جای آن از گذرواژه پیکربندی‌شده استفاده کنید).

اگر Control UI عبارت unauthorized یا disconnected (1008): pairing required را نشان داد، دستگاه مرورگر را تأیید کنید:

docker compose run --rm openclaw-cli devices listdocker compose run --rm openclaw-cli devices approve <requestId>

برای نقشه ماندگاری مشترک و روند به‌روزرسانی، به زمان اجرای ماشین مجازی Docker مراجعه کنید.