ClawHub

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...

Audits

Pass
ClawScanPass

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install activityclaw-usage

ActivityClaw Plugin Usage

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:

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

Quick Start

Check if ActivityClaw is installed and running:

openclaw activityclaw status

Commands

View Dashboard

Open the visual activity dashboard in browser:

openclaw activityclaw dashboard

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

Check Status

Show current status and configuration:

openclaw activityclaw status

Start/Stop

Manually control the service:

openclaw activityclaw start
openclaw activityclaw stop

Configuration

Reconfigure port or database location:

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:

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:

openclaw activityclaw dashboard

Filter by "⚡ Exec" to see command history.

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

Response:

openclaw activityclaw status

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

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:

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