name: clawstatus-dashboard description: Install, update, run, and verify the public ClawStatus dashboard from GitHub. Use when an agent needs to deploy ClawStatus locally or on a LAN host, refresh an existing checkout, restart the user service, or verify the dashboard is reachable on port 8900.

ClawStatus Dashboard

Install or refresh ClawStatus from the public GitHub repo, then verify that the dashboard is reachable.

The published dashboard includes:

• 15-day daily token actual-consumption chart
• active/passive token split
• modal model switching for Overview agents and Cron jobs
• cron frequency display (human-readable, e.g. 每天 07:00) and manual run trigger button
• disabled cron jobs are automatically hidden
• lastStatus color coding: ok = green, error = red
• next-run displayed as countdown (e.g. 5m30s)
• CN/EN language toggle with persistent preference
• OpenClaw status color coding (green/yellow/red)
• configurable refresh speed (Fastest/Fast/Medium/Slow)
• Bootstrap-free (no CDN dependency)

Quick start

1. Run scripts/install_or_update.sh [target-dir] to clone or update the repo and install it in editable mode.
2. Start or restart the app:
   • foreground: clawstatus --host 0.0.0.0 --port 8900 --no-debug
   • systemd user service: systemctl --user restart clawstatus.service
3. Verify access:
   • local: curl -I http://127.0.0.1:8900/
   • LAN: curl -I http://<lan-ip>:8900/

Workflow

Install or update

• Use scripts/install_or_update.sh for normal setup.
• Default target directory is ~/ClawStatus.
• The script clones https://github.com/NeverChenX/ClawStatus.git when missing, otherwise fast-forwards the existing checkout.

Run

Choose one:

• Foreground command for quick manual runs.
• systemctl --user restart clawstatus.service when the host already has a user service definition.

Verify

Always verify with HTTP response headers after install or restart.

If you need command examples, read references/commands.md.