macOS companion app

WebChat (macOS)

L’application de barre des menus macOS intègre l’interface WebChat sous forme de vue SwiftUI native. Elle se connecte au Gateway et utilise par défaut la session principale de l’agent sélectionné (main, ou global lorsque session.scope vaut global).

La fenêtre de discussion complète est une vue fractionnée native :

Barre latérale des sessions : liste de sessions avec recherche, sections épinglées et récentes, indicateurs de messages non lus et menus contextuels permettant d’épingler ou de désépingler une session, de copier sa clé et de la supprimer. Un bouton de la barre d’outils (ou Cmd-N) crée une véritable nouvelle session via sessions.create.
Barre d’outils de la fenêtre : anneau d’utilisation du contexte (jetons et coût de la session, avec une action compacte), sélecteur du niveau de réflexion, sélecteur de modèle et menu d’actions de session (nouvelle session, actualiser, copier la clé de session, exporter la transcription, compacter, effacer l’historique).
Transcription et zone de rédaction : les messages de l’assistant s’affichent en texte brut avec un avatar, tandis que ceux de l’utilisateur apparaissent dans des bulles avec une couleur d’accentuation. La saisie de / ouvre la saisie semi-automatique des commandes slash, alimentée par commands.list, avec navigation au clavier à l’aide des touches fléchées, Tab, Return et Escape. Faites un clic droit sur un message pour le copier.

Le panneau de discussion rapide ancré à la barre des menus conserve une disposition compacte sur une seule colonne avec des sélecteurs intégrés.

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

Manuellement : menu Lobster -> "Open Chat".
Ouverture automatique pour les tests :
bash
```
dist/OpenClaw.app/Contents/MacOS/OpenClaw --chat
```
(--webchat est accepté comme alias hérité.)
Journaux : ./scripts/clawlog.sh (sous-système ai.openclaw, catégorie WebChatSwiftUI).

Fonctionnement du câblage

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 une transcription normalisée pour l’affichage : les balises de directives intégrées sont retirées du texte visible, les charges utiles XML d’appels d’outils en texte brut (<tool_call>, <function_call>, <tool_calls>, <function_calls>, y compris les blocs tronqués) ainsi que les jetons de contrôle du modèle divulgués sont supprimés, les lignes de l’assistant composées uniquement de jetons silencieux tels que les valeurs exactes NO_REPLY/no_reply sont omises, et les lignes trop volumineuses peuvent être remplacées par un espace réservé indiquant leur troncation.
Session : utilise par défaut la session principale comme indiqué ci-dessus ; l’interface permet de passer d’une session à une autre.
L’intégration initiale utilise une session dédiée afin de séparer la configuration de première exécution.
Cache hors ligne : l’application conserve un petit cache en lecture seule des sessions de discussion et transcriptions récentes pour chaque Gateway (~/Library/Application Support/OpenClaw/chat-cache.sqlite) : lors d’un démarrage à froid, elle affiche immédiatement la dernière transcription connue et l’actualise dès que le Gateway répond ; les discussions récentes restent consultables en cas de déconnexion, mais l’envoi demeure désactivé jusqu’au rétablissement de la connexion.

Surface de sécurité

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

Limitations connues

L’interface est optimisée pour les sessions de discussion, et non pour servir de bac à sable de navigateur complet.

Voir aussi

Was this useful?