// dokumentacja openclaw

Instalacja OpenClaw na Google Cloud Platform (GCP)

OpenClaw na Google Cloud Platform

Ten poradnik opisuje uruchomienie trwałego Gateway OpenClaw na Google Cloud Compute Engine z użyciem Dockera. Konfiguracja zapewnia persystencję danych i dostęp do panelu sterowania przez tunel SSH. Szacowany koszt to ok. 5–12 USD miesięcznie.

Wymagania wstępne

  • Konto GCP z aktywnym rozliczeniem.
  • Zainstalowany gcloud CLI.
  • Klucz SSH do łączenia się z maszyną wirtualną.
  • Około 20–30 minut na konfigurację.
  • Klucz API dostawcy modeli AI.

Szybki start

Cały proces składa się z ośmiu kroków:

  1. Utworzenie projektu GCP — jeśli nie masz jeszcze projektu, utwórz go w konsoli GCP lub poleceniem gcloud projects create.
  2. Uruchomienie VM — stwórz instancję Compute Engine z systemem Ubuntu.
  3. Instalacja Dockera — na maszynie wirtualnej zainstaluj Docker Engine i Docker Compose.
  4. Klonowanie repozytorium — pobierz repozytorium OpenClaw.
  5. Katalog trwały — skonfiguruj katalog ~/.openclaw do persystencji danych.
  6. Zmienne środowiskowe — przygotuj plik .env z tokenami i kluczami.
  7. Docker Compose — skonfiguruj i uruchom kontener.
  8. Weryfikacja — sprawdź, czy Gateway działa poprawnie.

Wybór typu maszyny

GCP oferuje kilka opcji w zależności od budżetu i wymagań:

  • e2-medium (~25 USD/mies.) — niezawodne budowanie obrazów, komfortowa praca.
  • e2-small (~12 USD/mies.) — minimalna rekomendacja, wystarczająca dla większości zastosowań.
  • e2-micro (warstwa darmowa) — często kończy się błędami OOM podczas budowania. Nie zalecane.

Konfiguracja pliku .env

Plik .env musi zawierać następujące zmienne:

OPENCLAW_GATEWAY_TOKEN=twoj-tajny-token
OPENCLAW_GATEWAY_BIND=127.0.0.1
OPENCLAW_GATEWAY_PORT=18789

Token wygeneruj silnym losowym ciągiem znaków, np. poleceniem openssl rand -hex 32.

Docker Compose

version: "3.8"
services:
  openclaw:
    image: ghcr.io/openclaw/openclaw:latest
    restart: unless-stopped
    ports:
      - "127.0.0.1:18789:18789"
    volumes:
      - ~/.openclaw:/root/.openclaw
    env_file:
      - .env

Domyślnie Gateway nasłuchuje wyłącznie na localhost — nie jest wystawiony na zewnątrz. Dostęp realizowany jest przez tunel SSH.

Dostęp przez tunel SSH

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

Po nawiązaniu tunelu otwórz przeglądarkę i przejdź na http://localhost:18789.

Rozwiązywanie problemów

  • Błąd OOM (exit 137) podczas budowania — zmień typ maszyny na co najmniej e2-small.
  • SSH nie łączy się — klucze SSH mogą potrzebować 1–2 minut na propagację po utworzeniu VM.
  • Parowanie urządzeń — jeśli wymagana jest dodatkowa autoryzacja, użyj docker compose run.
Wróc do dokumentacji