OpenClaw Skill Usage 是一款专为 OpenClaw 网关设计的插件，旨在帮助用户追踪和分析技能的实际使用情况。该插件通过安装外部 npm 包 `openclaw-skill-usage`、重启网关以加载功能，并可选地将使用元数据同步至 TiDB Cloud Zero 实例，实现本地或跨机器的技能使用统计与分析。其核心目标是让用户清晰了解哪些技能被频繁调用、在不同代理（agent）和渠道（channel）中的分布情况，并支持构建共享排行榜。 该插件不仅支持本地独立运行，还提供了云端协同能力。当启用云同步时，所有相关安装会被整合进同一个使用空间，形成统一的技能使用视图。值得注意的是，该插件仅传输技能名称、安装标签、代理与渠道标识、时间戳等元数据，绝不涉及消息内容、提示词、补全结果或任何敏感凭证，确保隐私安全。用户可通过专属的 `/skillusage` 命令集进行查询，例如查看最近7天最活跃的技能排行，或确认当前是否处于本地或云端模式。 对于希望优化技能管理策略的开发者而言，此工具特别适用于初期部署阶段：从安装、验证到配置共享空间，每一步都有明确指引。无论是想监控团队内部技能使用效率，还是跨设备统一分析调用趋势，该插件都能提供直观的数据支持。同时，它也强调透明性与用户控制权——例如允许用户将 TiDB Cloud Zero 实例“认领”至个人账户，实现对后端数据的直接管理。
核心功能特点
- 自动安装 `openclaw-skill-usage` 插件并重启 OpenClaw Gateway 以启用功能
- 提供 `/skillusage` 命令集，支持查看技能使用状态与按时间维度（1天/7天/30天/全部）排名
- 支持按安装、代理、渠道账户等多维度拆解使用数据
- 可选启用 TiDB Cloud Zero 云同步，实现多设备安装间的共享使用空间与统一排行榜
- 仅同步技能元数据（如名称、标签、时间戳），不传输消息内容或敏感信息，保障隐私
适用场景
该插件最适合在需要快速启动技能使用分析功能的场景下使用。例如，当用户首次部署 OpenClaw 环境并希望了解哪些技能被实际调用时，可通过执行‘安装技能使用统计’指令完成插件部署。系统将自动安装所需依赖并重启网关，随后即可通过 `/skillusage top 7d` 查看过去一周内最活跃的技能列表及其调用分布。这种能力对技能开发者或运维人员极具价值，能帮助他们识别高价值技能、发现低效接口或潜在冗余功能。 另一个典型应用场景是团队协作或多设备环境下的统一分析需求。假设一个开发者在笔记本上训练模型，另一台服务器负责生产推理，若两者均安装了该插件并加入同一使用空间，则可通过共享令牌机制将数据汇聚至单一排行榜。这样不仅能横向比较不同终端的使用偏好，还能为资源分配、负载均衡或技能迭代决策提供依据。尤其适用于分布式 AI 服务架构中，需要全局视角监控技能调用频率与性能表现的团队。 此外，该工具也适合用于验证技能是否正常工作。有时用户可能怀疑某个技能未被触发，此时只需运行 `/skillusage status` 即可获得当前数据来源（本地或云端）、同步状态及最后更新时间等关键信息。若输出显示‘data source: local-only’，说明尚未启用云同步；反之则为共享模式。结合这些反馈，用户可以判断整个技能使用追踪体系是否已正确建立，从而避免因配置遗漏导致的数据盲区。