Hour Meter (TARDIS on ClawHub)

Life event tracker with three modes, milestone notifications, and tamper-evident verification.

ClawHub Note: This skill is published as TARDIS on ClawHub after the original hour-meter listing was lost due to a repository sync issue.

Three Modes

COUNT UP — Time since an event

COUNT DOWN — Time until an event

COUNT BETWEEN — Journey from start to end

Tamper-Evident Persistence

When you lock a meter, you get a paper code — a short, checksummed code you can write on paper:

CODEBLOCK3

Four Ways to Save (Non-Technical)

1️⃣ PAPER — Write the code on paper/sticky note

• - 20 characters with dashes, easy to copy
• Built-in checksum catches typos when verifying
• Keep in wallet, safe, or taped to equipment

2️⃣ PHOTO — Screenshot or photograph the lock screen

• - Store in camera roll, cloud photos
• Visual backup, no typing required

3️⃣ WITNESS FILE — Auto-saved to ~/.openclaw/meter-witness.txt

• - Append-only log of all locked meters
• Sync folder to Dropbox/iCloud/Google Drive for cloud backup
• Contains paper code + full hash + timestamp

4️⃣ EMAIL TO SELF — Click the mailto: link or copy the one-liner

• - Opens your email client with pre-filled subject and body
• Or copy the compact message: INLINECODE2
• Send to yourself, search inbox later to verify

5️⃣ SENDGRID EMAIL — Auto-send verification email on lock

# Set your SendGrid API key
export SENDGRID_API_KEY=SG.xxxxx
export SENDGRID_FROM_EMAIL=verified@yourdomain.com

# Lock and email in one command
meter.py lock my-meter --email you@example.com

• - Sends a beautifully formatted HTML email with paper code
• Requires a verified sender in SendGrid (see SendGrid docs)
• Great for automated workflows

Verifying Later

CODEBLOCK5

Milestones

CODEBLOCK6

Email Milestone Notifications (v1.3.0)

Get milestone notifications sent directly to your email:

CODEBLOCK7

Email includes:

• - 🎯 Milestone message
• ⏱️ Current elapsed time
• 📝 Meter description

Requires SENDGRID_API_KEY environment variable.

Milestone Notifications: Heartbeat vs Cron

Recommended: HEARTBEAT (~30 min resolution)

• - Add to HEARTBEAT.md: INLINECODE5
• Batches with other periodic checks
• Cost-efficient: shares token usage with other heartbeat tasks
• Good for most use cases (quit tracking, career milestones, etc.)

Milestone Messages

Milestones post their message text to the configured notification channel when triggered:

CODEBLOCK8

Configure in HEARTBEAT.md:
CODEBLOCK9

Advanced: Milestone messages prefixed with ACTION: can optionally be treated as agent instructions by your heartbeat config. This is an opt-in feature — see README.md for security considerations.

Alternative: CRON (precise timing)

• - Use when exact timing matters (e.g., countdown to event)
• ⚠️ Cost warning: Cron at 1-minute intervals = 1,440 API calls/day = expensive!
• If using cron, keep intervals ≥15 minutes to manage costs
• Best for one-shot reminders, not continuous monitoring

Rule of thumb: If 30-minute resolution is acceptable, use heartbeat. Save cron for precision timing.

Quick Reference

CODEBLOCK10

SendGrid Email Webhook Server

Receive real-time notifications when recipients open, click, bounce, or unsubscribe from your meter verification emails.

Setup

CODEBLOCK11

Discord Webhook Setup (Recommended)

1. 1. In your Discord channel, go to Settings > Integrations > Webhooks
2. Click New Webhook, copy the URL
3. Pass to --discord-webhook or set DISCORD_WEBHOOK_URL env var

SendGrid Setup

1. 1. Go to SendGrid > Settings > Mail Settings > Event Webhook
2. Click "Create new webhook" (or edit existing)
3. Set HTTP POST URL to: INLINECODE9
4. Select all event types under Actions to be posted:

1. 5. Click "Test Integration" to verify - this fires all event types to your webhook
2. Important: Click Save to enable the webhook!
3. (Optional) Enable Signed Event Webhook for security and set INLINECODE10

Event Types

Environment Variables

CODEBLOCK12

The 80,000 Hours Concept

Career as finite inventory: 40 years × 2,000 hrs/year = 80,000 hours.

CODEBLOCK13