---
read_when:
    - Вы хотите, чтобы OpenClaw работал 24/7 на GCP
    - Вам нужен промышленного уровня, постоянно работающий Gateway на вашей собственной VM
    - Вам нужен полный контроль над постоянным хранением, бинарными файлами и поведением при перезапуске
summary: Запуск OpenClaw Gateway 24/7 на VM GCP Compute Engine (Docker) с долговременным состоянием
title: GCP
x-i18n:
    generated_at: "2026-06-28T23:05:56Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 678253bd90f0694668400ffddba957e442f8aaed3f5308af3c2481940e104733
    source_path: install/gcp.md
    workflow: 16
---

Запустите постоянный OpenClaw Gateway на VM GCP Compute Engine с помощью Docker, с долговечным состоянием, встроенными бинарными файлами и безопасным поведением при перезапуске.

Если вам нужен «OpenClaw 24/7 примерно за $5-12/мес.», это надежная схема в Google Cloud.
Цена зависит от типа машины и региона; выберите самую маленькую VM, подходящую для вашей нагрузки, и увеличьте ее, если столкнетесь с OOM.

## Что мы делаем (простыми словами)?

- Создаем проект GCP и включаем биллинг
- Создаем VM Compute Engine
- Устанавливаем Docker (изолированная среда выполнения приложения)
- Запускаем OpenClaw Gateway в Docker
- Сохраняем `~/.openclaw` + `~/.openclaw/workspace` на хосте (переживает перезапуски/пересборки)
- Получаем доступ к Control UI с ноутбука через SSH-туннель

Это смонтированное состояние `~/.openclaw` включает `openclaw.json`, поагентные
`agents/<agentId>/agent/auth-profiles.json` и `.env`.

Доступ к Gateway можно получить через:

- проброс SSH-порта с ноутбука
- прямую публикацию порта, если вы самостоятельно управляете firewall и токенами

В этом руководстве используется Debian на GCP Compute Engine.
Ubuntu также подходит; сопоставьте пакеты соответствующим образом.
Общий процесс Docker см. в [Docker](/ru/install/docker).

---

## Быстрый путь (для опытных операторов)

1. Создайте проект GCP и включите Compute Engine API
2. Создайте VM Compute Engine (`e2-small`, Debian 12, 20 ГБ)
3. Подключитесь к VM по SSH
4. Установите Docker
5. Клонируйте репозиторий OpenClaw
6. Создайте постоянные каталоги на хосте
7. Настройте `.env` и `docker-compose.yml`
8. Встройте необходимые бинарные файлы, соберите и запустите

---

## Что вам понадобится

- Аккаунт GCP (e2-micro подходит для бесплатного уровня)
- Установленный gcloud CLI (или Cloud Console)
- SSH-доступ с вашего ноутбука
- Базовое умение пользоваться SSH и копированием/вставкой
- ~20-30 минут
- Docker и Docker Compose
- Учетные данные аутентификации модели
- Необязательные учетные данные провайдеров
  - QR WhatsApp
  - токен бота Telegram
  - Gmail OAuth

---

