Control UI — это веб-панель управления OpenClaw. Через неё вы можете общаться с агентом, менять настройки, управлять навыками, следить за cron-задачами и просматривать логи — всё в браузере, без командной строки.
Как открыть
Control UI запускается автоматически вместе с Gateway. Откройте в браузере:
http://localhost:18789/
Если Gateway работает на другом порту или хосте — измените адрес соответственно.
Первое подключение
При первом входе с нового устройства потребуется device pairing — одноразовое одобрение. Это защита от несанкционированного доступа, даже в локальной сети.
Исключение: подключение с 127.0.0.1 / localhost одобряется автоматически.
Для удалённых подключений одобрите устройство через CLI:
openclaw pair approve <device-id>
Аутентификация
Control UI поддерживает несколько способов входа:
| Способ | Когда использовать |
|---|---|
| Shared-secret token | По умолчанию для локального доступа |
| Пароль | Удобно для браузера |
| Tailscale identity | Для удалённого доступа через Tailscale |
| Trusted-proxy headers | Для reverse proxy (nginx, Caddy) |
Настраивается в openclaw.json:
{
connect: {
params: {
auth: {
token: "ваш-секретный-токен"
// или
// password: "ваш-пароль"
}
}
}
}
Чат с агентом
Главная функция Control UI — чат в реальном времени:
- Стриминг ответов по мере генерации
- Live-отображение tool calls и их результатов
- Кнопка остановки (или команда
/stop) для прерывания генерации - История сообщений с поиском
- Injection — вставка заметок в transcript без запуска агента
Чат работает через WebSocket напрямую к Gateway. Сообщения отправляются с idempotency key — повторная отправка не создаёт дублей.
Slash-команды в чате
Прямо из чата доступны команды:
/stop— остановить текущую генерацию/model <name>— сменить модель/fast— переключить быстрый режим/status— показать статус сессии/steer— перенаправить активный run/compact— сжать контекст
Управление конфигурацией
Редактируйте openclaw.json прямо из браузера:
- Форма — визуальный редактор с полями, переключателями и подсказками
- Raw JSON — текстовый редактор для опытных пользователей
- Валидация — ошибки подсвечиваются до сохранения
- Перезапуск — применение изменений с автоматическим рестартом gateway
- Защита — base-hash guard предотвращает потерю изменений при одновременном редактировании
Секретные данные (API-ключи, токены) скрыты по умолчанию — для редактирования нужно явно раскрыть поле.
Каналы и интеграции
Панель каналов показывает статус всех подключённых мессенджеров:
- Telegram — статус бота, ошибки доставки
- WhatsApp — QR-логин прямо из UI
- Discord — состояние gateway-подключения
- Slack, Teams, Matrix и другие — per-channel статус
Для каждого канала доступны настройки без правки конфига вручную.
Навыки (Skills)
Управление навыками с фильтрацией по статусу:
| Фильтр | Что показывает |
|---|---|
| All | Все навыки |
| Ready | Готовы к использованию |
| Needs Setup | Требуют настройки (API-ключ, зависимости) |
| Disabled | Отключены |
Для каждого навыка доступен детальный диалог:
- Описание и требования
- Переключатель вкл/выкл
- Кнопка установки зависимостей
- Ввод API-ключа с подсказкой, где его получить
- Ссылка на документацию
Сессии и модели
Переключайте параметры сессии на лету:
- Модель — выбор из доступных провайдеров (Claude, GPT, Gemini, Qwen и др.)
- Thinking — включение/отключение режима рассуждений
- Fast mode — быстрые ответы за счёт упрощённого reasoning
- Verbose — подробные ответы с деталями tool calls
Изменения применяются к текущей сессии — не затрагивают глобальный конфиг.
Инструменты агента
Панель Tools показывает, какие инструменты доступны агенту прямо сейчас:
- Available Right Now — инструменты, доступные в текущей сессии
- Tool Configuration — полный каталог с настройками
Полезно для отладки: если агент не может выполнить действие — проверьте, доступен ли нужный инструмент.
Файлы агента (Workspace)
Панель Files в разделе агентов:
- Список файлов workspace агента
- Раскрываемые строки с lazy-loaded markdown preview
- Стилизация: заголовки, таблицы, code blocks, callouts
- Адаптация к light/dark теме
Cron-задачи
Полное управление автоматизацией:
- Создание — новая задача с расписанием, сообщением и каналом доставки
- Редактирование — изменение расписания, текста, параметров
- Запуск вручную — тестирование без ожидания расписания
- Включение/отключение — без удаления
- История запусков — результаты предыдущих выполнений
Дополнительные параметры:
- Webhook delivery с bearer-токеном
- Announce — доставка результата в указанный канал (Telegram, Slack и др.)
- Delete-after-run — одноразовые задачи
- Agent model override — другая модель для конкретной задачи
Администрирование
Ноды
Список подключённых нод (устройства: Android, Raspberry Pi и др.):
- Статус подключения
- Capabilities — что умеет нода
- Управление pairing
Exec Approvals
Управление разрешениями на выполнение команд:
- Allowlist для gateway и нод
- Одобрение/отклонение pending-запросов
- История решений
Логи
Live-тейлинг логов gateway в реальном времени:
- Фильтрация по уровню и компоненту
- Экспорт логов
- Health snapshots
Обновления
Обновление OpenClaw прямо из UI:
- Проверка новых версий (npm или git)
- Установка обновления
- Автоматический перезапуск
Удалённый доступ
Control UI — это admin-панель, и она не должна быть открыта в публичный интернет.
Рекомендуемые способы удалённого доступа
Tailscale (рекомендуется):
tailscale serve 18789
Доступ через https://<magicdns>/ — шифрование, аутентификация, без открытых портов.
В openclaw.json:
{
gateway: {
auth: {
allowTailscale: true
}
}
}
SSH-туннель:
ssh -L 18789:127.0.0.1:18789 user@your-vps
После этого откройте http://localhost:18789/ на локальной машине.
Что НЕ делать
- Не открывайте порт 18789 наружу без аутентификации
- Не используйте
dangerouslyDisableDeviceAuthв продакшене - Не ставьте wildcard в
allowedOrigins
Настройка базового пути
Если нужно разместить UI по другому пути (например, за reverse proxy):
{
gateway: {
controlUi: {
basePath: "/openclaw/"
}
}
}
TUI — терминальная альтернатива
Для тех, кто предпочитает работать в терминале, есть TUI (Terminal User Interface):
openclaw tui
TUI подключается к тому же Gateway через WebSocket и предоставляет:
- Чат с агентом в терминале
- Выбор сессии (
--session main) - Автоопределение агента при запуске из workspace-директории
- Поддержка SecretRef для аутентификации
Подключение к удалённому Gateway
openclaw tui --url ws://your-server:18789 --token <token>
Локализация
Control UI поддерживает 13 языков:
🇬🇧 English, 🇨🇳 简体中文, 🇹🇼 繁體中文, 🇧🇷 Português, 🇩🇪 Deutsch, 🇪🇸 Español, 🇯🇵 日本語, 🇰🇷 한국어, 🇫🇷 Français, 🇹🇷 Türkçe, 🇺🇦 Українська, 🇮🇩 Indonesia, 🇵🇱 Polski
Выбор языка сохраняется в браузере. Нерусские переводы загружаются динамически.
Полезные ссылки
- Документация: Control UI — официальный гайд
- Документация: TUI — терминальный интерфейс
- Настройка Gateway — конфигурация gateway
- Настройка OpenClaw — полный гайд по конфигу
- Cron и автоматизация — подробнее о cron-задачах
- Навыки OpenClaw — каталог навыков