Chat Web (macOS)

L’application de la barre de menus macOS intègre l’interface WebChat comme vue SwiftUI native. Elle se connecte au Gateway et utilise par défaut la session principale pour l’agent sélectionné (avec un sélecteur de session pour les autres sessions).

• Mode local : se connecte directement au WebSocket du Gateway local.
• Mode distant : transfère le port de contrôle du Gateway via SSH et utilise ce tunnel comme plan de données.

# Lancement et débogage

• Manuel : menu Lobster → « Open Chat ».

• Ouverture automatique pour les tests :

  dist/OpenClaw.app/Contents/MacOS/OpenClaw --webchat
  

• Journaux : ./scripts/clawlog.sh (sous-système ai.openclaw, catégorie WebChatSwiftUI).

# Comment il est raccordé

• Plan de données : méthodes WS du Gateway chat.history, chat.send, chat.abort, chat.inject et événements chat, agent, presence, tick, health.
• chat.history renvoie des lignes de transcription normalisées pour l’affichage : les balises de directive en ligne sont supprimées du texte visible, les charges utiles XML d’appels d’outils en texte brut (notamment <tool_call>...</tool_call>, <function_call>...</function_call>, <tool_calls>...</tool_calls>, <function_calls>...</function_calls>, ainsi que les blocs d’appels d’outils tronqués) et les jetons de contrôle de modèle ASCII/pleine chasse divulgués sont supprimés, les lignes d’assistant composées uniquement de jetons silencieux comme exactement NO_REPLY / no_reply sont omises, et les lignes surdimensionnées peuvent être remplacées par des espaces réservés.
• Session : utilise par défaut la session principale (main, ou global lorsque la portée est globale). L’interface peut basculer entre les sessions.
• L’intégration initiale utilise une session dédiée afin de séparer la configuration du premier lancement.

# Surface de sécurité

• Le mode distant ne transfère que le port de contrôle WebSocket du Gateway via SSH.

# Limitations connues

• L’interface est optimisée pour les sessions de chat (pas pour un bac à sable de navigateur complet).

# Connexe

• WebChat
• application macOS