> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# EasyRunner

EasyRunner може розміщувати OpenClaw Gateway як невеликий контейнеризований застосунок за своїм
проксі Caddy. Цей посібник передбачає наявність хоста EasyRunner, який запускає сумісні з Podman
застосунки Compose і надає HTTPS через Caddy.

## Перш ніж почати

* Сервер EasyRunner із доменом, спрямованим на нього.
* Зібраний або опублікований контейнерний образ OpenClaw.
* Постійний том конфігурації для `/home/node/.openclaw`.
* Постійний том робочого простору для `/workspace`.
* Надійний токен або пароль Gateway.

За можливості залишайте автентифікацію пристрою ввімкненою. Якщо ваше розгортання зворотного проксі не може
коректно передавати ідентичність пристрою, спершу виправте налаштування довіреного проксі; використовуйте
небезпечні обходи автентифікації лише для повністю приватної мережі під контролем оператора.

## Застосунок Compose

Створіть застосунок EasyRunner із файлом Compose такого вигляду:

```yaml theme={"theme":{"light":"min-light","dark":"min-dark"}}
services:
  openclaw:
    image: ghcr.io/openclaw/openclaw:latest
    restart: unless-stopped
    environment:
      OPENCLAW_GATEWAY_TOKEN: ${OPENCLAW_GATEWAY_TOKEN}
      OPENCLAW_HOME: /home/node
      OPENCLAW_STATE_DIR: /home/node/.openclaw
      OPENCLAW_CONFIG_PATH: /home/node/.openclaw/openclaw.json
      OPENCLAW_WORKSPACE_DIR: /workspace
    volumes:
      - openclaw-config:/home/node/.openclaw
      - openclaw-workspace:/workspace
    labels:
      caddy: openclaw.example.com
      caddy.reverse_proxy: "{{upstreams 1455}}"
    command: ["openclaw", "gateway", "--bind", "lan", "--port", "1455"]

volumes:
  openclaw-config:
  openclaw-workspace:
```

Замініть `openclaw.example.com` на ім’я хоста вашого Gateway. Зберігайте
`OPENCLAW_GATEWAY_TOKEN` у менеджері секретів/змінних середовища EasyRunner, а не
комітьте його у визначення застосунку.

## Налаштування OpenClaw

У постійному томі конфігурації залишайте Gateway доступним лише через
проксі та вимагайте автентифікацію:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  gateway: {
    bind: "lan",
    port: 1455,
    auth: {
      token: "${OPENCLAW_GATEWAY_TOKEN}",
    },
  },
}
```

Якщо Caddy завершує TLS для Gateway, налаштуйте параметри довіреного проксі для
точного шляху проксі, а не вимикайте перевірки автентифікації глобально. Див.
[автентифікацію довіреного проксі](/uk/gateway/trusted-proxy-auth).

## Перевірка

З вашої робочої станції:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway probe --url https://openclaw.example.com --token <token>
openclaw gateway status --url https://openclaw.example.com --token <token>
```

З хоста EasyRunner перевірте журнали застосунку на наявність Gateway, що слухає, і відсутність
помилок запуску SecretRef, Plugin або автентифікації каналу.

## Оновлення та резервні копії

* Отримайте або зберіть новий образ OpenClaw, а потім повторно розгорніть застосунок EasyRunner.
* Створіть резервну копію тому `openclaw-config` перед оновленнями.
* Створіть резервну копію `openclaw-workspace`, якщо агенти записують туди довговічні дані проєкту.
* Запустіть `openclaw doctor` після великих оновлень, щоб виявити міграції конфігурації та
  попередження сервісів.

## Усунення несправностей

* `gateway probe` не може підключитися: переконайтеся, що ім’я хоста Caddy вказує на застосунок
  і що контейнер слухає на `0.0.0.0:1455`.
* Автентифікація не проходить: одночасно змініть токен у секретах EasyRunner і в команді
  локального клієнта.
* Після відновлення файли належать root: виправте змонтовані томи, щоб користувач
  контейнера міг записувати в `/home/node/.openclaw` і `/workspace`.
* Plugin-и браузера або каналів не працюють: перевірте, чи доступні всередині
  контейнера потрібні зовнішні двійкові файли, вихід у мережу та змонтовані облікові дані.