---
read_when:
    - Отладка представления WebChat на macOS или порта loopback-интерфейса
summary: Как приложение для macOS встраивает WebChat шлюза Gateway и как выполнять его отладку
title: WebChat (macOS)
x-i18n:
    generated_at: "2026-07-13T18:19:01Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 24
    provider: openai
    source_hash: 7139ada530e4d5c3833500c36364d742dff301608a8a1a7902003b5f5384512c
    source_path: platforms/mac/webchat.md
    workflow: 16
---

Приложение для строки меню macOS встраивает интерфейс WebChat как нативное представление SwiftUI. Оно подключается к Gateway и по умолчанию использует основной сеанс выбранного агента (`main` или `global`, когда `session.scope` имеет значение `global`).

Полное окно чата представляет собой нативное разделённое представление:

- **Боковая панель сеансов**: список сеансов с поиском, разделами закреплённых и недавних сеансов, индикаторами непрочитанных сообщений и контекстными меню для закрепления и открепления, копирования ключа сеанса и удаления. Кнопка на панели инструментов (или Cmd-N) создаёт настоящий новый сеанс через `sessions.create`.
- **Панель инструментов окна**: кольцевой индикатор использования контекста (токены и стоимость сеанса, с компактным действием), средство выбора уровня рассуждений, средство выбора модели и меню действий с сеансом (новый сеанс, обновление, копирование ключа сеанса, экспорт расшифровки, Compaction, очистка истории).
- **Расшифровка и редактор сообщения**: сообщения ассистента отображаются как обычный текст с аватаром, а сообщения пользователя — как акцентные облачка. При вводе `/` открывается автодополнение слеш-команд на основе `commands.list` с навигацией с клавиатуры с помощью стрелок, Tab, Return и Escape. Чтобы скопировать сообщение, щёлкните его правой кнопкой мыши.

Закреплённая панель быстрого чата из строки меню сохраняет компактную одноколоночную компоновку со встроенными средствами выбора.

- **Локальный режим**: подключается непосредственно к локальному WebSocket Gateway.
- **Удалённый режим**: перенаправляет управляющий порт Gateway через SSH и использует этот туннель как канал передачи данных.

## Запуск и отладка

- Вручную: меню Lobster -> "Open Chat".
- Автоматическое открытие для тестирования:

  ```bash
  dist/OpenClaw.app/Contents/MacOS/OpenClaw --chat
  ```

  (`--webchat` поддерживается как устаревший псевдоним.)

- Журналы: `./scripts/clawlog.sh` (подсистема `ai.openclaw`, категория `WebChatSwiftUI`).

## Схема подключения

- Канал передачи данных: методы WS Gateway `chat.history`, `chat.send`, `chat.abort`, `chat.inject` и события `chat`, `agent`, `presence`, `tick`, `health`.
- `chat.history` возвращает нормализованную для отображения расшифровку: встроенные теги директив удаляются из видимого текста; XML-данные вызовов инструментов в виде обычного текста (`<tool_call>`, `<function_call>`, `<tool_calls>`, `<function_calls>`, включая усечённые блоки) и попавшие в вывод управляющие токены модели удаляются; строки ассистента, содержащие только служебный токен молчания, например точное значение `NO_REPLY`/`no_reply`, пропускаются; слишком большие строки могут заменяться усечённым заполнителем.
- Сеанс: по умолчанию используется основной сеанс, как описано выше; интерфейс позволяет переключаться между сеансами.
- Для первоначальной настройки используется отдельный сеанс, чтобы отделить её от обычной работы.
- Автономный кеш: приложение хранит небольшой кеш только для чтения с недавними сеансами чата и расшифровками для каждого Gateway (`~/Library/Application Support/OpenClaw/chat-cache.sqlite`). При холодном запуске сразу отображается последняя известная расшифровка, которая обновляется после ответа Gateway; недавние чаты остаются доступными для просмотра без подключения, но отправка сообщений отключена до его восстановления.

## Область безопасности

- В удалённом режиме через SSH перенаправляется только управляющий порт WebSocket Gateway.

## Известные ограничения

- Интерфейс оптимизирован для сеансов чата, а не для использования в качестве полноценной браузерной песочницы.

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

- [WebChat](/ru/web/webchat)
- [Приложение для macOS](/ru/platforms/macos)