- name
- subagent-dashboard
- displayName
- Subagent Dashboard
- description
- Web dashboard for real-time monitoring and management of OpenClaw subagents. Use when monitoring or managing subagents.
Subagent Dashboard Skill
Web dashboard for real-time monitoring and management of OpenClaw subagents.
Installation
cd workspace/skills/subagent-dashboard/scripts
./start_dashboard.shOr manually:
python3 -m venv venv
source venv/bin/activate
pip install -r ../requirements.txt
python3 dashboard.pyUsage
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.