什么是 Toggl-Optimized？

Toggl-Optimized 是为 Openclaw Skills 生态系统设计的专门集成工具，旨在提供对 Toggl Track 数据的无缝访问。它通过利用直接的 API v3 调用来关注性能和成本效益，从而显著减少 AI 代理的上下文窗口占用。对于需要高速访问时间跟踪数据且不希望有传统、冗长的 API 封装开销的开发者来说，这是一个必不可少的工具。

通过优先与 Toggl 后端进行直接通信，该技能使 AI 代理能够快速检索、处理和总结大量时间日志。无论您是管理个人生产力还是负责大型团队的监督，该技能都能确保您的数据检索保持精简，并让您的自动化工作流保持敏捷响应。

下载入口:https://github.com/openclaw/skills/tree/main/skills/alex1389/toggl-optimized-v2

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

Toggl-Optimized 应用场景

• 使用 Openclaw Skills 生成 JSON 或 PDF 格式的自动化客户报告。
• 以最小的 LLM Token 支出监控项目时间分配。
• 直接通过 AI 代理自动生成月度结算摘要。
• 通过将 Toggl 数据导向其他数据分析工具来创建自定义仪表板。

1. 该技能使用存储在环境变量中的安全 API Token 与 Toggl Track 进行身份验证。
2. 用户或代理通过优化的 Shell 脚本触发特定的报告请求。
3. 该技能对 Toggl Reports 引擎执行直接的 v3 API 调用，以最小化数据开销。
4. 检索到的数据将被处理并格式化为请求的输出类型（JSON 或 PDF）。
5. 结果将返回给代理或保存到本地目录以便立即使用。

Toggl-Optimized 配置指南

要将此技能集成到您的 Openclaw Skills 工作流中，请按照以下安装步骤操作：

1. 从 Toggl 个人资料设置中获取您的 API Token。
2. 在 Shell 中设置所需的环境变量：

export TOGGL_API_TOKEN="your-api-token"
export TOGGL_WORKSPACE_ID="your-workspace-id"

3. 执行报告脚本以验证连接：

bash scripts/toggl_report.sh    json

Toggl-Optimized 数据架构与分类体系

该技能管理 Toggl API 与本地环境之间的数据流。它采用结构化方法来过滤和格式化时间跟踪信息：

Toggl-Optimized

A high-performance Toggl Track agent skill optimized for token efficiency and reporting.

Overview

This skill provides a streamlined way to interact with Toggl Track, focusing on minimizing context usage and providing fast reporting capabilities via direct API v3 calls.

Features

• Token Efficient: Uses optimized API calls to reduce LLM context consumption.
• Fast Reporting: Includes a shell script for quick JSON and PDF reports.
• Direct API Access: Examples for direct curl interaction with Toggl v3 Reports.

Setup

1. Get your API Token from Toggl Profile Settings.
2. Set the environment variable:

   export TOGGL_API_TOKEN="your-api-token"
   

3. (Optional) Set your Workspace ID:

   export TOGGL_WORKSPACE_ID="your-workspace-id"
   

Usage

Optimized Reporting Script

Use the provided script for fast summaries:

# Usage: bash scripts/toggl_report.sh    
bash scripts/toggl_report.sh myclient 2026-02-01 2026-02-28 json