Token Audit para Openclaw

Um analisador de custo e consumo de Token gratuito e sem dependências que verifica workspaces de agentes OpenClaw em 6 modelos de linguagem principais.

justincredible-tech
v0.2.0
Feb 27, 2026
1
715
0

Instalar e Baixar

1. ClawHub CLI

A maneira mais rápida de instalar uma habilidade diretamente do registro.

npx clawhub@latest install token-audit

2. Instalação Manual

Copie a pasta da habilidade para um desses locais

Global
~/.openclaw/skills/
Espaço de trabalho
<project>/skills/

Prioridade: Espaço de Trabalho > Local > Integrado

3. Instalação do Prompt

Copie este prompt para o OpenClaw para instalá-lo automaticamente.

Ajude-me a instalar o token-audit usando o Clawhub. Se o Clawhub não estiver instalado, instale-o primeiro (npm i -g clawhub).

Prefere baixar?

Obtenha os arquivos originais da habilidade em um arquivo ZIP.

O que é Token Audit?

A skill Token Audit é um utilitário poderoso e de código aberto, projetado especificamente para desenvolvedores e operadores OpenClaw que precisam obter visibilidade clara do uso de Token em LLM. Ele verifica arquivos de workspace e fornece estimativas precisas de Token em seis grandes famílias de modelos: GPT-4, Claude 3, Gemini, Llama 3, Mistral e Qwen. Ao revelar dados críticos sobre fatores de custo ocultos, esta skill ajuda os desenvolvedores a identificar contexto inchado, arquivos redundantes e grandes oportunidades de otimização.

Operando sem dependências externas e não exigindo chaves de API, esta skill funciona como um script independente focado na privacidade. Ela garante que você entenda exatamente como suas pegadas de dados mapeiam para métricas de Token e custos de hospedagem comercial antes de enviar payloads para provedores de LLM, estendendo efetivamente a vida útil e o orçamento de seus fluxos de trabalho automatizados.

Casos de uso do Token Audit

  • Otimização de Orçamentos de Agentes: Identificação de arquivos de alto custo dentro de um workspace de agente antes de iniciar tarefas automatizadas em larga escala.
  • Gerenciamento de Janela de Contexto: Prevenção de erros de estouro de contexto através da auditoria de contagem de Token em diferentes backends de LLM antes da execução.
  • Limpeza de Workspace: Descoberta de arquivos redundantes ou desproporcionalmente grandes que consomem contagens massivas de Token em relação à sua utilidade de desenvolvimento.
  • Gates de Qualidade CI/CD: Integração de verificações de estimativa de custo e Token em hooks de repositório local para manter bases de código enxutas.

Como o Token Audit funciona

  1. Verificação de Workspace: O script tem como alvo o diretório de workspace padrão do OpenClaw ou um caminho personalizado definido pelo usuário.
  2. Estimativa de Token: Ele processa cada arquivo válido no workspace, avaliando comprimentos de Token adaptados às características de tokenização em seis grandes provedores de LLM.
  3. Projeção de Custo: O script aplica modelos de precificação atuais às contagens de Token estimadas, gerando projeções financeiras claras por modelo.
  4. Geração de Relatório: Ele apresenta recomendações, identificando arquivos que são desproporcionalmente grandes, e gera as métricas finais em formato de terminal legível por humanos ou JSON legível por máquina.

Configuração do Token Audit

Para começar a usar a skill Token Audit em seu ambiente, execute o script a partir do seu terminal. Nenhum pacote externo ou chave de API é necessário.

Verificar o Workspace Padrão

python3 scripts/token-audit.py

Verificar um Caminho de Destino

python3 scripts/token-audit.py --workspace /path/to/workspace

Exportar Dados como JSON

python3 scripts/token-audit.py --json

Esquema de Dados e Taxonomia de Token Audit

A skill processa seu layout de arquivo local e gera métricas analíticas estruturadas em torno das seguintes categorias:

Ponto de Dados Descrição
Contagem Total de Token Contagem consolidada de Token em todos os arquivos verificados, personalizada por família de modelo.
Detalhamento por Arquivo Uma lista ordenada de arquivos, classificada de forma decrescente pelo tamanho do Token, para localizar rapidamente inchaço de conteúdo.
Estimativa de Custo Métricas de custo financeiro projetadas calculadas para GPT-4, Claude 3, Gemini, Llama 3, Mistral e Qwen.
Flags de Otimização Recomendações acionáveis apontando arquivos que têm custos de Token incomumente altos vs valor esperado.

Recursos avançados do Token Audit

  • Paridade Multi-Modelo: Fornece cálculos de Token simultâneos em seis especificações de provedor distintas em uma única varredura de execução.
  • Motor JSON Estruturado: Emite payloads JSON totalmente estruturados usando a flag --json, tornando-o perfeito para integração em painéis de desenvolvedor automatizados, pipelines de CI/CD ou pipelines de script personalizados.
  • Compatibilidade com o Ecossistema Caelguard: Opera nativamente junto com outras Openclaw Skills e ferramentas de segurança como o shellguard-scanner para estabelecer gates de segurança locais abrangentes.

SKILL.md


Carregamento

Habilidades relacionadas do Openclaw

METADATA

Github Stars: 0
forks: 0

Apresentou*