<Steps>
  <Step title="Install gcloud CLI (or use Console)">
    **Вариант A: gcloud CLI** (рекомендуется для автоматизации)

    Установите с [https://cloud.google.com/sdk/docs/install](https://cloud.google.com/sdk/docs/install)

    Инициализируйте и выполните аутентификацию:

    ```bash
    gcloud init
    gcloud auth login
    ```

    **Вариант B: Cloud Console**

    Все шаги можно выполнить через веб-интерфейс по адресу [https://console.cloud.google.com](https://console.cloud.google.com)

  </Step>

  <Step title="Create a GCP project">
    **CLI:**

    ```bash
    gcloud projects create my-openclaw-project --name="OpenClaw Gateway"
    gcloud config set project my-openclaw-project
    ```

    Включите биллинг на [https://console.cloud.google.com/billing](https://console.cloud.google.com/billing) (требуется для Compute Engine).

    Включите Compute Engine API:

    ```bash
    gcloud services enable compute.googleapis.com
    ```

    **Console:**

    1. Перейдите в IAM & Admin > Create Project
    2. Назовите проект и создайте его
    3. Включите биллинг для проекта
    4. Перейдите в APIs & Services > Enable APIs > найдите "Compute Engine API" > Enable

  </Step>

  <Step title="Create the VM">
    **Типы машин:**

    | Тип       | Характеристики           | Стоимость          | Примечания                                   |
    | --------- | ------------------------ | ------------------ | -------------------------------------------- |
    | e2-medium | 2 vCPU, 4 ГБ RAM         | ~$25/мес.          | Самый надежный вариант для локальных сборок Docker |
    | e2-small  | 2 vCPU, 2 ГБ RAM         | ~$12/мес.          | Минимально рекомендуется для сборки Docker   |
    | e2-micro  | 2 vCPU (общие), 1 ГБ RAM | Доступен в бесплатном уровне | Часто падает при сборке Docker из-за OOM (exit 137) |

    **CLI:**

    ```bash
    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
    ```

    **Console:**

    1. Перейдите в Compute Engine > VM instances > Create instance
    2. Имя: `openclaw-gateway`
    3. Регион: `us-central1`, зона: `us-central1-a`
    4. Тип машины: `e2-small`
    5. Загрузочный диск: Debian 12, 20 ГБ
    6. Создайте

  </Step>

  <Step title="SSH into the VM">
    **CLI:**

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

    **Console:**

    Нажмите кнопку "SSH" рядом с вашей VM на панели Compute Engine.

    Примечание: распространение SSH-ключа может занять 1-2 минуты после создания VM. Если соединение отклоняется, подождите и повторите попытку.

  </Step>

  <Step title="Install Docker (on the VM)">
    ```bash
    sudo apt-get update
    sudo apt-get install -y git curl ca-certificates
    curl -fsSL https://get.docker.com | sudo sh
    sudo usermod -aG docker $USER
    ```

    Выйдите и войдите снова, чтобы изменение группы вступило в силу:

    ```bash
    exit
    ```

    Затем снова подключитесь по SSH:

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

    Проверьте:

    ```bash
    docker --version
    docker compose version
    ```

  </Step>

  <Step title="Clone the OpenClaw repository">
    ```bash
    git clone https://github.com/openclaw/openclaw.git
    cd openclaw
    ```

    Это руководство предполагает, что вы соберете пользовательский образ, чтобы гарантировать сохранность бинарных файлов.

  </Step>

  <Step title="Create persistent host directories">
    Контейнеры Docker эфемерны.
    Все долгоживущее состояние должно находиться на хосте.

    ```bash
    mkdir -p ~/.openclaw
    mkdir -p ~/.openclaw/workspace
    ```

  </Step>

  <Step title="Configure environment variables">
    Создайте `.env` в корне репозитория.

    ```bash
    OPENCLAW_IMAGE=openclaw:latest
    OPENCLAW_GATEWAY_TOKEN=
    OPENCLAW_GATEWAY_BIND=lan
    OPENCLAW_GATEWAY_PORT=18789

    OPENCLAW_CONFIG_DIR=/home/$USER/.openclaw
    OPENCLAW_WORKSPACE_DIR=/home/$USER/.openclaw/workspace

    GOG_KEYRING_PASSWORD=
    XDG_CONFIG_HOME=/home/node/.openclaw
    ```

    Задайте `OPENCLAW_GATEWAY_TOKEN`, если хотите управлять стабильным токеном
    Gateway через `.env`; иначе настройте `gateway.auth.token` перед тем,
    как полагаться на клиентов между перезапусками. Если ни один источник не
    существует, OpenClaw использует токен только для времени выполнения этого
    запуска. Сгенерируйте пароль keyring и вставьте его в `GOG_KEYRING_PASSWORD`:

    ```bash
    openssl rand -hex 32
    ```

    **Не коммитьте этот файл.**

    Этот файл `.env` предназначен для переменных окружения контейнера/среды выполнения, таких как `OPENCLAW_GATEWAY_TOKEN`.
    Сохраненная аутентификация OAuth/API-key для провайдеров находится в смонтированном
    `~/.openclaw/agents/<agentId>/agent/auth-profiles.json`.

  </Step>

  <Step title="Docker Compose configuration">
    Создайте или обновите `docker-compose.yml`.

    ```yaml
    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 VM; 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` или пароль) и используйте безопасные настройки bind для вашего развертывания.

  </Step>

  <Step title="Shared Docker VM runtime steps">
    Используйте общее руководство по среде выполнения для стандартного процесса на хосте Docker:

    - [Встроить необходимые бинарные файлы в образ](/ru/install/docker-vm-runtime#bake-required-binaries-into-the-image)
    - [Собрать и запустить](/ru/install/docker-vm-runtime#build-and-launch)
    - [Что и где сохраняется](/ru/install/docker-vm-runtime#what-persists-where)
    - [Обновления](/ru/install/docker-vm-runtime#updates)

  </Step>

  <Step title="GCP-specific launch notes">
    В GCP, если сборка падает с `Killed` или `exit code 137` во время `pnpm install --frozen-lockfile`, VM не хватает памяти. Используйте минимум `e2-small` или `e2-medium` для более надежных первых сборок.

    При bind к LAN (`OPENCLAW_GATEWAY_BIND=lan`) настройте доверенный источник браузера перед продолжением:

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

    Если вы изменили порт Gateway, замените `18789` на настроенный порт.

  </Step>

  <Step title="Access from your laptop">
    Создайте SSH-туннель для проброса порта Gateway:

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

    Откройте в браузере:

    `http://127.0.0.1:18789/`

    Повторно выведите чистую ссылку на панель:

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

    Если UI запрашивает аутентификацию shared-secret, вставьте настроенный токен или
    пароль в настройки Control UI. Этот процесс Docker по умолчанию записывает токен;
    если вы переключите конфигурацию контейнера на аутентификацию паролем, используйте
    этот пароль вместо токена.

    Если Control UI показывает `unauthorized` или `disconnected (1008): pairing required`, одобрите устройство браузера:

    ```bash
    docker compose run --rm openclaw-cli devices list
    docker compose run --rm openclaw-cli devices approve <requestId>
    ```

    Снова нужна справка по общей постоянной сохранности и обновлениям?
    См. [Docker VM Runtime](/ru/install/docker-vm-runtime#what-persists-where) и [обновления Docker VM Runtime](/ru/install/docker-vm-runtime#updates).

  </Step>
</Steps>

---

## Устранение неполадок

**SSH-соединение отклонено**

Распространение SSH-ключа может занять 1-2 минуты после создания VM. Подождите и повторите попытку.

**Проблемы с OS Login**

Проверьте свой профиль OS Login:

```bash
gcloud compute os-login describe-profile
```

Убедитесь, что у вашего аккаунта есть необходимые разрешения IAM (Compute OS Login или Compute OS Admin Login).

**Недостаточно памяти (OOM)**

Если сборка Docker падает с `Killed` и `exit code 137`, VM была завершена из-за OOM. Перейдите на e2-small (минимум) или e2-medium (рекомендуется для надежных локальных сборок):

```bash
# Stop the VM first
gcloud compute instances stop openclaw-gateway --zone=us-central1-a

# Change machine type
gcloud compute instances set-machine-type openclaw-gateway \
  --zone=us-central1-a \
  --machine-type=e2-small

# Start the VM
gcloud compute instances start openclaw-gateway --zone=us-central1-a
```

---

## Сервисные аккаунты (лучшая практика безопасности)

Для личного использования ваш стандартный пользовательский аккаунт подходит.

Для автоматизации или CI/CD-пайплайнов создайте отдельный сервисный аккаунт с минимальными разрешениями:

1. Создайте сервисный аккаунт:

   ```bash
   gcloud iam service-accounts create openclaw-deploy \
     --display-name="OpenClaw Deployment"
   ```

2. Выдайте роль Compute Instance Admin (или более узкую пользовательскую роль):

   ```bash
   gcloud projects add-iam-policy-binding my-openclaw-project \
     --member="serviceAccount:openclaw-deploy@my-openclaw-project.iam.gserviceaccount.com" \
     --role="roles/compute.instanceAdmin.v1"
   ```

Не используйте роль Owner для автоматизации. Применяйте принцип наименьших привилегий.

Подробности о ролях IAM см. на [https://cloud.google.com/iam/docs/understanding-roles](https://cloud.google.com/iam/docs/understanding-roles).

---

## Следующие шаги

- Настройте каналы обмена сообщениями: [Каналы](/ru/channels)
- Сопрягите локальные устройства как узлы: [Узлы](/ru/nodes)
- Настройте Gateway: [Конфигурация Gateway](/ru/gateway/configuration)

## Связанные материалы

- [Обзор установки](/ru/install)
- [Azure](/ru/install/azure)
- [Хостинг VPS](/ru/vps)