# Send Token Alert to your agent
Use the source page and any available docs to guide the install because the item is currently unstable or timing out.
## Fast path
- Open the source page via Review source status.
- If you can obtain the package, extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the source page and extracted files.
## Suggested prompts
### New install

```text
I tried to install a skill package from Yavira, but the item is currently unstable or timing out. Inspect the source page and any extracted docs, then tell me what you can confirm and any manual steps still required. Then review README.md for any prerequisites, environment setup, or post-install checks.
```
### Upgrade existing

```text
I tried to upgrade a skill package from Yavira, but the item is currently unstable or timing out. Compare the source page and any extracted docs with my current installation, then summarize what changed and what manual follow-up I still need. Then review README.md for any prerequisites, environment setup, or post-install checks.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "token-alert",
    "name": "Token Alert",
    "source": "tencent",
    "type": "skill",
    "category": "数据分析",
    "sourceUrl": "https://clawhub.ai/r00tid/token-alert",
    "canonicalUrl": "https://clawhub.ai/r00tid/token-alert",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/token-alert",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=token-alert",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "CHANGELOG.md",
      "IMPLEMENTATION_REPORT.md",
      "QUICKSTART.md",
      "README.md",
      "SKILL.md",
      "TESTING_NOTES.md"
    ],
    "downloadMode": "manual_only",
    "sourceHealth": {
      "source": "tencent",
      "slug": "token-alert",
      "status": "unstable",
      "reason": "timeout",
      "recommendedAction": "retry_later",
      "checkedAt": "2026-04-30T07:56:41.780Z",
      "expiresAt": "2026-04-30T19:56:41.780Z",
      "httpStatus": null,
      "finalUrl": null,
      "contentType": null,
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=token-alert",
        "error": "Timed out after 5000ms",
        "slug": "token-alert"
      },
      "scope": "item",
      "summary": "Item is unstable.",
      "detail": "This item is timing out or returning errors right now. Review the source page and try again later.",
      "primaryActionLabel": "Review source status",
      "primaryActionHref": "https://clawhub.ai/r00tid/token-alert"
    },
    "validation": {
      "installChecklist": [
        "Wait for the source to recover or retry later.",
        "Review SKILL.md only after the download returns a real package.",
        "Treat this source as transient until the upstream errors clear."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/token-alert",
    "downloadUrl": "https://openagent3.xyz/downloads/token-alert",
    "agentUrl": "https://openagent3.xyz/skills/token-alert/agent",
    "manifestUrl": "https://openagent3.xyz/skills/token-alert/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/token-alert/agent.md"
  }
}
```
## Documentation

### Token Alert Skill

🚨 Monitor session tokens and get alerts at 75%/90%/95%

### Overview

The Token Alert Skill automatically monitors your Clawdbot session token usage and sends alerts when you approach limits. Never lose context mid-conversation again!

### Features

✅ 6-Level Threshold System - Alerts at 25%, 50%, 75%, 90%, 95%, 100%
✅ Material Design Progress Bar - Box-style (▰/▱) with color gradients
✅ Rich UI Dashboard - Interactive HTML dashboard with animations
✅ Session Status - Shows current token usage on demand
✅ Telegram Alerts - Get notified before hitting limits
✅ HEARTBEAT Integration - Optional automated checks
✅ Stateless - No state file needed, calculates on-demand
✅ Session Estimates - Predicts remaining sessions (~50k avg)

### Interactive Dashboard

Ask Grym:

"Show token dashboard"
"Open dashboard"

Or run directly:

python3 ~/clawd/skills/token-alert/scripts/show_dashboard.py

### Terminal Check

Ask Grym:

"Wie viele Tokens habe ich noch übrig?"
"Check token status"
"Token usage?"

Or run:

python3 ~/clawd/skills/token-alert/scripts/check.py

### Automatic Alerts

Grym will automatically alert you when:

🟡 25% - Low warning (~150k tokens left)
🟠 50% - Medium warning (~100k tokens left)
🔶 75% - High warning (~50k tokens left)
🔴 90% - Critical warning (~20k tokens left)
🚨 95% - Emergency! (<10k tokens left)

### Example Output

🔶 Token Alert: Achtung!

🔶 ▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▱▱▱▱▱▱ 78.0%
156,000 / 200,000 Tokens verwendet

⚠️ Status: High Warning (Rot-Orange Zone)
💡 Verbleibend: ~44k Tokens
⏰ Geschätzte Sessions: <1 Session

🔧 Empfehlung:
   ✅ Wichtige Entscheidungen jetzt treffen
   ✅ Neue Session vorbereiten
   ✅ Token-sparend arbeiten

### Installation

# Via ClawdHub
clawdhub install token-alert

# Manual
cd ~/clawd/skills
git clone https://github.com/r00tid/clawdbot-token-alert token-alert

### HEARTBEAT Integration (Optional)

Add to ~/clawd/HEARTBEAT.md:

### Token Usage Check (täglich)
- [ ] \`python3 ~/clawd/skills/token-alert/scripts/check.py\`
- **Warning ab 70%:** "⚠️ Session bei XX% - Token-Sparend ab jetzt!"

### How It Works

Uses Clawdbot's session_status tool
Calculates percentage of token usage
Compares against thresholds (75%, 90%, 95%)
Sends Telegram alert if threshold crossed

### Files

skills/token-alert/
├── SKILL.md                    # This file
├── README.md                   # GitHub documentation
├── LICENSE                     # MIT License
├── .clawdhub/
│   └── manifest.json           # ClawdHub metadata
├── assets/
│   ├── dashboard-78-high.png   # Screenshot (High Warning)
│   └── dashboard-96-emergency.png  # Screenshot (Emergency)
└── scripts/
    ├── check.py                # Token checker (Terminal)
    ├── dashboard.html          # Rich UI dashboard
    └── show_dashboard.py       # Dashboard launcher

### Dependencies

Python 3.8+
Clawdbot session_status tool
Optional: Telegram channel configured

### Script API

# scripts/check.py
def get_session_tokens():
    """Get current session token usage via session_status tool"""
    
def check_thresholds(percent):
    """Check if usage exceeds thresholds"""
    
def format_alert(used, limit, percent, level):
    """Format alert message for Telegram"""

### When to Use

Before long tasks - Check if you have enough tokens
Mid-conversation - Monitor usage during long sessions
Daily check - Add to HEARTBEAT for automatic monitoring

### Limitations

Only monitors session tokens (not Claude.ai API limits)
Requires active Clawdbot session
Alert frequency can be noisy if near threshold

### Future Enhancements

Claude.ai API limits scraping (optional)
 Historical token usage tracking
 Weekly/monthly usage reports
 Integration with token-router skill

### Support

GitHub Issues: https://github.com/r00tid/clawdbot-token-alert/issues
ClawdHub: https://clawdhub.com/skills/token-alert
Docs: https://docs.clawd.bot

### License

MIT License - See LICENSE file

Built with ❤️ by Grym 🥜
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: r00tid
- Version: 1.2.0
## Source health
- Status: unstable
- Item is unstable.
- This item is timing out or returning errors right now. Review the source page and try again later.
- Health scope: item
- Reason: timeout
- Checked at: 2026-04-30T07:56:41.780Z
- Expires at: 2026-04-30T19:56:41.780Z
- Recommended action: Review source status
## Links
- [Detail page](https://openagent3.xyz/skills/token-alert)
- [Send to Agent page](https://openagent3.xyz/skills/token-alert/agent)
- [JSON manifest](https://openagent3.xyz/skills/token-alert/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/token-alert/agent.md)
- [Download page](https://openagent3.xyz/downloads/token-alert)