WebChat (macOS)

L'app della barra dei menu di macOS incorpora l'interfaccia WebChat come vista SwiftUI nativa. Si connette al Gateway e usa per impostazione predefinita la sessione principale dell'agente selezionato (main oppure global quando session.scope è global).

La finestra di chat completa è una vista divisa nativa:

• Barra laterale delle sessioni: elenco ricercabile delle sessioni con sezioni per quelle fissate e recenti, indicatori dei messaggi non letti e menu contestuali per fissare/rimuovere, copiare la chiave di sessione ed eliminare. Un pulsante della barra degli strumenti (o Cmd-N) crea una nuova sessione effettiva tramite sessions.create.
• Barra degli strumenti della finestra: indicatore circolare dell'utilizzo del contesto (token e costo della sessione, con un'azione compatta), selettore del livello di ragionamento, selettore del modello e menu delle azioni della sessione (nuova sessione, aggiorna, copia la chiave di sessione, esporta la trascrizione, esegui la Compaction, cancella la cronologia).
• Trascrizione e campo di composizione: i messaggi dell'assistente vengono visualizzati come testo semplice con un avatar, mentre quelli dell'utente come fumetti con colore in risalto. Digitando / si apre il completamento automatico dei comandi slash basato su commands.list, con navigazione da tastiera tramite frecce/Tab/Invio/Esc. Fai clic con il pulsante destro su un messaggio per copiarlo.

Il pannello di chat rapida ancorato alla barra dei menu mantiene il layout compatto a colonna singola con selettori incorporati.

• Modalità locale: si connette direttamente al WebSocket del Gateway locale.
• Modalità remota: inoltra la porta di controllo del Gateway tramite SSH e utilizza questo tunnel come piano dati.

Avvio e debug

• Manuale: menu Lobster -> "Open Chat".

• Apertura automatica per i test:

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

  (--webchat è accettato come alias legacy.)

• Log: ./scripts/clawlog.sh (sottosistema ai.openclaw, categoria WebChatSwiftUI).

Come è collegato

• Piano dati: metodi WS del Gateway chat.history, chat.send, chat.abort, chat.inject ed eventi chat, agent, presence, tick, health.
• chat.history restituisce una trascrizione normalizzata per la visualizzazione: i tag delle direttive incorporate vengono rimossi dal testo visibile; i payload XML delle chiamate agli strumenti in testo semplice (<tool_call>, <function_call>, <tool_calls>, <function_calls>, inclusi i blocchi troncati) e i token di controllo del modello fuoriusciti vengono rimossi; le righe dell'assistente contenenti esclusivamente token silenziosi, come esattamente NO_REPLY/no_reply, vengono omesse; le righe di dimensioni eccessive possono essere sostituite con un segnaposto troncato.
• Sessione: per impostazione predefinita usa la sessione principale come indicato sopra; l'interfaccia può passare da una sessione all'altra.
• La procedura di configurazione iniziale usa una sessione dedicata per mantenere separata la configurazione del primo avvio.
• Cache offline: l'app conserva una piccola cache di sola lettura delle sessioni di chat e delle trascrizioni recenti per ciascun Gateway (~/Library/Application Support/OpenClaw/chat-cache.sqlite): all'avvio a freddo mostra immediatamente l'ultima trascrizione nota e la aggiorna non appena il Gateway risponde; inoltre, le chat recenti restano consultabili mentre non è disponibile una connessione (l'invio rimane disabilitato finché la connessione non viene ripristinata).

Superficie di sicurezza

• La modalità remota inoltra tramite SSH solo la porta di controllo WebSocket del Gateway.

Limitazioni note

• L'interfaccia è ottimizzata per le sessioni di chat, non come ambiente sandbox completo per browser.

Pagine correlate

• WebChat
• App macOS