modbender 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:
- Check plugin status:
openclaw plugins list - Verify service is running:
openclaw activityclaw status - Start if stopped:
openclaw activityclaw start - 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_persisthook - Storage: All data stays local
Repository
GitHub: https://github.com/rmruss2022/ActivityClaw npm: @rmruss2022/activityclaw