Time Guru Skill

Zero-friction time tracking driven by natural language. Log activities by simply describing what you did. Get daily/weekly reports, productivity analysis, and billing summaries without remembering to start/stop timers.

Core Capabilities

Natural Language Logging: "9点到11点写代码", "下午开了两小时的会"
Instant Timer: start/stop commands with auto-duration
Retroactive Entry: Fill in past activities with fuzzy time parsing
Smart Classification: Auto-categorize activities (dev, meeting, learning, etc.)
Multi-Dimensional Reports: Daily, weekly, monthly, custom range
Productivity Analytics: Peak hours, interruptions, deep work tracking
Project/Customer Billing: Hourly rate × hours, exportable invoices
Goal Tracking: Set daily/weekly time targets and monitor progress

Privacy & Storage

All data stored locally at ~/.openclaw/data/time-guru/
Organized as YYYY/MM/DD.json files (one day per file)
Daily auto-backup (keeps last 7 backups)
LLM only receives individual activity descriptions for parsing, never the full log

Usage

clawhub run time-guru <action> [options]

Actions

| Action | Description | Example | |--------|-------------|---------| | log | Log one or more activities | log "9-11写代码, 11-12开会" | | start | Start a timer | start "写周报" --project report | | stop | Stop the active timer | stop | | report | Generate time report | report --period today | | analyze | Productivity analysis | analyze --period this_week | | goal | Set/check time goals | goal set development 4h/day | | project | Project time summary | project list |

Report Options

| Option | Type | Default | Description | |--------|------|---------|-------------| | --period | enum | today | today, yesterday, this_week, last_week, this_month, last_month, custom | | --date-from | date | — | Custom range start | | --date-to | date | — | Custom range end | | --group-by | enum | category | category, project, day, week | | --output-format | enum | text | text, json, csv, markdown | | --billing | bool | false | Include billing info |

Sample Prompts

1. Natural language log (most common)

clawhub run time-guru log "9点到11点写后端API，11点到12点开需求评审会"
# → ✅ 2 activities logged
#   ⏱ 09:00-11:00 (2h) 开发 · 写后端API
#   ⏱ 11:00-12:00 (1h) 会议 · 需求评审会
#   📊 Today: 3h total

2. Instant timer mode

clawhub run time-guru start "写周报" --project company-report
# → ▶️ Timer started: 写周报 [company-report] @ 14:03
# ... later ...
clawhub run time-guru stop
# → ⏹ Stopped: 写周报 | Duration: 45 minutes

3. Daily report

clawhub run time-guru report --period today
# → 📊 Today's Time Report (Mon 2026-06-14)
#   Development  ████████████████████ 4.5h (52.9%)
#   Meeting      ██████████▌          2.0h (23.5%)
#   Documentation ██████               1.0h (11.8%)
#   Break        ██████               1.0h (11.8%)
#   💰 Billable: 6.5h × ¥500/h = ¥3,250

4. Weekly productivity analysis

clawhub run time-guru analyze --period this_week
# → 📈 Weekly Analysis
#   🔥 Peak hours: 09:00-11:00 (34% of output)
#   🧠 Deep work: 12.5h this week (↑ 15% vs last week)
#   ⚠️ Task switches: 7/day (high)
#   💡 Recommendation: Block 14:00-16:00 for meetings

5. Billing report

clawhub run time-guru report --period this_month --billing
# → 💰 Monthly Billing (June 2026)
#   Project A (XYZ Corp) · 35h × ¥500 = ¥17,500
#   Project B (ABC Inc)  · 22h × ¥600 = ¥13,200
#   Internal             · 18h × ¥0   = ¥0
#   ────────────────────────────────────────
#   Total billable: ¥30,700

First-Success Path

Step 1: Install → clawhub install time-guru
Step 2: Log → clawhub run time-guru log "刚才一直在写代码2小时"
Step 3: Confirm → see activity logged with auto-classification
Step 4: Report → clawhub run time-guru report --period today
Step 5: Insight → see where time went → habit-forming value

Core Scripts

| File | Purpose | |------|---------| | scripts/__init__.py | Package init | | scripts/nl_parser.py | Natural language time parsing | | scripts/timer.py | Start/stop timer management | | scripts/logger.py | Data persistence (JSON files) | | scripts/classifier.py | Activity auto-classification | | scripts/reporter.py | Daily/weekly/monthly reports | | scripts/analyzer.py | Productivity analysis engine | | scripts/goal_tracker.py | Time goal setting and tracking | | scripts/bill_calculator.py | Billing calculation | | scripts/importer.py | External data import | | scripts/exporter.py | Data export (CSV/JSON) | | scripts/reminder.py | Daily/weekly reminders |