| name | wakatime |
| description | 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. |
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
- Get your profile:
wakatime_get_user with user param "current" -- see your WakaTime profile.
- View today's coding:
wakatime_get_current_user_status_bar_today -- get today's coding summary.
- 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
{
"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
- Call
clawlink_list_integrations to confirm wakatime is connected.
- Call
clawlink_list_tools --integration wakatime to see the live catalog.
- Call
wakatime_get_user with user "current" to verify your profile.
- 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
| 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
Powered by ClawLink -- an integration hub for OpenClaw
