Telegram Usage Status
OpenClaw plugin that publishes 5h and weekly usage remaining in a Telegram bot profile.
Telegram Usage Status
OpenClaw tool plugin that writes current OpenAI/OpenClaw usage remaining into a Telegram bot profile.
It reads openclaw status --usage --json, computes the remaining percentages for the 5h and Week windows, then updates:
- Telegram Bot API
setMyDescription - Telegram Bot API
setMyShortDescription
No Telegram token is packaged. The plugin reads the configured bot token from the local openclaw.json Telegram account.
Tool
The plugin exposes one tool:
telegram_usage_status_update
Useful arguments:
account: Telegram account key fromopenclaw.json; default isdefaulttimezone: IANA timezone for reset/update display; default isTZorUTCstatePath: optional JSON file path for the last update resultdescriptionTemplate: optional full description templateshortDescriptionTemplate: optional short description templatedryRun: compute and write state without calling Telegram
Template variables:
{fiveLeft}{fiveReset}{weekLeft}{weekReset}{updatedAt}{account}
CLI
After installation/build:
telegram-usage-status --account default --timezone Asia/Jerusalem
Dry run:
telegram-usage-status --dry-run --timezone Asia/Jerusalem
Optional systemd timer
The plugin includes helper scripts for hosts that want automatic refreshes without spending model tokens.
From the plugin directory:
bash scripts/install-systemd-timer.sh --account default --timezone Asia/Jerusalem --interval 5h
Remove the timer:
bash scripts/uninstall-systemd-timer.sh
Safety
Do not publish local state files, bot tokens, logs, or generated .tgz archives. This package only includes source/build output, docs, license, plugin metadata, and helper scripts.
