A utility for tracking and displaying API usage statistics and session quotas directly within Telegram.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install telegram-usage
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install telegram-usage using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Telegram Usage Stats?
Telegram Usage Stats is a dedicated monitoring utility designed to provide developers with immediate visibility into their agent's resource consumption. By leveraging this tool, users can track API limits, session durations, and context usage through a streamlined interface. As one of the core Openclaw Skills, it bridges the gap between backend system metrics and frontend communication, ensuring you never run out of quota unexpectedly during critical tasks.
Telegram Usage Stats Use Cases
- Checking remaining API quota during heavy development sessions.
- Estimating when a rate limit or quota reset will occur.
- Getting a quick visual status of agent resource health.
- Integrating automated usage reporting into chat-based management workflows.
How Telegram Usage Stats Works
- The user triggers the skill by asking for usage or quota information via the chat interface.
- The agent executes the local handler script using the Node.js runtime.
- The script pulls real-time status data from the underlying clawdbot models status command.
- Data is processed into a Telegram-compatible HTML/text format with visual indicators like emojis.
- The formatted summary is delivered to the user, providing a clean snapshot of current session metrics.
Telegram Usage Stats Setup
To use this skill, ensure you have Node.js installed on your environment. You can manually trigger the usage report by executing the handler script:
node /home/drew-server/clawd/skills/telegram-usage/handler.js
The skill is designed to be auto-invoked by the agent when relevant queries are detected within Openclaw Skills environments.
Telegram Usage Stats Data Schema & Taxonomy
The skill processes internal system data and transforms it into a structured Telegram message. The output includes:
| Data Point | Indicator | Description |
|---|---|---|
| Quota Remaining | Percentage (%) | The visual and numerical representation of available API capacity. |
| Reset Timer | Time (m/h) | The duration remaining until the current quota window resets. |
| Status Level | Emojis | Color-coded indicators (e.g., green circles) representing system health. |
Telegram Usage Stats Advanced Features
- Real-time data synchronization with active model status to ensure accuracy.
- Optimized HTML formatting specifically tailored for Telegram's parseMode.
- Minimal resource footprint, making it ideal for low-latency status checks among Openclaw Skills.
- Automated parsing of complex system logs into human-readable summaries.
SKILL.md
Loading
Related Openclaw Skills
Speech to Text (Yandex SpeechKit)
An extensible speech-to-text integration for Openclaw that converts voice messages into accurate text using Yandex SpeechKit and FFmpeg.
QQ Official Bot Integration
A comprehensive integration guide for connecting official QQ bots to the OpenClaw AI ecosystem for intelligent chat automation.
Kubera Portfolio Manager
A professional-grade tool to query and manage Kubera portfolio data, including net worth, asset allocation, and holdings.
shop-culture
An Agentic Commerce skill for the For the Cult store that enables AI agents to browse products, execute multi-chain payments, and track orders autonomously.
AgentLedger
A local-first accounting and expense tracking tool designed for AI agents to log purchases, manage budgets, and maintain financial audit trails.
PRTS Sandbox: Kali Linux Pentest Environment
An isolated Kali Linux 2025.4 container designed to execute pentesting tools and high-risk commands safely away from your host machine.
METADATA
Featured*
