WakaTime#

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: InstallStep 2: Pair AccountStep 3: Connect WakaTime_App-specific connection GIF coming soon_Run the install command in OpenClawSign in and approve the deviceOpen 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#

ToolDescriptionModewakatime_get_userGet user profile (use "current" for authenticated user)Readwakatime_get_current_user_status_bar_todayGet today's coding activity summaryReadwakatime_get_machine_namesList user's machines with last seen timeReadwakatime_list_user_user_agentsList plugins/editers that have sent data for a userReadwakatime_get_users_all_time_since_todayGet total coding time since account creationRead

Statistics Operations#

ToolDescriptionModewakatime_get_user_statsGet coding stats over the default time rangeReadwakatime_get_user_stats_by_rangeGet stats for a specific time range (languages, editors, projects)Readwakatime_get_aggregate_statsGet aggregate coding stats across all WakaTime usersRead

Summary Operations#

ToolDescriptionModewakatime_get_user_summariesGet daily coding summaries with breakdowns by project, language, editorRead

Project Operations#

ToolDescriptionModewakatime_list_user_projectsList WakaTime projects with names, IDs, and last activityRead

Goal / Insight Operations#

ToolDescriptionModewakatime_get_goalsList user's goals with progress seriesReadwakatime_get_insightsRetrieve coding insights for a user over a time rangeRead

Leaderboard Operations#

ToolDescriptionModewakatime_get_leadersList public leaders ranked by coding activityRead

Reference / Meta Operations#

ToolDescriptionModewakatime_list_program_languagesList all verified programming languages tracked by WakaTimeReadwakatime_get_editorsList WakaTime IDE plugins with metadataReadwakatime_get_metaGet API meta info including WakaTime server IPsReadwakatime_get_oauth_authorizeGenerate OAuth 2.0 authorization URLRead

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 / ErrorMeaning401 UnauthorizedToken expired; reconnect at the dashboard403 ForbiddenInsufficient OAuth scope for the requested data404 Not FoundInvalid 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