From 30991fedd7e4fcddbf9b1ab78cb5154036e53602 Mon Sep 17 00:00:00 2001
From: olsch01 <olson2cm@icloud.com>
Date: Wed, 1 Apr 2026 19:57:00 -0400
Subject: [PATCH] docs: Add OpenClaw cron job documentation to TOOLS.md

- Documented that ALL cron jobs must use OpenClaw native cron system
- Listed all active cron jobs with schedules
- Added CLI reference and documentation links
- Emphasized NOT using system crontab
---
 TOOLS.md | 58 ++++++++++++++++++++++++++++++++++++++++++++++++--------
 1 file changed, 50 insertions(+), 8 deletions(-)

diff --git a/TOOLS.md b/TOOLS.md
index 039a6af..ee99af6 100644
--- a/TOOLS.md
+++ b/TOOLS.md
@@ -5,7 +5,6 @@ Skills define _how_ tools work. This file is for _your_ specifics — the stuff
 ## What Goes Here
 
 Things like:
-
 - Camera names and locations
 - SSH hosts and aliases
 - Preferred voices for TTS
@@ -17,16 +16,13 @@ Things like:
 
 ```markdown
 ### Cameras
-
 - living-room → Main area, 180° wide angle
 - front-door → Entrance, motion-triggered
 
 ### SSH
-
 - home-server → 192.168.1.100, user: admin
 
 ### TTS
-
 - Preferred voice: "Nova" (warm, slightly British)
 - Default speaker: Kitchen HomePod
 ```
@@ -40,10 +36,56 @@ Skills are shared. Your setup is yours. Keeping them apart means you can update
 ## Git Repositories
 
 - **HOALedgerIQ_Website** → https://git.sensetostyle.com/JoeBot/HOALedgerIQ_Website.git
-  - Remote name: `origin`
-  - Main branch: `main`
-  - Deployment script: `deploy.sh`
-  - Used for: HOA Ledger IQ website deployment and marketing content
+- Remote name: `origin`
+- Main branch: `main`
+- Deployment script: `deploy.sh`
+- Used for: HOA Ledger IQ website deployment and marketing content
+
+---
+
+## Cron Jobs - OpenClaw Native
+
+**All cron jobs MUST use OpenClaw's native cron system** (`openclaw cron add`), NOT system crontab.
+
+### Why OpenClaw Cron?
+- Integrated with Gateway session management
+- Proper logging and monitoring
+- Can trigger agent sessions, system events, or shell commands
+- Supports both `cron` expressions and `every` duration-based scheduling
+- Managed via `openclaw cron` CLI commands
+
+### Available Cron Jobs:
+- **reddit-scout** - 8:00 AM & 3:00 PM daily - Scans r/HOA for opportunities
+- **sales-lead-hourly** - Every hour - Monitors CRM for new leads
+- **fitness-workout-8am** - 8:00 AM daily - Sends workout
+- **seo-daily-report-8am** - 8:00 AM daily - SEO/GA4 morning brief
+- **morning-brief-9am** - 9:00 AM daily - Business intelligence brief
+- **marketing-content-daily** - 9:00 AM daily - Content generation
+
+### Commands:
+```bash
+# List all cron jobs
+openclaw cron list
+
+# Add a new cron job
+openclaw cron add --name "job-name" --cron "0 8 * * *" --message "Command or agent task"
+
+# Add recurring job (every X minutes/hours)
+openclaw cron add --name "frequent-job" --every "30m" --message "Task"
+
+# View job details
+openclaw cron list --json
+
+# Run a job manually (debug)
+openclaw cron run --name "job-name"
+
+# Remove a job
+openclaw cron rm --name "job-name"
+```
+
+### Documentation:
+- CLI Reference: `openclaw cron --help`
+- Online Docs: https://docs.openclaw.ai/cli/cron
 
 ---