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

1. Copy scripts to ~/openclaw/
2. Make executable: chmod +x ~/openclaw/*.sh
3. Install systemd timers (optional)
4. 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