Skip to content

Sessions

Overview

The Sessions panel provides real-time monitoring of all OpenClaw agent sessions. Sessions are displayed as cards with status indicators, token usage, and model information.

Session Status

Session status is determined by the time since last update:

StatusConditionIndicator
ActiveLast updated < 30 minutes ago🟢 Green dot with glow
IdleLast updated 30 minutes – 24 hours ago⚪ Gray dot
DoneLast updated > 24 hours ago🔵 Blue dot

Session Cards

Each session card displays:

  • Display name — session identifier or label
  • Model — the AI model being used (e.g., Claude Opus 4.6)
  • Channel — messaging channel (Telegram, Discord, etc.)
  • Token usage — total tokens consumed with a progress bar
  • Status — active/idle/done indicator
  • Last updated — relative timestamp

Sub-agents

Sessions with spawned sub-agents show a tree structure. Click the expand chevron to reveal child sessions. Sub-agents display as compact cards nested under their parent.

View Modes

Active

Shows only sessions with ACTIVE status (updated within last 30 minutes). Default view.

All

Shows all sessions regardless of status, including idle and completed ones.

Sorting

  • Recent — sorted by last update time (default)
  • Token — sorted by total token consumption, highest first
  • Group — sorted alphabetically by display name

Gateway Status

The top bar displays the connected OpenClaw gateway's status, version, and uptime. If the gateway becomes unreachable, a stale overlay appears on the dashboard indicating the data may be outdated. Gateway health is also available via the GraphQL API.

Empty State

When no sessions match the current filter, an empty state is shown with:

  • A status legend explaining Active / Idle / Done thresholds
  • Contextual message based on the current view mode

Released under the MIT License.