Configuration

Config file location

~/.openclaw/workspace/clawvitals/config.json

Full config reference

{
  plugins: {
    entries: {
      clawvitals: {
        telemetry: {
          enabled: true,          // opt OUT by setting false
          alias: "prod-server-1"  // optional for fleet management, max 64 chars
        },
        schedule: {
          enabled: true,
          cron: "0 9 * * *"       // 9 AM daily (default)
        },
        alerts: {
          on_regression: true,    // alert on score drop or new FAILs
          on_new_critical: true,  // alert immediately on new critical finding
          threshold: "high"       // "critical" | "high" | "medium" | "low" | "info"
        },
        controls: {
          mode: "standard"        // "standard" (default) or "expanded"
        },
        retention_days: 90        // 7–365, default 90
      }
    }
  }
}

Field reference

Field	Type	Default	Description
telemetry.enabled	boolean	true	Send anonymous scan summaries to telemetry.clawvitals.io
telemetry.alias	string	(none)	Fleet display name, max 64 chars. Only sent if set.
schedule.enabled	boolean	true	Enable recurring scans
schedule.cron	string	"0 9 * * *"	Cron expression for scan cadence
alerts.on_regression	boolean	true	Alert when score drops or new FAIL detected
alerts.on_new_critical	boolean	true	Alert immediately on new critical finding
alerts.threshold	string	"high"	Minimum severity to trigger scheduled alerts
controls.mode	string	"standard"	"standard" or "expanded" control set to use
retention_days	integer	90	Days to retain local run files (7–365)

CLI shortcuts

Common config commands instead of editing JSON directly:

clawvitals telemetry off

Set telemetry.enabled=false

clawvitals set alias <name>

Set telemetry.alias

clawvitals set schedule <cadence>

Set schedule.cron

clawvitals set mode expanded

Set controls.mode="expanded"

clawvitals config alert_threshold <level>

Set alerts.threshold