跳轉到主要內容

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.

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.historychat.sendchat.abortchat.inject,以及事件 chatagentpresencetickhealth
  • 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 已針對聊天工作階段最佳化(不是完整的瀏覽器沙箱)。

相關