WakaTime

WakaTime API integration with managed OAuth. Retrieve coding statistics, track developer productivity, analyze programming languages and editor usage, view daily summaries. Use this skill when users want to check coding activity, review developer metrics, track project time, or analyze productivity patterns.

Developer productivity tracking from chat -- view coding stats, language breakdowns, project time, and daily activity summaries.

Powered by ClawLink, an integration hub for OpenClaw that handles hosted OAuth flows and credentials so you don't need to configure WakaTime API access yourself.

Setup in 3 Steps

Step 1: Install	Step 2: Pair Account	Step 3: Connect WakaTime
		App-specific connection GIF coming soon
Run the install command in OpenClaw	Sign in and approve the device	Open the dashboard and connect WakaTime

How It Works

text

┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐
│   OpenClaw      │────▶│   ClawLink   │────▶│  WakaTime API    │
│   (User Chat)   │     │   (OAuth)    │     │                  │
└─────────────────┘     └──────────────┘     └──────────────────┘

Install

bash

openclaw plugins install clawhub:clawlink-plugin
openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
openclaw gateway restart

Quick Start

1. Get your profile: wakatime_get_user with user param "current" -- see your WakaTime profile.
2. View today's coding: wakatime_get_current_user_status_bar_today -- get today's coding summary.
3. Check stats by range: wakatime_get_user_stats_by_range -- analyze coding patterns over a specific time period.

Authentication

WakaTime uses managed OAuth via ClawLink. No API keys needed. Connect your WakaTime account at claw-link.dev/dashboard?add=wakatime and authorize access through the hosted flow.

Connection Management

List connections: clawlink_list_integrations -- confirm WakaTime is connected.

Verify: Call wakatime_get_user with user "current" to test access.

Reconnect: If you see auth errors, reconnect at claw-link.dev/dashboard?add=wakatime.

Security & Permissions

All WakaTime tools are read-only. No write operations are available. All calls are safe and require no confirmation.

Tool Reference

User Operations

Tool	Description	Mode
wakatime_get_user	Get user profile (use "current" for authenticated user)	Read
wakatime_get_current_user_status_bar_today	Get today's coding activity summary	Read
wakatime_get_machine_names	List user's machines with last seen time	Read
wakatime_list_user_user_agents	List plugins/editers that have sent data for a user	Read
wakatime_get_users_all_time_since_today	Get total coding time since account creation	Read

Statistics Operations

Tool	Description	Mode
wakatime_get_user_stats	Get coding stats over the default time range	Read
wakatime_get_user_stats_by_range	Get stats for a specific time range (languages, editors, projects)	Read
wakatime_get_aggregate_stats	Get aggregate coding stats across all WakaTime users	Read

Summary Operations

Tool	Description	Mode
wakatime_get_user_summaries	Get daily coding summaries with breakdowns by project, language, editor	Read

Project Operations

Tool	Description	Mode
wakatime_list_user_projects	List WakaTime projects with names, IDs, and last activity	Read

Goal / Insight Operations

Tool	Description	Mode
wakatime_get_goals	List user's goals with progress series	Read
wakatime_get_insights	Retrieve coding insights for a user over a time range	Read

Leaderboard Operations

Tool	Description	Mode
wakatime_get_leaders	List public leaders ranked by coding activity	Read

Reference / Meta Operations

Tool	Description	Mode
wakatime_list_program_languages	List all verified programming languages tracked by WakaTime	Read
wakatime_get_editors	List WakaTime IDE plugins with metadata	Read
wakatime_get_meta	Get API meta info including WakaTime server IPs	Read
wakatime_get_oauth_authorize	Generate OAuth 2.0 authorization URL	Read

Code Examples

Get your coding profile

json

{
  "tool": "wakatime_get_user",
  "args": { "user": "current" }
}

View today's coding activity

json

{
  "tool": "wakatime_get_current_user_status_bar_today"
}

Get stats for the last 7 days

json

{
  "tool": "wakatime_get_user_stats_by_range",
  "args": { "user": "current", "range": "last_7_days" }
}

List all your projects

json

{
  "tool": "wakatime_list_user_projects",
  "args": { "user": "current" }
}

Discovery Workflow

1. Call clawlink_list_integrations to confirm wakatime is connected.
2. Call clawlink_list_tools --integration wakatime to see the live catalog.
3. Call wakatime_get_user with user "current" to verify your profile.
4. Use stats and summary tools to explore coding activity.

Execution Workflow

text

Read Flow:  User asks for coding stats → clawlink resolves connection → WakaTime API → metrics displayed

Notes

• All tools are read-only. WakaTime integration does not write any data.
• Use "current" as the user parameter to reference the authenticated user.
• wakatime_get_user_summaries requires the read_summaries scope.
• wakatime_get_goals requires the read_goals scope.
• Coding time values may differ from dashboard totals due to API vs. web display logic.

Error Handling

Status / Error	Meaning
401 Unauthorized	Token expired; reconnect at the dashboard
403 Forbidden	Insufficient OAuth scope for the requested data
404 Not Found	Invalid user ID or username

Troubleshooting

Tools Not Visible

Run openclaw gateway restart after installing the plugin. Start a fresh chat session.

Missing Summaries or Goals

The OAuth connection may not have the required scopes. Reconnect to grant additional permissions.

Resources

• WakaTime API Docs: https://wakatime.com/developers
• ClawLink: https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=wakatime
• ClawLink Docs: https://docs.claw-link.dev/openclaw

---

Powered by ClawLink -- an integration hub for OpenClaw