Native Scripts for OpenCLAW
System automation scripts designed for OpenCLAW running natively without Docker containers. These scripts provide essential monitoring, reporting, and cost tracking capabilities.
Overview
After migrating from Docker to native execution, these scripts replace the container-based automation stack with lightweight shell scripts and systemd integration.
Included Scripts
heartbeat.sh
Daily status report sent to Telegram at 18:00 UTC (7am NZDT).
Reports:
- Gateway process status
- Model in use
- Session count
- 24h and all-time costs
- System resources (disk, memory)
- Uptime
watchdog.sh
Process monitor running every 5 minutes.
Checks:
- OpenCLAW gateway process health
- Logs status to ~/.openclaw/logs/watchdog.log
- Sends Telegram alert if gateway stops
- Auto-trims log file at 1000 lines
cost-tracker.sh
Calculates usage costs from session JSONL files.
Features:
- Parses session files for token usage
- Calculates costs based on model pricing
- Supports 24h, today, or all-time periods
- JSON or text output formats
Installation
- Copy scripts to ~/openclaw/
- Make executable: chmod +x ~/openclaw/*.sh
- Install systemd timers (optional)
- Configure Telegram bot token in ~/.openclaw/openclaw.json
Requirements
- bash
- jq (for JSON parsing)
- bc (for calculations)
- curl (for Telegram API)
- systemd (for timers, optional)
Configuration
Scripts read configuration from:
- ~/.openclaw/openclaw.json (Telegram token, model pricing)
- ~/.openclaw/.env (API keys)
License
Private - For nz365guy use only