← 返回 Skills 市场
37
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install time-guru
功能描述
Natural language time tracking with smart activity classification, multi-dimensional reports, productivity analytics, and billing.
使用说明 (SKILL.md)
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/stopcommands 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.jsonfiles (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 \x3Caction> [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 |
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install time-guru - 安装完成后，直接呼叫该 Skill 的名称或使用
/time-guru触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
- Initial release of Time Guru for natural language time tracking and productivity analysis.
- Effortless activity logging with smart auto-classification and instant timer support.
- Generate multi-dimensional reports (daily, weekly, monthly) and advanced productivity analytics.
- Retroactive activity entry and billing/invoicing features for projects and clients.
- Local, privacy-friendly storage with optional reminders and backup.
元数据
常见问题
Time Guru 是什么？
Natural language time tracking with smart activity classification, multi-dimensional reports, productivity analytics, and billing. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 37 次。
如何安装 Time Guru？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install time-guru」即可一键安装，无需额外配置。
Time Guru 是免费的吗？
是的，Time Guru 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Time Guru 支持哪些平台？
Time Guru 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Time Guru？
由 haidong（@harrylabsj）开发并维护，当前版本 v1.0.0。
推荐 Skills