Sessions
Monitor active and historical conversations across all your agents.
/sessionsOverview#
The Sessions page tracks every conversation between users and your OpenClaw agents. Each session captures the full message thread, tool invocations, cost attribution, and timing data. This gives you complete visibility into what your agents are actually doing — not just their configuration, but their runtime behavior.
Sessions are automatically collected from OpenClaw session logs. You can view them in a matrix layout (agents × active sessions), browse a filterable list, drill into individual conversations, or review aggregated statistics. A live indicator powered by Server-Sent Events (SSE) shows real-time session status without manual refreshing.
Prerequisites#
- At least one connector synced and connected (see Connectors)
- Agents that have processed at least one conversation (sessions are created when agents handle requests)
Expected Results#
After syncing, the Sessions page offers three main views:
- -Matrix View: A grid of agents with their active sessions displayed as columns, each with a health status dot indicating session state (active, completed, errored)
- -Session List: A paginated, filterable table of all sessions with type, status, agent name, duration, and cost columns
- -Stats View: Aggregated metrics including total session count, currently active sessions, average session duration, and average cost per session
The live indicator in the page header shows a green pulse when connected to the SSE stream. Active sessions update their status automatically without page reloads.
If historical session data is not yet synced, use the Backfill button to pull session history from OpenClaw. This is a one-time operation that imports past sessions into ClawButler.
Web Operations#
Navigate to Sessions from the Operate section in the sidebar.
Matrix View
The matrix displays one row per agent with active sessions spread across columns. Each cell shows a health dot: green for active and healthy, amber for long-running, red for errored. Click any cell to jump directly to that session's detail view. Agents with no active sessions show an empty row.
Session List
Switch to the list tab for a full history of sessions. Filter by session type (chat, task, cron), status (active, completed, errored, timed_out), and date range. Sort by start time, duration, or cost. Pagination defaults to 20 items per page.
Session Detail
Click any session to view the full conversation thread. Each message shows the role (user or assistant), content, and timestamp. Tool calls are displayed inline with expand/collapse toggles to inspect parameters and return values. Per-message cost is shown on assistant messages when available.
Stats View
The stats tab shows aggregated session metrics: total sessions, active count, average duration, and average cost per session. Charts visualize session volume over time and cost distribution across agents.
Live Updates
An SSE connection keeps the page in sync with the server. The live indicator pulses green when connected. New sessions appear automatically, and active sessions update their status in real-time. If the connection drops, the indicator turns gray and reconnects automatically.
CLI Operations#
List recent sessions with optional filters (agent, status, date range)
$ ap session listView the full detail of a specific session including messages, tool calls, and cost
$ ap session show <id>Mobile Operations#
On mobile, sessions are accessible from the Ops tab. Select the 'Sessions' segment at the top.
- -Session list with status badges and agent avatars
- -Tap a session to view the full conversation thread with tool call details
- -Pull-to-refresh to reload session data