> ## 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 размещает Gateway OpenClaw в виде небольшого контейнеризованного приложения за своим
прокси Caddy. В этом руководстве предполагается, что хост EasyRunner запускает совместимые с Podman
приложения Compose и завершает HTTPS-соединения через Caddy.

## Перед началом работы

* Сервер EasyRunner с направленным на него доменом.
* Официальный образ OpenClaw (`ghcr.io/openclaw/openclaw`) или ваша собственная сборка.
* Постоянный том конфигурации для `/home/node/.openclaw`.
* Постоянный том рабочей области для `/home/node/.openclaw/workspace`.
* Надёжный токен или пароль Gateway.

По возможности не отключайте аутентификацию устройств. Если обратный прокси не может
корректно передавать идентификатор устройства, сначала исправьте настройки доверенного прокси (см.
[Аутентификация через доверенный прокси](https://docs2.openclaw.ai/ru/gateway/trusted-proxy-auth.md)); используйте опасные способы
обхода аутентификации только в полностью приватной сети под контролем оператора.

## Приложение 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: /home/node/.openclaw/workspace
    volumes:
      - openclaw-config:/home/node/.openclaw
      - openclaw-workspace:/home/node/.openclaw/workspace
    labels:
      caddy: openclaw.example.com
      caddy.reverse_proxy: "{{upstreams 1455}}"
    command: ["node", "openclaw.mjs", "gateway", "--bind", "lan", "--port", "1455"]

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

Замените `openclaw.example.com` именем хоста вашего Gateway. Храните
`OPENCLAW_GATEWAY_TOKEN` в диспетчере секретов или переменных среды EasyRunner, а не
фиксируйте его в определении приложения. По умолчанию образ привязывается к loopback-интерфейсу,
поэтому явное указание `--bind lan --port 1455` в `command` необходимо, чтобы Caddy мог
обращаться к контейнеру.

## Настройка OpenClaw

В постоянном томе конфигурации настройте доступность Gateway только через
прокси и требуйте аутентификацию:

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

Если Caddy завершает TLS-соединения для Gateway, настройте доверенный прокси для
конкретного маршрута прокси вместо глобального отключения проверок аутентификации. См.
[Аутентификация через доверенный прокси](https://docs2.openclaw.ai/ru/gateway/trusted-proxy-auth.md).

## Проверка

С вашей рабочей станции:

```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 для `GET /healthz` (проверка работоспособности) и `GET /readyz`
(проверка готовности) аутентификация не требуется; они используются встроенной в образ
проверкой состояния контейнера. Также проверьте журналы приложения: Gateway должен прослушивать
подключения, а ошибки аутентификации SecretRef, плагинов или каналов при запуске должны отсутствовать.

## Обновления и резервное копирование

* Загрузите или соберите новый образ OpenClaw, затем повторно разверните приложение EasyRunner.
* Создайте резервную копию тома `openclaw-config` перед обновлениями. В нём хранятся
  `openclaw.json`, `agents/<agentId>/agent/auth-profiles.json` и состояние пакетов
  установленных плагинов.
* Создайте резервную копию `openclaw-workspace`, если агенты записывают туда долговременные данные проектов.
* После крупных обновлений выполните `openclaw doctor`, чтобы выявить необходимые миграции конфигурации и
  предупреждения служб.

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

* `gateway probe` не удаётся подключиться: убедитесь, что имя хоста Caddy указывает на приложение
  и контейнер прослушивает `0.0.0.0:1455`.
* Ошибка аутентификации: одновременно замените токен в секретах EasyRunner и
  команде локального клиента.
* После восстановления файлы принадлежат пользователю root: образ запускается от имени `node` (uid 1000);
  исправьте права подключённых томов, чтобы этот пользователь мог записывать данные в
  `/home/node/.openclaw` и `/home/node/.openclaw/workspace`.
* Не работают браузерные или канальные плагины: проверьте, доступны ли внутри
  контейнера необходимые внешние исполняемые файлы, исходящие сетевые подключения и подключённые учётные данные.