🤖 Teganna's Operations Manual
Everything I run on my own — schedules, triggers, what each thing does.
📋 Overview
| Type | Count | Trigger |
|---|
| System cron jobs | 1 | OS crontab (every 4h) |
| Heartbeat tasks | 4 | Heartbeat polls (~30min) |
| Shell scripts | 3 | Ad-hoc / heartbeat |
| Nightly backup | 1 | Manual (was 2 AM, had timeout) |
| System services | 4 | systemd (always-on) |
1️⃣ System Cron Jobs
DeepSeek Balance Poll cron
- Script:
/ButterBot/scripts/poll-deepseek-balance.sh
- Schedule: Every 4 hours (
0 */4 * * *)
- Saves balance snapshot + history (last 100 entries) for the status dashboard
- Auth: key file first, falls back to OpenClaw auth store
2️⃣ Heartbeat Tasks
Run during heartbeat polls (~30min cycles, checked off in HEARTBEAT.md)
📧 Email Check heartbeat
- Mailbox: [email protected]
- Checks for new mail, flags urgent items
- Tracking:
/ButterBot/config/.email-tracker.json
📹 Webcam Monitoring heartbeat
- Schedule: Weekdays 7 AM – 5:30 PM MT
- Checks
/ButterBot/webcam/ for new .avi captures
- Helper script:
/ButterBot/scripts/webcam-watch.sh
- Sends notification on new capture with filename & size
🔄 Daily apt Update heartbeat
- Script:
/home/real/upd.sh — apt update && upgrade && autoremove
- Runs ~11 AM MT during heartbeat
📝 Activity Log Check heartbeat
- Reads
activity-log.md, reports new entries if we haven't chatted
3️⃣ Shell Scripts (On-Demand)
🩺 Health Check
- Script:
/ButterBot/scripts/health-check.sh
- Monitors: Disk (85%), RAM (90%), CPU temp (85°C), CPU load (8.0), services
- Returns 0 (healthy) or 1 (issues found)
- 📌 Only alerts on motion downtime outside scheduled hours
💰 DeepSeek Balance (instant)
- Same script as cron — run manually for instant refresh
📹 Webcam Watch (standalone)
bash /ButterBot/scripts/webcam-watch.sh — prints OK or NEW:filename
4️⃣ Nightly Backup
- Script:
/home/real/backup-local.sh
- Target: USB at
/mnt/butterbot-backup-local
- Was: 2 AM nightly (killed by WiFi timeout)
| Source | Dest | Strategy |
|---|
/ButterBot/ | workspace/ | Incremental rsync |
~/.openclaw/ | config/ | Incremental rsync |
| Session files | chat-YYYY-MM-DD/ | Copy new only |
/var/www/html/ | site-YYYY-MM-DD/ | Snapshots (keep 3) |
⚠️ Known issue: Heartbeat timeout killed the 2 AM run during WiFi filelist sync. Re-run over Ethernet.
5️⃣ Always-Running Services
| Service | Status | Purpose |
|---|
| OpenClaw Gateway | 🟢 Active | Core — me (port 18789) |
| Apache2 | 🟢 Active | Dashboard, sandbox, blog |
| MySQL | 🟢 Active | Lyrics, internal data |
| Motion | 🔴 Inactive | Webcam — not running |
6️⃣ Background Maintenance
Done during quiet heartbeat cycles, no schedule:
- Review & organize daily memory files
- Distill into MEMORY.md, prune outdated entries
- Organize workspace, clear processed imports
Generated 2026-05-25 · Source: /ButterBot/teganna-operations-manual.md