← 返回 Skills 市场
c-drew

Telegram Usage Stats

作者 c-drew · GitHub ↗ · v1.0.1
cross-platform ⚠ suspicious
2229
总下载
2
收藏
9
当前安装
2
版本数
在 OpenClaw 中安装
/install telegram-usage
功能描述
Display session usage statistics (quota, session time, tokens, context)
安全使用建议
This skill appears to implement the advertised feature (showing quota, tokens, context) and its code is readable, but there are a few things to check before installing: - Missing declared dependency: handler.js executes 'clawdbot models status' but the skill metadata only lists 'node'. Ensure the 'clawdbot' CLI is present and trusted on your system. - Hardcoded paths: SKILL.md and README suggest running node against an absolute path (/home/drew-server/...), which will likely be wrong on your machine. Install location or invocation may need adjustment. - Sensitive local reads/writes: the skill reads ~/.clawdbot/agents/.../sessions/sessions.json and transcript JSONL files and will create/update ~/.clawdbot/quota-tracker.json. Those session/transcript files can include metadata or conversation-derived data; review them first and ensure you're comfortable with the skill reading that data. - No network exfiltration observed, but if you plan to expose reports to Telegram, confirm where tokens/IDs are stored and that the bot token is kept secure (the code does not read a bot token automatically; config-example shows how a token might be configured elsewhere). Recommended steps: 1) Inspect the two JS files locally (handler.js, session-reader.js) yourself (they are included in the bundle) to confirm behavior. 2) Run the handler in JSON mode in a safe environment: node handler.js json — review exactly what data is printed before connecting the skill to Telegram. 3) Backup ~/.clawdbot before first run and check file permissions (quota-tracker.json will be created/updated). 4) If you do not want the skill to read transcripts or session files, request a version that only reads non-sensitive aggregated metrics or provide a sandboxed copy of the session store. Because the source is 'unknown' and the package omits the implicit 'clawdbot' binary requirement and uses hardcoded paths, I rate this suspicious (medium confidence) rather than outright benign. If you can confirm the provenance and are comfortable with it reading ~/.clawdbot, the mismatches are explainable and the risk is lower.
功能分析
Type: OpenClaw Skill Name: telegram-usage Version: 1.0.1 The skill is designed to display session usage statistics. It uses `child_process.execSync` in `handler.js` to execute the `clawdbot models status` command, which is a legitimate interaction with the host system's `clawdbot` CLI for its stated purpose. It also reads and writes files within the `~/.clawdbot` directory (`quota-tracker.json`, `sessions.json`, `*.jsonl`) to gather and store session-related data, which is necessary for its functionality. There is no evidence of data exfiltration, malicious execution, persistence, or prompt injection attempts in `SKILL.md` or other files. All actions are aligned with the skill's described purpose.
能力评估
Purpose & Capability
Name/description (Telegram usage stats) match the code: the handlers read Clawdbot session state, count tokens, estimate context, and format a Telegram-safe message. However, the SKILL metadata and README only declare 'node' as a required binary while handler.js calls 'clawdbot models status' via execSync — the skill implicitly requires the 'clawdbot' CLI to be present on PATH. Also SKILL.md shows a hardcoded absolute path (/home/drew-server/...) which may not match the installed location; that's an operational mismatch.
Instruction Scope
The runtime instructions and code instruct the agent to read files under the user's home (~/.clawdbot), including sessions/sessions.json and JSONL transcripts, and to create/update ~/.clawdbot/quota-tracker.json. Those files can contain sensitive session metadata and may indirectly expose conversation-related data (transcript parsing reads JSONL entries). The code does not transmit data to remote endpoints, but it does execute a local 'clawdbot' command and writes tracker state — all of which is within the apparent purpose but is privacy-sensitive and should be explicitly documented/consented to.
Install Mechanism
No install spec / no network downloads are present in the registry entry. The skill is a bundle of code files (handler.js and session-reader.js) so nothing external is pulled during install. This is lower risk from installation perspective.
Credentials
The skill declares no required env vars but reads environment values (HOME / USERPROFILE) to access ~/.clawdbot. It will create and write ~/.clawdbot/quota-tracker.json. The README/config-example mentions a Telegram bot token, but the code does not read it; that mismatch could confuse users. The implicit requirement for the 'clawdbot' binary is not declared. Access to session/transcript files is proportionate to a usage-stats feature, but those files can contain sensitive data and the skill should explicitly document what it reads and writes.
Persistence & Privilege
The skill does write its own tracker file under ~/.clawdbot (quota-tracker.json) but does not request always:true and does not mutate other skills or system-wide configurations. Writing a per-skill file in the user's home is reasonable, but you should expect files created in your home directory.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install telegram-usage
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /telegram-usage 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.1
SECURITY: Remove bot token from config-example.json (use YOUR_BOT_TOKEN_HERE instead)
v1.0.0
telegram-usage 1.0.0 - Initial release. - Displays Telegram session usage statistics: quota remaining, reset timer, and session data. - Provides visually formatted, real-time stats suitable for Telegram messages. - Simple usage: run the handler script to get current stats in a single, clear message.
元数据
Slug telegram-usage
版本 1.0.1
许可证
累计安装 9
当前安装数 9
历史版本数 2
常见问题

Telegram Usage Stats 是什么?

Display session usage statistics (quota, session time, tokens, context). 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 2229 次。

如何安装 Telegram Usage Stats?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install telegram-usage」即可一键安装,无需额外配置。

Telegram Usage Stats 是免费的吗?

是的,Telegram Usage Stats 完全免费(开源免费),可自由下载、安装和使用。

Telegram Usage Stats 支持哪些平台?

Telegram Usage Stats 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Telegram Usage Stats?

由 c-drew(@c-drew)开发并维护,当前版本 v1.0.1。

💬 留言讨论