在 macOS 選單列直接使用 WebChat

開發 Agent 的時候，最麻煩的就是要一直切換視窗來測試對話。如果你厭倦了在瀏覽器標籤頁和程式碼之間跳來跳去，或是覺得只看終端機的 Log 太累人，直接在 macOS 選單列掛一個原生介面會輕鬆很多。

需要準備的東西

• macOS 裝置
• 運作中的 Gateway

快速開始

WebChat 是以 SwiftUI 打造的原生 macOS 選單列 App，它會直接連上 Gateway 來處理資料。

1. 啟動 WebChat 你可以從 Lobster 選單點選「Open Chat」，或者在測試時透過終端機啟動：

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

2. 選擇連線模式

• Local mode: 直接連線到本地端的 Gateway WebSocket。
• Remote mode: 透過 SSH 轉發 Gateway 的控制連接埠，並將該隧道作為資料傳輸平面。

3. 管理 Session App 預設會連接到 main session（若 scope 為 global 則為 global）。你可以透過介面上的切換器在不同 Session 間跳轉。第一次執行的 Onboarding 流程會使用獨立的 Session，確保不會弄亂你的正式設定。

4. 資料傳輸機制 WebChat 透過 WebSocket 處理以下方法與事件：

• 方法：chat.history, chat.send, chat.abort, chat.inject
• 事件：chat, agent, presence, tick, health

疑難排解

• 查看除錯日誌：如果遇到連線或顯示問題，可以使用腳本查看 bot.molt 子系統下的 WebChatSwiftUI 分類日誌：

  ./scripts/clawlog.sh

• 介面顯示異常：WebChat 的 UI 是針對聊天對話優化的，並非完整的瀏覽器沙盒。如果某些複雜網頁元素無法顯示，這是目前的已知限制。

設定上有任何疑問嗎？點擊 AI Setup Assistant 獲取即時協助。

下一步

• Gateway API 參考
• SSH 隧道設定指南