task-monitor

What This Skill Does

The Task Monitor skill provides a robust, real-time web-based dashboard designed specifically for OpenClaw agents. By serving a lightweight, mobile-responsive UI on a local Node.js server, it allows users to keep a constant eye on the health and status of their autonomous operations. The skill aggregates data from main sessions, Discord integrations, active sub-agent threads, and scheduled cron jobs, presenting them in a clean, dark-themed gradient interface. Engineered for performance, the backend employs a smart 30-second TTL (Time-To-Live) cache with stale-while-revalidate logic, ensuring that API response times remain under 100ms even when underlying system processes take longer to execute. It effectively bridges the gap between terminal-based output and a visually accessible management console.

Installation

To integrate this skill into your environment, ensure you have Node.js installed. First, clone the repository or pull the skill via the ClawHub CLI using: clawhub install openclaw/skills/skills/jorgermp/task-monitor. Once installed, navigate to the directory cd skills/task-monitor and execute npm install to resolve all dependencies. To start the monitoring server, run ./scripts/start-server.sh, which will initialize the dashboard on port 3030. You can then access it via your web browser at http://localhost:3030 or from any device on your local network using your machine's IP address.

Use Cases

This skill is perfect for developers and power users who manage multiple long-running OpenClaw agents. Use it to verify that sub-agents are performing their duties without needing to check logs in the terminal. It is particularly useful for remote monitoring, allowing you to check the status of a home-server or workstation agent via a tablet or phone while away from your primary desk. Furthermore, it serves as a great audit tool for verifying cron job history, confirming that routine cleanup or data-processing tasks triggered at specific intervals are completing successfully.

Example Prompts

1. "OpenClaw, please trigger the task-monitor dashboard and give me a summary of my current active sub-agents."
2. "Can you check if the task-monitor server is running and provide me with the latest status of my Discord session?"
3. "Refresh the task-monitor dashboard and let me know if any cron jobs have failed in the last hour."

Tips & Limitations

For optimal performance, keep the browser tab open; the dashboard utilizes client-side polling every 60 seconds to maintain data freshness. Note that because the tool reads session data directly from the system, it requires local network access to view the dashboard from external devices. If you are running the agent in a container, ensure port 3030 is correctly mapped. While the dashboard supports legacy markdown generation, favor the web interface for the most current data representation. Avoid running multiple instances of the server simultaneously to prevent port collisions on 3030.