WebChat（macOS）

macOS 選單列應用程式會將 WebChat UI 嵌入為原生 SwiftUI 檢視。它會連線至 Gateway，並預設使用所選代理程式的 主要工作階段（並提供可切換至其他工作階段的工作階段切換器）。

• 本機模式：直接連線至本機 Gateway WebSocket。
• 遠端模式：透過 SSH 轉送 Gateway 控制連接埠，並使用該通道作為資料平面。

# 啟動與偵錯

• 手動：Lobster 選單 →「開啟聊天」。

• 測試時自動開啟：

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

• 記錄：./scripts/clawlog.sh（子系統 ai.openclaw，類別 WebChatSwiftUI）。

# 連接方式

• 資料平面：Gateway WS 方法 chat.history、chat.send、chat.abort、chat.inject，以及事件 chat、agent、presence、tick、health。
• chat.history 會傳回已針對顯示正規化的逐字稿列：行內指令標籤會從可見文字中移除；純文字工具呼叫 XML 酬載（包括 <tool_call>...</tool_call>、<function_call>...</function_call>、<tool_calls>...</tool_calls>、<function_calls>...</function_calls>，以及截斷的工具呼叫區塊）和外洩的 ASCII/全形模型控制權杖會被移除；僅含靜默權杖的助理列，例如完全符合 NO_REPLY / no_reply，會被省略；過大的列可替換為預留位置。
• 工作階段：預設使用主要工作階段（main，或當範圍為全域時使用 global）。UI 可在不同工作階段之間切換。
• 入門設定會使用專用工作階段，讓首次執行設定保持獨立。

# 安全面

• 遠端模式只會透過 SSH 轉送 Gateway WebSocket 控制連接埠。

# 已知限制

• UI 已針對聊天工作階段最佳化（不是完整的瀏覽器沙箱）。

# 相關

• WebChat
• macOS 應用程式