Subagent Dashboard Skill

Web dashboard for real-time monitoring and management of OpenClaw subagents.

Installation

cd workspace/skills/subagent-dashboard/scripts
./start_dashboard.sh

Or manually:

python3 -m venv venv
source venv/bin/activate
pip install -r ../requirements.txt
python3 dashboard.py

Usage

Start the dashboard and open http://localhost:8080 in your browser.

The dashboard shows:

• All sessions from sessions.json: main (orchestrator), subagents, and optionally cron jobs
• Real-time updates (auto-refresh every 3 seconds)
• Agent details: model, age, tokens, task progress; role badges (Main / Subagent / Cron)
• Transcript viewing for each agent
• Stalled agent detection (>30 min inactive)

Purpose

Provides a web UI to:

• Monitor active subagents in real-time
• View agent transcripts and activity
• Detect and manage stalled agents
• Track task progress and token usage

Dependencies

• Flask (web server)
• flask-cors (CORS support)
• Subagent-tracker skill (for data)

Configuration

Set PORT environment variable to change the server port (default: 8080).

Integration

The dashboard uses the subagent-tracker skill to fetch data. It reads:

• ~/.openclaw/agents/main/sessions/sessions.json - Session list
• ~/.openclaw/agents/main/sessions/*.jsonl - Transcript files
• ~/.openclaw/agents/main/subagents/runs.json - Task mapping (and legacy ~/.openclaw/subagents/runs.json)

Completed column: For finished tasks to appear in the Completed column, the run in runs.json must have endedAt (timestamp) and outcome.status set to "ok", "completed", or "success" when the sub-agent finishes. The dashboard appends "recently completed" runs (within 24h) even if the session was removed from sessions.json.