macOS 選單列應用程式會將 WebChat UI 嵌入為原生 SwiftUI 檢視。它 會連線到 Gateway,並預設使用所選代理的主工作階段 (並提供可切換至其他工作階段的工作階段切換器)。Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
- 本機模式:直接連線到本機 Gateway WebSocket。
- 遠端模式:透過 SSH 轉送 Gateway 控制連接埠,並使用該 通道作為資料平面。
啟動與除錯
- 手動:Lobster 選單 →「開啟聊天」。
-
測試時自動開啟:
-
日誌:
./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 已針對聊天工作階段最佳化(不是完整的瀏覽器沙箱)。