GCP

نصب gcloud CLI (یا استفاده از کنسول)

آن را از 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 الزامی است).

معادل آن در کنسول: 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

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

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

نصب 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 یک گذرواژه دسته‌کلید ایجاد کنید:

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:      # توصیه می‌شود: Gateway را روی ماشین مجازی فقط به رابط محلی محدود کنید؛ از طریق تونل 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 استفاده کنید.

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

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

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

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

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

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