MonoClaw

Built-in Plugins

MonoClaw ships with several built-in plugins that run automatically via lifecycle hooks. They require no configuration and help keep your system healthy.

Disk cleanup

Hook: session_end

Automatically cleans up temporary files created during sessions:

  • Removes /tmp/monoclaw-* files older than 24 hours
  • Clears browser download cache
  • Archives old session logs

Configuration

# ~/.monoclaw/config.yaml
plugins:
  disk_cleanup:
    enabled: true
    max_log_age: "7d"
    max_temp_age: "24h"

Session analytics

Hook: session_end

Tracks anonymous usage metrics to help improve Mona:

  • Session duration
  • Tool usage counts
  • Model response times
  • Error rates

Privacy

  • Metrics are anonymized (no message content)
  • Stored locally in ~/.monoclaw/analytics/
  • Optional opt-out:
plugins:
  session_analytics:
    enabled: false

Auto-save

Hook: pre_message

Automatically saves the session before each user message:

  • Protects against crashes
  • Enables precise rollback
  • Stores in ~/.monoclaw/sessions/auto/

Configuration

plugins:
  auto_save:
    enabled: true
    max_auto_saves: 50

Gateway health check

Hook: gateway_message

Monitors gateway health:

  • Tracks response times
  • Detects stuck processes
  • Auto-restarts unhealthy gateways

Alerts

When issues are detected:

  • Logs to ~/.monoclaw/logs/gateway-health.log
  • Sends admin notification (if configured)
  • Triggers auto-restart after 3 consecutive failures

Cron scheduler

Hook: session_start

Loads and validates cron jobs:

  • Checks job schedules
  • Validates prompts and delivery targets
  • Reports invalid jobs

Configuration

plugins:
  cron_scheduler:
    enabled: true
    max_jobs: 100

MCP auto-discovery

Hook: session_start

Automatically discovers MCP servers:

  • Scans ~/.monoclaw/mcp-servers/ for configs
  • Validates server health
  • Reports unavailable servers

Security scanner

Hook: pre_tool_call

Scans tool calls for security issues:

  • Detects credential leakage
  • Flags suspicious patterns
  • Blocks known dangerous commands

Configuration

plugins:
  security_scanner:
    enabled: true
    strict_mode: false  # Set true to block all suspicious calls

Disabling built-in plugins

You can disable any built-in plugin:

plugins:
  disk_cleanup:
    enabled: false
  session_analytics:
    enabled: false

Listing active plugins

monoclaw plugin list --built-in

Output:

Built-in Plugins
================
disk_cleanup       ✅ enabled
session_analytics  ✅ enabled
auto_save          ✅ enabled
gateway_health     ✅ enabled
cron_scheduler     ✅ enabled
mcp_discovery      ✅ enabled
security_scanner   ✅ enabled

Customizing built-in plugins

Most built-in plugins accept configuration in config.yaml. Check monoclaw plugin info <name> for plugin-specific options.