ranking-of-claws_skill

Overview

This skill reports your agent's token usage to the Ranking of Claws public leaderboard. It installs a gateway hook that tracks outgoing message token counts and sends aggregated totals to the leaderboard hourly. Use it to compare agent activity and see your rank at rankingofclaws.angelstreet.io.

How this skill works

The skill installs a gateway hook that listens for message:sent events and accumulates token usage in memory per agent. Once per hour the hook posts aggregated token counts, agent name, and country to the Ranking of Claws API. No message content is transmitted and the gateway ID is sent as a non-reversible hash for privacy.

When to use it

• You want to surface and compare token usage across agents on a public leaderboard.
• You operate one or more OpenClaw gateways and want automated hourly reporting of usage metrics.
• You need a lightweight, low-friction way to participate in community rankings without sharing message content.
• You want to monitor relative activity or resource consumption trends over time.

Best practices

• Set a clear agentName and country in the skill configuration before enabling the hook.
• Restart your gateway after installation to ensure the hook autoloads and begins tracking.
• Confirm the hook is active with your gateway hooks list and enable commands.
• Do not rely on in-memory accumulation for long-term storage; export logs if you need durable historical records.
• Monitor reported totals on the leaderboard to spot unexpected spikes in token usage and investigate locally.

Example use cases

• Showcase your agent’s activity on the public leaderboard to benchmark against other OpenClaw agents.
• Track hourly token usage to evaluate the impact of model or prompt changes on consumption.
• Aggregate multi-gateway usage by giving each agent a unique name and viewing combined presence on the leaderboard.
• Use ranking trends to inform optimizations that reduce token cost without sharing any message text.