ActivityClaw Plugin Usage

Monitors and reports agent activities including file operations, command executions, web actions, messages, and sub-agent sessions via dashboard and status c...

When to Use

Use this skill when the user asks about:

• Recent agent activities or actions
• What the agent has been doing
• Tool usage tracking or monitoring
• File operations history (reads, writes, edits)
• Command execution history
• Web searches or fetches performed
• Message sending activity
• Sub-agent spawning

Prerequisites

The ActivityClaw plugin must be installed:

bash

npm install -g @rmruss2022/activityclaw
openclaw plugins install @rmruss2022/activityclaw

Quick Start

Check if ActivityClaw is installed and running:

bash

openclaw activityclaw status

Commands

View Dashboard

Open the visual activity dashboard in browser:

bash

openclaw activityclaw dashboard

This opens http://localhost:18796 with real-time activity feed.

Check Status

Show current status and configuration:

bash

openclaw activityclaw status

Start/Stop

Manually control the service:

bash

openclaw activityclaw start
openclaw activityclaw stop

Configuration

Reconfigure port or database location:

bash

openclaw activityclaw setup

What ActivityClaw Tracks

• 📝 File Operations - Creates, edits, reads
• ⚡ Commands - Shell executions via exec
• 🔍 Web Activity - Searches and fetches
• 💬 Messages - Outbound messages to channels
• 🚀 Sub-agents - Spawned agent sessions

Dashboard Features

The dashboard at http://localhost:18796 provides:

• Real-time activity feed - Live stream of all agent actions
• Activity filters - View by type (files, commands, web, messages)
• Statistics - Total activities, last hour count, active agents
• Auto-refresh - Updates every 5 seconds

Example Usage

User asks: "What files have I been working on today?"

Response:

bash

openclaw activityclaw dashboard

Then check the "📝 Create" and "✏️ Edit" filters in the dashboard to see recent file operations.

User asks: "Show me recent command executions"

Response:

bash

openclaw activityclaw dashboard

Filter by "⚡ Exec" to see command history.

User asks: "What has the agent been doing?"

Response:

bash

openclaw activityclaw status

This shows a summary, then suggest opening the dashboard for details:

bash

openclaw activityclaw dashboard

Troubleshooting

If activities aren't showing:

1. Check plugin status: openclaw plugins list
2. Verify service is running: openclaw activityclaw status
3. Start if stopped: openclaw activityclaw start
4. Check dashboard URL: http://localhost:18796

If port is in use:

bash

openclaw activityclaw setup
# Choose a different port

Technical Details

• Port: 18796 (default, configurable)
• Database: SQLite at ~/.openclaw/activity-tracker/activities.db
• Tracking: Real-time via tool_result_persist hook
• Storage: All data stays local

Repository

GitHub: https://github.com/rmruss2022/ActivityClaw npm: @rmruss2022/activityclaw