WebChat(macOSアプリ)

macOSメニューバーアプリはWebChat UIをネイティブSwiftUIビューとして組み込んでいます。Gatewayに接続し、選択されたエージェントのmainセッションをデフォルトとして使用します(他のセッションへの切り替えも可能)。

  • ローカルモード:ローカルGateway WebSocketに直接接続。
  • リモートモード:SSH経由でGatewayコントロールポートを転送し、そのトンネルをデータプレーンとして使用。

起動とデバッグ

  • 手動:Lobsterメニュー → 「Open Chat」。

  • テスト用の自動起動:

    dist/OpenClaw.app/Contents/MacOS/OpenClaw --webchat
  • ログ:./scripts/clawlog.sh(サブシステムai.openclaw、カテゴリWebChatSwiftUI)。

接続の仕組み

  • データプレーン:Gateway WSメソッドchat.historychat.sendchat.abortchat.inject、およびイベントchatagentpresencetickhealth
  • セッション:プライマリセッション(main、スコープがグローバルの場合はglobal)がデフォルト。UIでセッション間を切り替え可能。
  • オンボーディングは専用セッションを使用し、初回セットアップを分離。

セキュリティサーフェス

  • リモートモードではSSH経由でGateway WebSocketコントロールポートのみを転送。

既知の制限

  • UIはチャットセッション向けに最適化されています(完全なブラウザサンドボックスではありません)。