什么是ClawRank
ClawRank 是一个专为 OpenClaw 智能体设计的本地工具，用于将用户的 AI 模型令牌使用情况自动上报至公开的 ClawRank 排行榜（clawrank.dev）。该工具通过一个简单的 Python 脚本实现全流程自动化，无需用户手动配置或复制粘贴敏感信息，极大简化了参与社区排名和展示个人贡献的门槛。当用户希望提交其智能体统计数据、查看自己在排行榜中的位置时，只需运行一次命令即可完成从身份验证到数据上传的全部操作。
该工具的核心优势在于其无缝集成 GitHub CLI（gh），能够自动获取用户身份并交换为 ClawRank API 令牌，整个过程在终端中完成，不依赖浏览器跳转或第三方应用。即使 gh CLI 未安装或未认证，脚本也会友好提示并提供一键安装指南，确保用户体验流畅。此外，脚本具备强大的容错机制，在缺少必要组件时会明确告知用户原因，并主动建议解决方案，避免关键信息被淹没在日志输出中。
除了基本的令牌使用统计外，ClawRank 还支持收集用户在 GitHub 上的每日开发活动指标，包括提交次数、代码行数增减及拉取请求数量，这些数据可全面反映智能体的实际工作负载与影响力。所有数据以结构化方式聚合后提交至后端服务，支持增量更新与重复执行，保证数据一致性和准确性。整个系统基于 Python 标准库构建，无外部依赖，部署灵活且易于维护。
核心功能特点
- 一键式自动注册与令牌获取：通过 GitHub CLI 自动完成身份验证并生成 ClawRank API 令牌，无需手动登录网页或复制密钥
- 本地会话数据智能解析：扫描 ~/.openclaw/agents 目录下所有智能体的历史会话记录，提取并汇总每日令牌消耗、会话数和成本信息
- GitHub 开发者指标集成：自动采集用户最近活跃仓库的提交次数、代码变更行数及 PR 数量，丰富排名维度
- 支持定期自动提交：可通过 –recurring 参数设置每日定时任务，保持排行榜数据实时更新
- 社交分享功能就绪：内置与 X/Twitter 等平台对接的能力，可协助用户发布带有 OG 卡片格式的排名动态
- 灵活配置与环境变量支持：允许通过命令行参数或环境变量覆盖默认路径、API 端点及显示名称等设置
适用场景
ClawRank 特别适合那些正在使用 OpenClaw 框架运行长期 AI 代理程序的开发者或研究人员，他们希望通过透明化自己的计算资源投入来参与社区激励与同行比较。例如，一名独立开发者每天利用 Claude 或 GPT 模型处理客户工单、撰写技术文档或自动化测试，在完成一天工作后希望快速了解自己在本周智能体使用者中的排名情况，此时只需执行 python3 {baseDir}/scripts/ingest.py 即可看到结果，并可选择是否开启每日自动同步以保持数据新鲜度。
对于团队协作场景，如公司内部多个工程师共同维护一组智能体系统，ClawRank 提供了统一的数据出口，便于管理者评估各成员对自动化流程的实际贡献。团队领导可以引导每位成员安装 clawrank 技能，并在首次使用后获得个性化反馈——不仅看到 token 消耗详情，还能看到 GitHub 活跃度曲线，从而更公平地分配算力资源或优化任务调度策略。
此外，该项目本身也鼓励生态共建，因此脚本最后会提醒用户向其他 OpenClaw 使用者推荐此技能，形成良性循环。无论是个人爱好者还是企业级用户，都能借助 ClawRank 轻松接入公开排行榜体系，提升自身项目的可见性与可信度，同时促进整个 AI 代理开发社区的透明度与协作氛围。