{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/token-alert",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=token-alert",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "CHANGELOG.md",
      "IMPLEMENTATION_REPORT.md",
      "QUICKSTART.md",
      "README.md",
      "SKILL.md",
      "TESTING_NOTES.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/token-alert"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/token-alert",
    "agentPageUrl": "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"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Token Alert Skill",
        "body": "🚨 Monitor session tokens and get alerts at 75%/90%/95%"
      },
      {
        "title": "Overview",
        "body": "The Token Alert Skill automatically monitors your Clawdbot session token usage and sends alerts when you approach limits. Never lose context mid-conversation again!"
      },
      {
        "title": "Features",
        "body": "✅ 6-Level Threshold System - Alerts at 25%, 50%, 75%, 90%, 95%, 100%\n✅ Material Design Progress Bar - Box-style (▰/▱) with color gradients\n✅ Rich UI Dashboard - Interactive HTML dashboard with animations\n✅ Session Status - Shows current token usage on demand\n✅ Telegram Alerts - Get notified before hitting limits\n✅ HEARTBEAT Integration - Optional automated checks\n✅ Stateless - No state file needed, calculates on-demand\n✅ Session Estimates - Predicts remaining sessions (~50k avg)"
      },
      {
        "title": "Interactive Dashboard",
        "body": "Ask Grym:\n\n\"Show token dashboard\"\n\"Open dashboard\"\n\nOr run directly:\n\npython3 ~/clawd/skills/token-alert/scripts/show_dashboard.py"
      },
      {
        "title": "Terminal Check",
        "body": "Ask Grym:\n\n\"Wie viele Tokens habe ich noch übrig?\"\n\"Check token status\"\n\"Token usage?\"\n\nOr run:\n\npython3 ~/clawd/skills/token-alert/scripts/check.py"
      },
      {
        "title": "Automatic Alerts",
        "body": "Grym will automatically alert you when:\n\n🟡 25% - Low warning (~150k tokens left)\n🟠 50% - Medium warning (~100k tokens left)\n🔶 75% - High warning (~50k tokens left)\n🔴 90% - Critical warning (~20k tokens left)\n🚨 95% - Emergency! (<10k tokens left)"
      },
      {
        "title": "Example Output",
        "body": "🔶 Token Alert: Achtung!\n\n🔶 ▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▱▱▱▱▱▱ 78.0%\n156,000 / 200,000 Tokens verwendet\n\n⚠️ Status: High Warning (Rot-Orange Zone)\n💡 Verbleibend: ~44k Tokens\n⏰ Geschätzte Sessions: <1 Session\n\n🔧 Empfehlung:\n   ✅ Wichtige Entscheidungen jetzt treffen\n   ✅ Neue Session vorbereiten\n   ✅ Token-sparend arbeiten"
      },
      {
        "title": "Installation",
        "body": "# Via ClawdHub\nclawdhub install token-alert\n\n# Manual\ncd ~/clawd/skills\ngit clone https://github.com/r00tid/clawdbot-token-alert token-alert"
      },
      {
        "title": "HEARTBEAT Integration (Optional)",
        "body": "Add to ~/clawd/HEARTBEAT.md:\n\n### Token Usage Check (täglich)\n- [ ] `python3 ~/clawd/skills/token-alert/scripts/check.py`\n- **Warning ab 70%:** \"⚠️ Session bei XX% - Token-Sparend ab jetzt!\""
      },
      {
        "title": "How It Works",
        "body": "Uses Clawdbot's session_status tool\nCalculates percentage of token usage\nCompares against thresholds (75%, 90%, 95%)\nSends Telegram alert if threshold crossed"
      },
      {
        "title": "Files",
        "body": "skills/token-alert/\n├── SKILL.md                    # This file\n├── README.md                   # GitHub documentation\n├── LICENSE                     # MIT License\n├── .clawdhub/\n│   └── manifest.json           # ClawdHub metadata\n├── assets/\n│   ├── dashboard-78-high.png   # Screenshot (High Warning)\n│   └── dashboard-96-emergency.png  # Screenshot (Emergency)\n└── scripts/\n    ├── check.py                # Token checker (Terminal)\n    ├── dashboard.html          # Rich UI dashboard\n    └── show_dashboard.py       # Dashboard launcher"
      },
      {
        "title": "Dependencies",
        "body": "Python 3.8+\nClawdbot session_status tool\nOptional: Telegram channel configured"
      },
      {
        "title": "Script API",
        "body": "# scripts/check.py\ndef get_session_tokens():\n    \"\"\"Get current session token usage via session_status tool\"\"\"\n    \ndef check_thresholds(percent):\n    \"\"\"Check if usage exceeds thresholds\"\"\"\n    \ndef format_alert(used, limit, percent, level):\n    \"\"\"Format alert message for Telegram\"\"\""
      },
      {
        "title": "When to Use",
        "body": "Before long tasks - Check if you have enough tokens\nMid-conversation - Monitor usage during long sessions\nDaily check - Add to HEARTBEAT for automatic monitoring"
      },
      {
        "title": "Limitations",
        "body": "Only monitors session tokens (not Claude.ai API limits)\nRequires active Clawdbot session\nAlert frequency can be noisy if near threshold"
      },
      {
        "title": "Future Enhancements",
        "body": "Claude.ai API limits scraping (optional)\n Historical token usage tracking\n Weekly/monthly usage reports\n Integration with token-router skill"
      },
      {
        "title": "Support",
        "body": "GitHub Issues: https://github.com/r00tid/clawdbot-token-alert/issues\nClawdHub: https://clawdhub.com/skills/token-alert\nDocs: https://docs.clawd.bot"
      },
      {
        "title": "License",
        "body": "MIT License - See LICENSE file\n\nBuilt with ❤️ by Grym 🥜"
      }
    ],
    "body": "Token Alert Skill\n\n🚨 Monitor session tokens and get alerts at 75%/90%/95%\n\nOverview\n\nThe Token Alert Skill automatically monitors your Clawdbot session token usage and sends alerts when you approach limits. Never lose context mid-conversation again!\n\nFeatures\n✅ 6-Level Threshold System - Alerts at 25%, 50%, 75%, 90%, 95%, 100%\n✅ Material Design Progress Bar - Box-style (▰/▱) with color gradients\n✅ Rich UI Dashboard - Interactive HTML dashboard with animations\n✅ Session Status - Shows current token usage on demand\n✅ Telegram Alerts - Get notified before hitting limits\n✅ HEARTBEAT Integration - Optional automated checks\n✅ Stateless - No state file needed, calculates on-demand\n✅ Session Estimates - Predicts remaining sessions (~50k avg)\nUsage\nInteractive Dashboard\n\nAsk Grym:\n\n\"Show token dashboard\"\n\"Open dashboard\"\n\nOr run directly:\n\npython3 ~/clawd/skills/token-alert/scripts/show_dashboard.py\n\nTerminal Check\n\nAsk Grym:\n\n\"Wie viele Tokens habe ich noch übrig?\"\n\"Check token status\"\n\"Token usage?\"\n\nOr run:\n\npython3 ~/clawd/skills/token-alert/scripts/check.py\n\nAutomatic Alerts\n\nGrym will automatically alert you when:\n\n🟡 25% - Low warning (~150k tokens left)\n🟠 50% - Medium warning (~100k tokens left)\n🔶 75% - High warning (~50k tokens left)\n🔴 90% - Critical warning (~20k tokens left)\n🚨 95% - Emergency! (<10k tokens left)\nExample Output\n🔶 Token Alert: Achtung!\n\n🔶 ▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▱▱▱▱▱▱ 78.0%\n156,000 / 200,000 Tokens verwendet\n\n⚠️ Status: High Warning (Rot-Orange Zone)\n💡 Verbleibend: ~44k Tokens\n⏰ Geschätzte Sessions: <1 Session\n\n🔧 Empfehlung:\n   ✅ Wichtige Entscheidungen jetzt treffen\n   ✅ Neue Session vorbereiten\n   ✅ Token-sparend arbeiten\n\nInstallation\n# Via ClawdHub\nclawdhub install token-alert\n\n# Manual\ncd ~/clawd/skills\ngit clone https://github.com/r00tid/clawdbot-token-alert token-alert\n\nConfiguration\nHEARTBEAT Integration (Optional)\n\nAdd to ~/clawd/HEARTBEAT.md:\n\n### Token Usage Check (täglich)\n- [ ] `python3 ~/clawd/skills/token-alert/scripts/check.py`\n- **Warning ab 70%:** \"⚠️ Session bei XX% - Token-Sparend ab jetzt!\"\n\nHow It Works\nUses Clawdbot's session_status tool\nCalculates percentage of token usage\nCompares against thresholds (75%, 90%, 95%)\nSends Telegram alert if threshold crossed\nTechnical Details\nFiles\nskills/token-alert/\n├── SKILL.md                    # This file\n├── README.md                   # GitHub documentation\n├── LICENSE                     # MIT License\n├── .clawdhub/\n│   └── manifest.json           # ClawdHub metadata\n├── assets/\n│   ├── dashboard-78-high.png   # Screenshot (High Warning)\n│   └── dashboard-96-emergency.png  # Screenshot (Emergency)\n└── scripts/\n    ├── check.py                # Token checker (Terminal)\n    ├── dashboard.html          # Rich UI dashboard\n    └── show_dashboard.py       # Dashboard launcher\n\nDependencies\nPython 3.8+\nClawdbot session_status tool\nOptional: Telegram channel configured\nScript API\n# scripts/check.py\ndef get_session_tokens():\n    \"\"\"Get current session token usage via session_status tool\"\"\"\n    \ndef check_thresholds(percent):\n    \"\"\"Check if usage exceeds thresholds\"\"\"\n    \ndef format_alert(used, limit, percent, level):\n    \"\"\"Format alert message for Telegram\"\"\"\n\nWhen to Use\nBefore long tasks - Check if you have enough tokens\nMid-conversation - Monitor usage during long sessions\nDaily check - Add to HEARTBEAT for automatic monitoring\nLimitations\nOnly monitors session tokens (not Claude.ai API limits)\nRequires active Clawdbot session\nAlert frequency can be noisy if near threshold\nFuture Enhancements\n Claude.ai API limits scraping (optional)\n Historical token usage tracking\n Weekly/monthly usage reports\n Integration with token-router skill\nSupport\nGitHub Issues: https://github.com/r00tid/clawdbot-token-alert/issues\nClawdHub: https://clawdhub.com/skills/token-alert\nDocs: https://docs.clawd.bot\nLicense\n\nMIT License - See LICENSE file\n\nBuilt with ❤️ by Grym 🥜"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/r00tid/token-alert",
    "publisherUrl": "https://clawhub.ai/r00tid/token-alert",
    "owner": "r00tid",
    "version": "1.2.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}