OpenClaw Gateway и команды CLI

Gateway — это центральный процесс OpenClaw, который управляет агентом, обрабатывает сообщения из Telegram, обслуживает веб-интерфейс и выполняет запланированные задачи.

На нашей платформе gateway управляется автоматически — вам не нужно запускать или настраивать его вручную. Эта страница полезна тем, кто устанавливает OpenClaw CLI самостоятельно.

Что такое Gateway

Gateway — это процесс-оркестратор, который:

Принимает сообщения из Telegram и веб-интерфейса
Управляет языковой моделью и формирует ответы
Запускает навыки и под-агентов
Выполняет запланированные задачи по расписанию
Предоставляет WebSocket API для подключения клиентов

Запуск Gateway

Для запуска gateway выполните:

openclaw gateway

Или используйте сокращённую команду:

openclaw start

Gateway запустится и начнёт обрабатывать входящие сообщения. Процесс работает в foreground — закрытие терминала остановит его.

Для работы в фоновом режиме (на сервере):

nohup openclaw gateway >> /tmp/openclaw-gateway.log 2>&1 &

Основные команды CLI

Команда	Описание
`openclaw gateway`	Запустить gateway (основной процесс)
`openclaw start`	Сокращение для `openclaw gateway`
`openclaw status`	Проверить статус gateway
`openclaw status --deep`	Подробная диагностика (WebSocket, Telegram, модели)
`openclaw doctor`	Диагностика проблем и рекомендации
`openclaw update`	Обновить до последней версии
`openclaw --version`	Показать текущую версию
`openclaw tools enable`	Включить дополнительные инструменты

Gateway Token

Gateway Token — это секретный ключ, который используется для аутентификации подключений к gateway. Токен генерируется автоматически при первом запуске.

Зачем нужен:

Защита веб-интерфейса от несанкционированного доступа
Аутентификация WebSocket-подключений
Доступ к API gateway

Токен можно узнать через:

openclaw status

Перезапуск Gateway

Если нужно перезапустить gateway (например, после обновления конфигурации):

# Остановить текущий процесс
for pid in $(pgrep openclaw-gate); do kill -9 $pid; done
rm -f /tmp/openclaw-gateway.lock /tmp/openclaw.lock

# Подождать завершения
sleep 2

# Запустить заново
openclaw gateway

Внимание. Во время перезапуска агент будет недоступен в Telegram и веб-интерфейсе (обычно 5-10 секунд).

Решение проблем

«openclaw: command not found»

Команда не найдена — значит OpenClaw CLI не установлен или путь не добавлен в PATH:

Перезапустите терминал
Проверьте установку: npm list -g openclaw
Если не установлен — выполните: npm install -g openclaw
Если установлен, но не найден — добавьте npm-директорию в PATH (см. Установка)

Gateway не запускается

Проверьте, что порты не заняты: ss -tlnp | grep 18790
Посмотрите логи: cat /tmp/openclaw-gateway.log
Запустите диагностику: openclaw doctor

Gateway остановился сам

Если gateway неожиданно остановился, проверьте:

Логи на наличие ошибок: tail -50 /tmp/openclaw-gateway.log
Достаточно ли оперативной памяти: free -h
Не был ли процесс убит системой (OOM killer)

Больше решений — в разделе Решение проблем.