Time Guru

Other

Natural language time tracking with smart activity classification, multi-dimensional reports, productivity analytics, and billing.

Install

openclaw skills install time-guru

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