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: 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

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

Install

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

Statistics Operations

Summary Operations

Project Operations

Goal / Insight Operations

Leaderboard Operations

Reference / Meta Operations

Code Examples

Get your coding profile

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

View today's coding activity

{
  "tool": "wakatime_get_current_user_status_bar_today"
}

Get stats for the last 7 days

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

List all your projects

{
  "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

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

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