Gateway OpenClaw: как устроен и как настроить | open-claw.su

Gateway --- центральный процесс OpenClaw. Это единственный компонент, который должен работать постоянно: он принимает сообщения из мессенджеров, направляет их агенту и возвращает ответы обратно. Без gateway агент не работает.

В этом руководстве разберём, что делает gateway, как его запустить, настроить и обеспечить стабильную работу.

Что делает gateway

Gateway --- это «диспетчерская» OpenClaw. Он выполняет несколько задач одновременно:

Функция	Описание
Приём сообщений	Принимает входящие сообщения из Telegram, WhatsApp, Slack, Discord и других каналов
Маршрутизация	Направляет сообщения нужному агенту и возвращает ответы в мессенджер
Управление сессиями	Хранит контекст разговоров между сообщениями
Веб-дашборд	Предоставляет панель управления в браузере
API	Принимает запросы через OpenAI-совместимый HTTP API

Один gateway обслуживает все подключённые каналы и агентов.

Запуск

Ручной запуск

openclaw gateway --port 18789

В терминале появится:

🤖 OpenClaw agent started
📡 Connected to Telegram
🌐 Dashboard: http://127.0.0.1:18789/
⏳ Waiting for messages...

Остановка --- Ctrl + C.

Флаги командной строки

Флаг	Описание
`--port <число>`	Порт для прослушивания (по умолчанию 18789)
`--verbose`	Подробный вывод для отладки
`--force`	Завершить существующий процесс gateway и запустить новый

# Запуск с подробным выводом на нестандартном порту:
openclaw gateway --port 9000 --verbose

# Принудительный перезапуск, если предыдущий процесс завис:
openclaw gateway --port 18789 --force

Дашборд (веб-панель управления)

Gateway предоставляет веб-интерфейс по адресу:

http://127.0.0.1:18789/

Открыть его можно командой:

openclaw dashboard

В дашборде можно:

Видеть статус агента и подключённых каналов
Общаться с агентом через веб-чат
Просматривать настройки

Аутентификация дашборда

По умолчанию дашборд доступен только с локального компьютера (127.0.0.1). Для доступа с других устройств потребуется аутентификация.

Настройка в ~/.openclaw/openclaw.json:

{
  gateway: {
    auth: {
      token: "ваш-секретный-токен",
    },
  },
}

Или через переменную окружения:

export OPENCLAW_GATEWAY_TOKEN="ваш-секретный-токен"

Если вы используете openclaw onboard --install-daemon, токен генерируется автоматически.

Настройка в openclaw.json

Основные параметры gateway в конфигурационном файле:

// ~/.openclaw/openclaw.json
{
  gateway: {
    port: 18789,            // Порт (по умолчанию 18789)
    bind: "loopback",       // "loopback" — только localhost, или сетевой режим
    reload: {
      mode: "hybrid",       // off | hot | restart | hybrid (по умолчанию)
    },
    auth: {
      token: "xxx",         // Токен аутентификации
    },
  },
}

Параметры

Параметр	Описание	По умолчанию
`gateway.port`	Порт прослушивания	`18789`
`gateway.bind`	Режим привязки: `loopback` (только localhost) или сетевой	`loopback`
`gateway.reload.mode`	Поведение при изменении конфигурации: `off`, `hot`, `restart`, `hybrid`	`hybrid`
`gateway.auth.token`	Токен аутентификации для дашборда и API	—
`gateway.auth.password`	Пароль (альтернатива токену)	—

Автозапуск через systemd (Linux)

Чтобы gateway запускался автоматически при загрузке системы.

Установка сервиса

openclaw gateway install

Или при первой настройке:

openclaw onboard --install-daemon

Обе команды создают пользовательский systemd-сервис openclaw-gateway.service.

Управление

openclaw gateway status      # Состояние: running / stopped
openclaw gateway restart     # Перезапуск
openclaw gateway stop        # Остановка

Работа после выхода из SSH

По умолчанию пользовательские systemd-сервисы останавливаются при выходе из сессии. Чтобы gateway работал постоянно на сервере:

