telegram-usage

What This Skill Does

The telegram-usage skill is a specialized diagnostic utility designed for OpenClaw agents operating within the Telegram ecosystem. Its primary purpose is to provide immediate transparency regarding the current state of API quotas and session longevity. By executing a direct hook into the clawdbot model status framework, this tool fetches real-time telemetry and formats it into a human-readable, visually appealing Telegram message. Users receive instant updates on their token budget percentage and the exact timeframe until the next quota reset. This eliminates ambiguity regarding whether an agent is nearing its operational limits, allowing for better planning of intensive tasks.

Installation

To integrate this utility into your OpenClaw environment, ensure you have the clawhub CLI installed. Run the following command in your terminal:

clawhub install openclaw/skills/skills/c-drew/telegram-usage

Once installed, the handler script is located at /home/drew-server/clawd/skills/telegram-usage/handler.js. The skill is designed to run natively via Node.js on your local or server-side OpenClaw infrastructure.

Use Cases

• Proactive Resource Management: Checking status before initiating large data-heavy operations.
• Technical Troubleshooting: Investigating unexpected agent stops or failures during periods of high traffic.
• Workflow Optimization: Adjusting batch size or task complexity based on available quota remaining.
• Session Monitoring: Confirming that a session is still active and valid without performing redundant operations.

Example Prompts

1. "How much of my API quota do I have left for today?"
2. "Show me the current session stats and when my tokens reset."
3. "Do I have enough quota remaining to process this file? Please check usage."

Tips & Limitations

• Accuracy: Data is pulled directly from the current model state, ensuring the percentages reflected are accurate at the time of the query.
• Format: The output is specifically tailored for Telegram's parseMode; avoid altering the character encoding to ensure symbols like 🟢 and ⏱️ render correctly.
• Dependencies: This tool requires access to the clawdbot status command. Ensure your environment variables and system paths are correctly configured for the handler to reach the underlying model database.
• Limitations: The tool is strictly observational; it cannot increase quotas or bypass resets. It is a read-only reporting mechanism intended for status visibility, not resource manipulation.