TokenFlow para Openclaw

Uma ferramenta agnóstica a agentes para converter documentos, planilhas, arquivos de áudio e páginas da web de vários formatos em Markdown ou HTML estruturado.

kolemaravilla
v1.0.0
May 19, 2026
0
749
0

Instalar e Baixar

1. ClawHub CLI

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

npx clawhub@latest install tokenflow

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 tokenflow 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 é TokenFlow?

TokenFlow é uma ferramenta altamente extensível e agnóstica a agentes, projetada para preencher a lacuna entre arquivos pesados e não estruturados e as janelas de contexto de LLM. Ao integrar-se com a TokenFlow API, esta capacidade converte automaticamente PDFs, planilhas, documentos Word, páginas da web e arquivos de áudio em markdown ou HTML analisado e limpo. Serve como um complemento essencial para o catálogo de Openclaw Skills de qualquer desenvolvedor, permitindo que agentes de IA leiam facilmente arquivos locais e páginas da web externas.

Como a configuração é gerenciada inteiramente pelo lado do agente por meio de um perfil JSON local, os desenvolvedores podem definir regras personalizadas para diferentes tipos de documentos, gerenciar fallbacks durante falhas de conversão e estabelecer prompts interativos. Ao traduzir ativos binários em texto semântico leve, o TokenFlow garante que seus fluxos de trabalho maximizem a eficiência de tokens e mantenham um rico contexto de formato.

Casos de uso do TokenFlow

  • Processamento de documentos DOCX e PDF massivos em formatos markdown estruturados prontos para LLM.
  • Visualização e conversão de arquivos de planilha complexos (.xlsx, .xls, .csv) com roteamento de planilha única ou múltipla.
  • Transcrição de arquivos de áudio de vários formatos diretamente em transcrições estruturadas para análise de conversação.
  • Busca de URLs coladas e conversão de elementos de layout da web de destino em markdown limpo.
  • Otimização do overhead de processamento geral para fluxos de trabalho personalizados alimentados por plataformas Openclaw Skills.

Como o TokenFlow funciona

  1. Intercepção (Interception): O agente de IA detecta um anexo de documento, arquivo de áudio ou URL da web colado.
  2. Correspondência de Configuração (Configuration Match): A skill processa a extensão em relação às políticas de comportamento local para decidir se deve converter, pular ou solicitar a confirmação do usuário.
  3. Visualização de Planilha (Spreadsheet Previewing): Para planilhas Excel, a skill executa uma solicitação de visualização rápida para inspecionar a matriz de guias interna antes de chamar a conversão completa.
  4. Chamada de Conversão (Conversion Call): Os dados do arquivo são enviados para a TokenFlow API via solicitações multipart seguras, convertendo a entrada no layout de saída desejado.
  5. Injeção (Injection): O texto estruturado é retornado à sessão ativa, expandindo instantaneamente a memória de execução do agente do desenvolvedor.
  6. Salvaguardas de Erro (Error Safeguards): Se ocorrerem timeouts, limites de taxa ou erros de validação, o sistema aciona fallbacks predefinidos, retornando graciosamente ao uso padrão do arquivo.

Configuração do TokenFlow

Para integrar este utilitário de conversão em seus fluxos de trabalho, configure suas credenciais e puxe o módulo para sua instância local.

Instalação

Para sistemas que utilizam Openclaw Skills, execute o comando de instalação do pacote:

openclaw skills install tokenflow

Alternativamente, clone ou baixe o workspace manualmente para o local configurado:

cp -r tokenflow ~\/.openclaw\/skills\/

Para configurações do Hermes, coloque o diretório no seu caminho de skills ativo:

cp -r tokenflow ~\/.hermes\/skills\/

Configuração

Crie um arquivo de configuração local chamado config.json dentro do diretório da sua skill:

{
  "apiKey": "your-api-key-here",
  "apiUrl": "https:\/\/tokenflow.fly.dev",
  "filetypeBehavior": {
    "docx": { "action": "convert", "askEachTime": false },
    "xlsx": { "action": "convert", "askEachTime": true },
    "pdf": { "action": "convert", "askEachTime": false },
    "audio": { "action": "convert", "askEachTime": false }
  },
  "outputFormat": "markdown",
  "maxRetries": 1,
  "fallbackBehavior": "use_file"
}

Certifique-se de configurar as chaves do seu ambiente se o seu sistema de tempo de execução exigir variáveis de execução:

export TOKENFLOW_API_KEY="Your TokenFlow API key"

Esquema de Dados e Taxonomia de TokenFlow

O TokenFlow estrutura todas as conversões por meio de um perfil localizado e interage com nós de API estruturados. Abaixo está o mapeamento da taxonomia de configuração:

Regras de Tipo de Arquivo

Tipo de Arquivo Extensões Suportadas Política de Ação Solicitar Usuário (askEachTime)
docx .docx, .pptx "convert" ou "skip" True/False
xlsx .xlsx, .xls, .csv "convert" ou "skip" True/False
pdf .pdf "convert" ou "skip" True/False
audio .wav, .mp3, .ogg, .flac, .m4a "convert" ou "skip" True/False

Esquema de Roteamento de Endpoint

  • POST \/convert: Converte arquivos para Markdown/HTML estruturado usando seu token de autorização.
  • POST \/convert\/preview: Recupera registros de índice e metadados de guias para pastas de trabalho com várias planilhas.
  • POST \/convert\/url: Transforma hiperlinks externos em estruturas markdown legíveis.
  • GET \/health: Serve como o endpoint de verificação do sistema.
  • GET \/usage: Monitora créditos mensais e estatísticas de uso de consultas.

Recursos avançados do TokenFlow

  • Recuperação Flexível de Erros: Defina comportamentos de fallback como use_file para contornar falhas de conversão e retornar aos anexos brutos.
  • Processamento de Imagem Embutido: Renderiza imagens codificadas em base64 diretamente dentro de payloads markdown de PDF para processamento multimodal contínuo.
  • Controles de Prompt Interativos: Ative avisos de conversão individuais para payloads pesados de planilhas ou áudio para manter os desenvolvedores em controle total.
  • Análise de Pasta de Trabalho Pré-conversão: Executa visualizações de planilhas localizadas para processar facilmente planilhas aninhadas sem blocos de overhead.
  • Portabilidade Nativa Cross-Agent: Execute a skill sem esforço em ambientes Openclaw Skills e Hermes sem modificar os fluxos de trabalho principais do agente.

SKILL.md


Carregamento

Habilidades relacionadas do Openclaw

METADATA

Github Stars: 0
forks: 0

Apresentou*