sudo loginctl enable-linger $USER

После этого сервис будет запускаться при загрузке системы и работать в фоне независимо от SSH-сессии.

Просмотр логов

openclaw logs --follow

Автозапуск на macOS (launchd)

На macOS openclaw onboard --install-daemon создаёт launchd-сервис автоматически. Управление --- теми же командами:

openclaw gateway status
openclaw gateway restart
openclaw gateway stop

Удалённый доступ

Если gateway работает на сервере, а вы хотите управлять им с другого устройства.

SSH-туннель (простой способ)

Создайте туннель с вашего компьютера к серверу:

ssh -N -L 18789:127.0.0.1:18789 user@your-server

Теперь дашборд доступен на вашем компьютере по адресу http://127.0.0.1:18789/.

Флаг -N означает «не открывать shell, только туннель».

Tailscale (рекомендуемый способ для постоянного доступа)

OpenClaw поддерживает Tailscale --- VPN-сеть с нулевой конфигурацией.

Режим serve --- доступ только внутри вашей Tailscale-сети:

// ~/.openclaw/openclaw.json
{
  gateway: {
    tailscale: {
      mode: "serve",
    },
  },
}

Режим funnel --- публичный доступ через интернет (требует пароль):

// ~/.openclaw/openclaw.json
{
  gateway: {
    tailscale: {
      mode: "funnel",
    },
    auth: {
      mode: "password",
      password: "надёжный-пароль",
    },
  },
}

Tailscale автоматически обеспечивает шифрование и не требует настройки firewall или открытия портов.

Каналы и gateway

Все каналы (мессенджеры) подключаются через gateway. Управление каналами:

# Добавить Telegram-бота:
openclaw channels add --channel telegram --token "123456789:ABCdef..."

# Подключить WhatsApp (по QR-коду):
openclaw channels login

# Проверить состояние каналов:
openclaw channels status --probe

Настройка каналов в конфигурации:

// ~/.openclaw/openclaw.json
{
  channels: {
    telegram: {
      botToken: "${TELEGRAM_BOT_TOKEN}",
      allowFrom: [123456789],
    },
  },
}

Подробнее --- Подключение Telegram.

Диагностика

Проверка состояния

# Быстрая проверка:
openclaw gateway status

# Подробная проверка:
openclaw gateway status --deep

# Машиночитаемый формат (JSON):
openclaw gateway status --json

Общая диагностика

# Проверка конфигурации, ключей и подключений:
openclaw doctor

# Проверка здоровья:
openclaw health

# Проверка каналов:
openclaw channels status --probe

Типичные проблемы

Gateway не запускается --- порт занят

# Принудительный перезапуск:
openclaw gateway --port 18789 --force

Или найдите и завершите процесс вручную:

# Найти процесс на порту 18789:
lsof -i :18789
# или
ss -tlnp | grep 18789

# Завершить:
kill <PID>

«Heartbeat timeout»

Агент потерял связь с gateway. Перезапустите:

openclaw gateway restart

Дашборд недоступен

Проверьте, что gateway запущен: openclaw gateway status
Убедитесь, что открываете правильный адрес: http://127.0.0.1:18789/
Если доступ с другого устройства --- используйте SSH-туннель или Tailscale

Канал «disconnected»

# Проверьте статус каналов:
openclaw channels status --probe

# Для Telegram --- проверьте токен бота:
openclaw doctor

Gateway перезапускается в цикле

Обычно проблема в конфигурации:

# Проверьте конфигурацию:
openclaw doctor

# Посмотрите логи:
openclaw logs --follow

Частые причины: ошибка синтаксиса в openclaw.json, несуществующая модель, недействительный API-ключ.

Что дальше

Быстрый старт --- от установки до первого сообщения за 5 минут
Подключение Telegram --- настройка Telegram-бота
Безопасность OpenClaw --- важно прочитать перед запуском
Установка на Linux --- нативная установка с systemd
Установка через Docker --- развёртывание в контейнере