Перейти к основному содержанию
Для большинства установок следует использовать один Gateway, потому что один Gateway может обрабатывать несколько подключений к мессенджерам и агентов. Если вам нужна более строгая изоляция или резервирование (например, бот восстановления), запускайте отдельные Gateway с изолированными профилями/портами.

​
Лучшая рекомендуемая настройка

Для большинства пользователей самая простая настройка бота восстановления выглядит так:
  • держите основного бота в профиле по умолчанию
  • запускайте бота восстановления с --profile rescue
  • используйте полностью отдельного бота Telegram для учетной записи восстановления
  • держите бота восстановления на другом базовом порте, например 19789
Так бот восстановления остается изолированным от основного бота и может выполнять отладку или применять изменения конфигурации, если основной бот не работает. Оставляйте не менее 20 портов между базовыми портами, чтобы производные порты браузера/canvas/CDP никогда не конфликтовали.

​
Быстрый старт для бота восстановления

Используйте этот путь по умолчанию, если у вас нет веской причины сделать что-то другое: 
# Rescue bot (separate Telegram bot, separate profile, port 19789)
openclaw --profile rescue onboard
openclaw --profile rescue gateway install --port 19789
Если ваш основной бот уже запущен, обычно это все, что нужно. Во время openclaw --profile rescue onboard:
  • используйте отдельный токен бота Telegram
  • оставьте профиль rescue
  • используйте базовый порт как минимум на 20 выше, чем у основного бота
  • примите рабочую область восстановления по умолчанию, если вы уже не управляете собственной
Если онбординг уже установил для вас сервис восстановления, финальная команда gateway install не нужна.

​
Почему это работает

Бот восстановления остается независимым, потому что у него есть собственные:
  • профиль/конфигурация
  • каталог состояния
  • рабочая область
  • базовый порт (плюс производные порты)
  • токен бота Telegram
Для большинства установок используйте полностью отдельного бота Telegram для профиля восстановления:
  • легко оставить доступ только для операторов
  • отдельный токен и идентичность бота
  • независимость от канала/установки приложения основного бота
  • простой путь восстановления через DM, когда основной бот сломан

​
Что меняет --profile rescue onboard

openclaw --profile rescue onboard использует обычный поток онбординга, но записывает все в отдельный профиль. На практике это означает, что бот восстановления получает собственные:
  • файл конфигурации
  • каталог состояния
  • рабочую область (по умолчанию ~/.openclaw/workspace-rescue)
  • имя управляемого сервиса
В остальном подсказки такие же, как при обычном онбординге.

​
Общая настройка нескольких Gateway

Схема с ботом восстановления выше является самым простым вариантом по умолчанию, но тот же шаблон изоляции работает для любой пары или группы Gateway на одном хосте. Для более общей настройки назначьте каждому дополнительному Gateway собственный именованный профиль и собственный базовый порт: 
# main (default profile)
openclaw setup
openclaw gateway --port 18789

# extra gateway
openclaw --profile ops setup
openclaw --profile ops gateway --port 19789
Если вы хотите, чтобы оба Gateway использовали именованные профили, это тоже работает: 
openclaw --profile main setup
openclaw --profile main gateway --port 18789

openclaw --profile ops setup
openclaw --profile ops gateway --port 19789
Сервисы следуют тому же шаблону: 
openclaw gateway install
openclaw --profile ops gateway install --port 19789
Используйте быстрый старт для бота восстановления, когда вам нужен резервный операторский канал. Используйте общий шаблон профилей, когда вам нужны несколько долгоживущих Gateway для разных каналов, арендаторов, рабочих областей или операционных ролей.

​
Контрольный список изоляции

Держите эти значения уникальными для каждого экземпляра Gateway:
  • OPENCLAW_CONFIG_PATH — файл конфигурации для каждого экземпляра
  • OPENCLAW_STATE_DIR — сеансы, учетные данные, кэши для каждого экземпляра
  • agents.defaults.workspace — корень рабочей области для каждого экземпляра
  • gateway.port (или --port) — уникальный для каждого экземпляра
  • производные порты браузера/canvas/CDP
Если они общие, вы столкнетесь с гонками конфигурации и конфликтами портов.

​
Сопоставление портов (производные)

Базовый порт = gateway.port (или OPENCLAW_GATEWAY_PORT / --port).
  • порт сервиса управления браузером = базовый + 2 (только loopback)
  • хост canvas обслуживается на HTTP-сервере Gateway (тот же порт, что и gateway.port)
  • CDP-порты профиля браузера автоматически выделяются из диапазона browser.controlPort + 9 .. + 108
Если вы переопределяете любые из них в конфигурации или переменных окружения, они должны оставаться уникальными для каждого экземпляра.

​
Примечания по браузеру/CDP (частая ловушка)

  • Не закрепляйте browser.cdpUrl за одинаковыми значениями в нескольких экземплярах.
  • Каждому экземпляру нужен собственный порт управления браузером и диапазон CDP (производные от его порта Gateway).
  • Если вам нужны явные CDP-порты, задайте browser.profiles.<name>.cdpPort для каждого экземпляра.
  • Удаленный Chrome: используйте browser.profiles.<name>.cdpUrl (для каждого профиля, для каждого экземпляра).

​
Пример ручной настройки env

OPENCLAW_CONFIG_PATH=~/.openclaw/main.json \
OPENCLAW_STATE_DIR=~/.openclaw \
openclaw gateway --port 18789

OPENCLAW_CONFIG_PATH=~/.openclaw/rescue.json \
OPENCLAW_STATE_DIR=~/.openclaw-rescue \
openclaw gateway --port 19789

​
Быстрые проверки

openclaw gateway status --deep
openclaw --profile rescue gateway status --deep
openclaw --profile rescue gateway probe
openclaw status
openclaw --profile rescue status
openclaw --profile rescue browser status
Интерпретация:
  • gateway status --deep помогает обнаружить устаревшие сервисы launchd/systemd/schtasks от более старых установок.
  • Текст предупреждения gateway probe, например multiple reachable gateway identities detected, ожидаем только когда вы намеренно запускаете более одного изолированного gateway или когда OpenClaw не может доказать, что доступные цели проверки являются одним и тем же gateway. SSH-туннель, proxy URL или настроенный удаленный URL к тому же gateway — это один gateway с несколькими транспортами, даже если порты транспортов различаются.

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