Files
openclaw-skill/openclaw-knowhow-skill/docs/infrastructure/platforms/mac/webchat.md
Selig 4c966a3ad2 Initial commit: OpenClaw Skill Collection
6 custom skills (assign-task, dispatch-webhook, daily-briefing,
task-capture, qmd-brain, tts-voice) with technical documentation.
Compatible with Claude Code, OpenClaw, Codex CLI, and OpenCode.
2026-03-13 10:58:30 +08:00

1.2 KiB

WebChat

Overview

The macOS menu bar application integrates WebChat as a native SwiftUI component, connecting to the Gateway with support for both local and remote operation modes.

Key Features

Connection Modes

  • Local mode: Links directly to the local Gateway WebSocket
  • Remote mode: Tunnels the Gateway control port through SSH

Session Management

The app defaults to the main session for the selected agent (with a session switcher for other sessions). Onboarding operates through a separate dedicated session.

Technical Details

Data Plane

The system uses Gateway WebSocket methods:

  • chat.history
  • chat.send
  • chat.abort
  • chat.inject

Corresponding events for:

  • Chat
  • Agent
  • Presence
  • Tick
  • Health monitoring

Launch Options

Access through multiple methods:

  • Lobster menu -> "Open Chat"
  • Testing launch: dist/OpenClaw.app/Contents/MacOS/OpenClaw --webchat
  • Logging via ./scripts/clawlog.sh (subsystem bot.molt, WebChatSwiftUI category)

Security & Constraints

  • Remote mode restricts forwarding to the Gateway WebSocket control port only
  • The interface is optimized for chat sessions (not a full browser sandbox)