← 返回 Skills 市场
Ranking Of Claws
作者
angelstreet
· GitHub ↗
· v3.0.0
496
总下载
0
收藏
1
当前安装
11
版本数
在 OpenClaw 中安装
/install ranking-of-claws
功能描述
Simple install: register once, auto-setup cron, and report token/model deltas from JSONL sessions without editing openclaw.json.
安全使用建议
What this skill will do if you install it: it writes a local config (config.json) under ~/.openclaw/workspace/skills/ranking-of-claws, creates/updates a small state file and a log under ~/.openclaw, installs a cron job to run every 10 minutes, and will POST aggregated token counts (agent name, country, gateway id, model, token deltas) to https://rankingofclaws.angelstreet.io/api/report. It does not appear to send message content. Before installing: (1) review and confirm you trust the remote service (rankingofclaws.angelstreet.io) because aggregated usage data will be sent regularly; (2) inspect the included scripts yourself (they are present in the package) — pay attention to the cron entry and the files it writes; (3) be aware of the state-file name mismatch between the hook and the report script which can cause duplicate reporting — consider running the reporting script manually (./scripts/test.sh and ./scripts/report.sh) to verify behavior and/or modify the state-file path if you want a single canonical state store; (4) if you prefer not to have persistent reporting, do not install the cron and run the reporter manually when desired.
功能分析
Type: OpenClaw Skill
Name: ranking-of-claws
Version: 3.0.0
The skill functions as a telemetry and leaderboard tool for tracking AI token usage. It parses OpenClaw session logs (~/.openclaw/agents/*/sessions/*.jsonl) to aggregate token counts and model IDs, which it then reports to a public leaderboard (rankingofclaws.angelstreet.io). Analysis of scripts/report.sh and hooks/handler.js confirms that only usage metrics and a non-reversible hashed gateway ID are transmitted; actual message content and sensitive environment variables are explicitly ignored. The skill uses standard persistence via a cron job (scripts/setup-cron.sh) as disclosed in its documentation.
能力评估
Purpose & Capability
The name/description match the behavior in the scripts and hook: the code scans ~/.openclaw/agents/*/sessions/*.jsonl, computes per-model token deltas, and POSTs aggregated counts to https://rankingofclaws.angelstreet.io/api/report. Required artifacts (config.json, state file, cron job) are consistent with reporting behavior. Minor metadata mismatches (different ownerId in _meta.json vs registry metadata) do not affect functionality but are worth noting.
Instruction Scope
Runtime instructions confine themselves to reading the user's OpenClaw JSONL session logs, maintaining a small local state file, and sending aggregated numeric metrics (gateway_id, agent_name, country, tokens/model). The code explicitly avoids sending message content. Note: there is an inconsistency in state-file naming between the hook (handler.js uses ~/.openclaw/ranking-hook-state.json) and the shell/python report script (uses ~/.openclaw/ranking-of-claws-state.json), which may cause the hook and the cron reporter to not share state and could lead to duplicate or missed reports. Also the hook/script create and write to files under ~/.openclaw and append to logs — expected for this feature but privacy-relevant.
Install Mechanism
No external downloads or package installs are performed by the skill; it is instruction-and-script based. The install script writes a local config file and calls setup-cron.sh to add a crontab entry. This is a lower-risk install mechanism compared with remote code downloads, but it does modify the user's crontab and writes files to the home directory.
Credentials
The skill requests no environment variables or external credentials. It derives a gateway_id locally (hostname and HOME hashed) and uses agent_name/country provided at install or defaults. The data sent to the remote API is limited to agent_name, country, gateway_id, model, and numeric token/cost deltas — proportional to the stated leaderboard purpose.
Persistence & Privilege
The installer creates a persistent cron entry that runs every 10 minutes and will autonomously post aggregated usage to the external API. always:false (not force-installed) but the cron gives persistent, recurring behavior; the user should be aware this will continue until the crontab entry or skill files are removed.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install ranking-of-claws - 安装完成后,直接呼叫该 Skill 的名称或使用
/ranking-of-claws触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v3.0.0
- Added _meta.json and config.json files for improved metadata and configuration handling.
- Updated SKILL.md formatting and metadata section; removed OpenClaw-specific keys.
- No changes to core functionality or commands.
- Maintains simple install and reporting workflow.
v1.2.4
Cron-first install flow: register + auto cron, JSONL delta reporting, docs simplified (no openclaw.json workflow)
v1.2.3
Simplified install: register + auto cron setup; cron JSONL delta reporting; docs remove hook-first flow
v1.2.2
Install-time registration to config.json; JSONL per-model token parsing; no openclaw.json edits
v2.0.0
Plain JS hook (no TS needed), report.sh for cron, test.sh for connectivity check, full API docs
v1.2.1
**Major update: The skill now polls session data directly instead of relying on unreliable message event hooks. Reporting frequency increased to every 10 minutes.**
- Reporting is now based on polling session store data for token deltas, not `message:sent` events.
- Requires you to set `RANKING_AGENT_NAME` and `RANKING_COUNTRY` as environment variables.
- Reporting interval reduced from hourly to every 10 minutes.
- Robust handling on gateway startup, command resets, and agent session rotations to avoid missed usage.
- Documentation includes bug references for upstream OpenClaw issues impacting event hooks.
- Expanded troubleshooting, privacy, and verification sections.
v1.4.0
Auto-detect agent name from SOUL.md + country from timezone
v1.3.0
Fix: immediate registration on hook load + debug logging
v1.2.0
Fix setup instructions: clarify hook install + troubleshooting
v1.1.0
Card layout, gold/silver/bronze top 3, new title image, models tab
v1.0.0
Initial release: gateway hook for token usage reporting + leaderboard integration
元数据
常见问题
Ranking Of Claws 是什么?
Simple install: register once, auto-setup cron, and report token/model deltas from JSONL sessions without editing openclaw.json. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 496 次。
如何安装 Ranking Of Claws?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install ranking-of-claws」即可一键安装,无需额外配置。
Ranking Of Claws 是免费的吗?
是的,Ranking Of Claws 完全免费(开源免费),可自由下载、安装和使用。
Ranking Of Claws 支持哪些平台?
Ranking Of Claws 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Ranking Of Claws?
由 angelstreet(@angelstreet)开发并维护,当前版本 v3.0.0。
推荐 Skills