- 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
- Run
scripts/install_or_update.sh [target-dir]to clone or update the repo and install it in editable mode. - Start or restart the app:
- foreground: clawstatus --host 0.0.0.0 --port 8900 --no-debug - systemd user service: systemctl --user restart clawstatus.service
- 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.shfor normal setup. - Default target directory is
~/ClawStatus. - The script clones
https://github.com/NeverChenX/ClawStatus.gitwhen missing, otherwise fast-forwards the existing checkout.
Run
Choose one:
- Foreground command for quick manual runs.
systemctl --user restart clawstatus.servicewhen 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.