Live Sessions Dashboard

---

name: sessions-dashboard description: Live dashboard viewer for OpenClaw sessions (CLI + web) that shows color-coded states, token/cost totals, and shareable HTML panels. Requires local OpenClaw CLI access (openclaw sessions and optional openclaw logs). Created by Nate Teshome (stellarsitesai.com).

---

Sessions Dashboard ("Live Dashboard Viewer")

Creator: Nate Teshome —

What this skill delivers

Color-coded CLI monitor (scripts/agents_cli_monitor.py): RUN/IDLE/STALE/EXIT states, runtime, last update, token + USD estimates, model/kind, plus a live KPI banner (state counts, Σ tokens/cost, longest run, avg lag).

Shareable HTML dashboard (scripts/agents_canvas_snapshot.py): dark-mode cards + table, status pills, runtime/lag columns, and auto-refresh browser view for leadership/client reviews.

Looping web generator (--loop ): continuously rewrites the HTML so you don’t need separate watch commands. Pair with the built-in (default 5 s) for a true live panel.

Use this when you need a polished, always-on view of every OpenClaw session—perfect for ops rooms, agency war rooms, or lightweight audits.

Requirements & security

OpenClaw CLI (openclaw >= 2025.x) must be installed and authenticated so openclaw sessions --json works.

Optional log tail: the CLI monitor subscribes to openclaw logs --json --follow for instant RUN/IDLE bumps. Those logs can contain prompts, tool arguments, secrets, or PII. Nothing is printed or stored, but if you don’t want to expose log contents, pass --no-subscribe (poll-only) or run on a machine without log access.

- Set AGENT_MONITOR_NO_SUBSCRIBE=1 to default to poll-only everywhere; pass --subscribe to override per run.

Gateway scope: run the dashboard only on hosts that are already allowed to query your OpenClaw gateway; everything stays local/in-memory.

Directory

skills/sessions-dashboard/
├── SKILL.md
├── scripts/
│   ├── agents_cli_monitor.py        # Live terminal UI (color + KPI banner)
│   └── agents_canvas_snapshot.py    # HTML generator (+ --loop for continuous refresh)
└── assets/
    └── agents_canvas.html           # Default output target for the web panel

CLI monitor quick start

cd ~/.openclaw/workspace/skills/sessions-dashboard
./scripts/agents_cli_monitor.py --interval 2 --cost-per-1k 0.015

Key flags:

--interval SECONDS (default 3, min 0.5)

--active-minutes MINS (default 720) to widen the lookback

--agent / --all-agents to filter

--retention SECONDS (default 120) to control how long EXITED rows linger

--cost-per-1k USD or env AGENT_MONITOR_COST_PER_1K

--once for a single snapshot, --no-subscribe to disable the log tailer

What the CLI shows

State (RUN green, IDLE amber, STALE magenta, EXIT gray)

Runtime + start time for quick “how long has this been around?” checks

Last update lag (00:12 ago) to spot stuck sessions

Tokens & projected cost per session

Model / kind (channel) for context

KPI banner (top line) summarizing RUN/IDLE/STALE/EXIT counts, Σ tokens/cost, the longest-running session, and mean lag — ideal for screenshots or lightweight reporting.

Web dashboard (Canvas / browser)

Generate the HTML and keep it running in one command:

cd ~/.openclaw/workspace/skills/sessions-dashboard
./scripts/agents_canvas_snapshot.py \
  --loop 5 \
  --refresh 5 \
  --cost-per-1k 0.015 \
  --output assets/agents_canvas.html

What the script does:

Hits openclaw sessions --json on each loop.

Rebuilds assets/agents_canvas.html with cards (state counts, Σ tokens/cost, longest run, avg lag) plus the detailed table.

Inserts a so the browser (or Canvas tab) reloads itself every --refresh seconds.

When --loop > 0, the script stays alive forever and rewrites the file at that cadence (Ctrl+C to stop). No extra watch command needed.

Presenting the dashboard

Open locally: open assets/agents_canvas.html

Canvas: openclaw canvas present --path skills/sessions-dashboard/assets/agents_canvas.html

Remote share: host the HTML anywhere static files are allowed; it has no external dependencies.

Troubleshooting

command not found: chmod +x scripts/*.py and run from the skill directory (or use absolute paths).

Gateway errors: verify openclaw gateway status; the scripts just print the stderr and retry.

No color in CLI: set NO_COLOR=1 to disable, otherwise the monitor auto-detects TTY support.

Browser not updating: make sure --loop is running so the HTML file actually changes; --refresh only reloads the page.

Cost column blank: pass --cost-per-1k or export AGENT_MONITOR_COST_PER_1K to enable projections.

Release notes (current version)

Added colorized states + KPI banner to the CLI monitor.

Added looping mode and a polished dark-mode layout for the HTML dashboard.

Default assets are optimized for screenshots / executive readouts.

That’s it—launch the CLI, fire up the live HTML panel, and give your team a real-time Sessions Dashboard without cobbling together spreadsheets.

command not found: chmod +x scripts/*.py and run from the skill directory (or use absolute paths).

Gateway errors: verify openclaw gateway status; the scripts just print the stderr and retry.

No color in CLI: set NO_COLOR=1 to disable, otherwise the monitor auto-detects TTY support.

Browser not updating: make sure --loop is running so the HTML file actually changes; --refresh only reloads the page.

Cost column blank: pass --cost-per-1k or export AGENT_MONITOR_COST_PER_1K to enable projections.