Token Report for Openclaw

Automates the generation of token consumption dashboards and sends visual reports to Feishu.

yorha59
v1.0.0
Feb 27, 2026
0
1.3k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install token-report

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install token-report 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 Token Report?

The Token Report skill is a specialized utility designed for teams using Openclaw Skills to maintain transparency over their AI resource usage. It transforms raw usage data from multiple agent instances—such as main sessions and sub-agents like Selina or Tars—into a high-quality visual dashboard within the Canvas environment. By automating the reporting lifecycle, it removes the manual effort of tracking token costs and context window limits, providing a professional snapshot of system health directly within your team communication tools.

Token Report Use Cases

  • Tracking daily token consumption across different agent profiles like Selina and Tars.
  • Providing stakeholders with visual updates on AI resource budgets via Feishu.
  • Visualizing context window utilization to prevent session overflows during complex tasks.
  • Creating a visual record of usage spikes during intense development sprints using Openclaw Skills.

How Token Report Works

  1. Data Collection: The skill retrieves current token and context usage stats for specified sessions.
  2. Presentation: It uses the canvas action=present command to render a dark-themed HTML dashboard containing usage metrics.
  3. Capture: The browser action=screenshot command takes a high-resolution image of the rendered dashboard using a dedicated profile.
  4. Delivery: The resulting screenshot is automatically sent to the target Feishu chat via the message action=send function.

Token Report Setup

To deploy this within your Openclaw Skills library, follow these steps:

  1. Ensure your system meets the darwin (macOS) requirement.
  2. Identify your target Feishu chat ID for the reporting group.
  3. Update the target parameter in the skill configuration to match your chat ID:
# Update the target chat ID
target=chat:your_unique_feishu_id
  1. Verify that the browser tool is configured with the openclaw profile for consistent screenshot rendering.

Token Report Data Schema & Taxonomy

The skill organizes reporting data using a structured HTML template before conversion. The data points include:

Metric Description Source
Main Tokens Token count for the primary conversation Agent Session
Sub-Agent Tokens Consumption for Selina and Tars agents Agent Session
Context % Percentage of the context window currently utilized System Metadata
Timestamp Date and time of the report generation System Clock

Token Report Advanced Features

  • Customizable HTML templates allow for personalized branding and additional data fields.
  • Multi-agent tracking capability provides a holistic view of complex multi-agent workflows.
  • Seamless integration with the Openclaw Skills messaging protocol for automated delivery to Feishu.
  • Visual reporting ensures that context window saturation is easily monitored by non-technical stakeholders.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*