核心用法
Toggle 技能用于查询用户在 ToggleX 平台上的时间追踪记录,包括工作会话、生产力评分及项目关联信息。用户可通过自然语言询问"我今天做了什么""昨天的工作情况"等,系统会自动调用该技能获取数据。
技能通过 Python 脚本调用 ToggleX 官方 OpenClaw 集成端点 https://ai-x.toggle.pro/public-openclaw/workflows,返回原始 JSON 数据后由 Agent 进行自然语言摘要。支持指定日期范围查询,默认返回当日数据。
关键数据字段
type: 区分 WORK/BREAK/LEISURE 三类活动workflowType/workflowDescription: 描述具体工作内容projectTask.name/project.name: 项目与任务上下文productivityScore: 0-100 分专注力评估
显著优点
1. 零摩擦回忆: 无需用户手动记录,自动还原工作轨迹
2. 量化生产力: 基于 0-100 评分的客观专注度分析
3. 项目上下文: 自动关联具体任务与所属项目
4. 隐私优先: 仅传输 API 密钥,不上传其他用户数据
潜在局限
- 依赖外部服务: ToggleX 平台可用性直接影响功能
- 数据完整性: 若 Toggle 未运行则捕获为空(
totalWorkflows: 0) - 仅支持 ToggleX: 不兼容 Toggl Track 等其他时间追踪工具
- 需要主动配置: 用户必须自行获取并配置
TOGGLE_API_KEY
适合人群
- 使用 ToggleX 浏览器扩展进行时间追踪的知识工作者
- 需要日报/周报自动化摘要的自由职业者或远程团队
- 希望基于数据回顾专注模式、优化工作节奏的用户
常规风险
- API 密钥泄露: 密钥需妥善存储于环境变量或配置文件中,避免硬编码
- 第三方数据依赖: 工作记录存储于 ToggleX 云端,存在服务商数据安全依赖
- 误判边界:
productivityScore为算法估算,可能与主观感受存在偏差