> ## 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.

# Панель управления

Панель Gateway — это браузерный интерфейс управления, по умолчанию обслуживаемый по адресу `/`
(переопределяется через `gateway.controlUi.basePath`).

Быстрое открытие (локальный Gateway):

* [http://127.0.0.1:18789/](http://127.0.0.1:18789/) (или [http://localhost:18789/](http://localhost:18789/))
* При `gateway.tls.enabled: true` используйте `https://127.0.0.1:18789/` и
  `wss://127.0.0.1:18789` для конечной точки WebSocket.

Ключевые справочные материалы:

* [Интерфейс управления](/ru/web/control-ui) для использования и возможностей UI.
* [Tailscale](/ru/gateway/tailscale) для автоматизации Serve/Funnel.
* [Веб-поверхности](/ru/web) для режимов привязки и заметок по безопасности.

Аутентификация выполняется при WebSocket handshake через настроенный путь
аутентификации Gateway:

* `connect.params.auth.token`
* `connect.params.auth.password`
* заголовки идентификации Tailscale Serve, когда `gateway.auth.allowTailscale: true`
* заголовки идентификации trusted-proxy, когда `gateway.auth.mode: "trusted-proxy"`

См. `gateway.auth` в [конфигурации Gateway](/ru/gateway/configuration).

Примечание по безопасности: интерфейс управления — это **административная поверхность** (чат, конфигурация, подтверждения exec).
Не открывайте его в публичный доступ. UI хранит токены URL панели в sessionStorage
для текущей сессии вкладки браузера и выбранного URL Gateway, а после загрузки удаляет их из URL.
Предпочитайте localhost, Tailscale Serve или SSH-туннель.

## Быстрый путь (рекомендуется)

* После онбординга CLI автоматически открывает панель и выводит чистую ссылку (без токена).
* Повторно открыть в любое время: `openclaw dashboard` (копирует ссылку, по возможности открывает браузер, показывает подсказку SSH в headless-режиме).
* Если доставка через буфер обмена и браузер не удалась, `openclaw dashboard` все равно выводит
  чистый URL и сообщает, что нужно использовать токен из `OPENCLAW_GATEWAY_TOKEN` или
  `gateway.auth.token` как ключ фрагмента URL `token`; значения токенов в логи не выводятся.
* Если UI запрашивает аутентификацию по общему секрету, вставьте настроенный токен или
  пароль в настройки интерфейса управления.

## Основы аутентификации (локально и удаленно)

* **Localhost**: откройте `http://127.0.0.1:18789/`.
* **TLS Gateway**: когда `gateway.tls.enabled: true`, ссылки панели/статуса используют
  `https://`, а ссылки WebSocket интерфейса управления используют `wss://`.
* **Источник токена общего секрета**: `gateway.auth.token` (или
  `OPENCLAW_GATEWAY_TOKEN`); `openclaw dashboard` может передать его через фрагмент URL
  для одноразовой начальной настройки, а интерфейс управления хранит его в sessionStorage для
  текущей сессии вкладки браузера и выбранного URL Gateway вместо localStorage.
* Если `gateway.auth.token` управляется через SecretRef, `openclaw dashboard`
  намеренно выводит/копирует/открывает URL без токена. Это предотвращает раскрытие
  внешне управляемых токенов в логах оболочки, истории буфера обмена или аргументах
  запуска браузера.
* Если `gateway.auth.token` настроен как SecretRef и не разрешается в вашей
  текущей оболочке, `openclaw dashboard` все равно выводит URL без токена, а также
  практические инструкции по настройке аутентификации.
* **Пароль общего секрета**: используйте настроенный `gateway.auth.password` (или
  `OPENCLAW_GATEWAY_PASSWORD`). Панель не сохраняет пароли между перезагрузками.
* **Режимы с идентификацией**: Tailscale Serve может выполнять аутентификацию интерфейса управления/WebSocket
  через заголовки идентификации, когда `gateway.auth.allowTailscale: true`, а
  reverse proxy с учетом идентификации вне local loopback может выполнять
  `gateway.auth.mode: "trusted-proxy"`. В этих режимах панели не требуется
  вставленный общий секрет для WebSocket.
* **Не localhost**: используйте Tailscale Serve, привязку с общим секретом вне local loopback,
  reverse proxy с учетом идентификации вне local loopback с
  `gateway.auth.mode: "trusted-proxy"` или SSH-туннель. HTTP API по-прежнему используют
  аутентификацию по общему секрету, если вы намеренно не запускаете private-ingress
  `gateway.auth.mode: "none"` или HTTP-аутентификацию trusted-proxy. См.
  [Веб-поверхности](/ru/web).

<a id="if-you-see-unauthorized-1008" />

## Если вы видите "unauthorized" / 1008

* Убедитесь, что Gateway доступен (локально: `openclaw status`; удаленно: SSH-туннель `ssh -N -L 18789:127.0.0.1:18789 user@host`, затем откройте `http://127.0.0.1:18789/`).
* Для `AUTH_TOKEN_MISMATCH` клиенты могут выполнить одну доверенную повторную попытку с кэшированным токеном устройства, когда Gateway возвращает подсказки для повтора. Такая повторная попытка с кэшированным токеном повторно использует кэшированные одобренные области действия токена; вызывающие стороны с явным `deviceToken` / явными `scopes` сохраняют запрошенный набор областей действия. Если после этой повторной попытки аутентификация все еще не проходит, устраните расхождение токенов вручную.
* Для `AUTH_SCOPE_MISMATCH` токен устройства был распознан, но не содержит запрошенные панелью области действия; выполните повторное сопряжение или одобрите запрошенный контракт областей действия вместо ротации общего токена Gateway.
* Вне этого пути повторной попытки приоритет аутентификации подключения таков: сначала явный общий токен/пароль, затем явный `deviceToken`, затем сохраненный токен устройства, затем bootstrap-токен.
* На асинхронном пути Tailscale Serve для интерфейса управления неудачные попытки для одного и того же
  `{scope, ip}` сериализуются до того, как лимитер неудачной аутентификации их запишет, поэтому
  вторая параллельная неверная повторная попытка уже может показать `retry later`.
* Для шагов восстановления при расхождении токенов следуйте [контрольному списку восстановления при расхождении токенов](/ru/cli/devices#token-drift-recovery-checklist).
* Получите или передайте общий секрет с хоста Gateway:
  * Токен: `openclaw config get gateway.auth.token`
  * Пароль: разрешите настроенный `gateway.auth.password` или
    `OPENCLAW_GATEWAY_PASSWORD`
  * Токен, управляемый SecretRef: разрешите внешний поставщик секретов или экспортируйте
    `OPENCLAW_GATEWAY_TOKEN` в этой оболочке, затем повторно выполните `openclaw dashboard`
  * Общий секрет не настроен: `openclaw doctor --generate-gateway-token`
* В настройках панели вставьте токен или пароль в поле аутентификации,
  затем подключитесь.
* Переключатель языка UI находится в **Overview -> Gateway Access -> Language**.
  Он является частью карточки доступа, а не раздела Appearance.

## См. также

* [Интерфейс управления](/ru/web/control-ui)
* [WebChat](/ru/web/webchat)
