TokenFlow pour Openclaw

Un outil agnostique aux agents pour convertir des documents, des feuilles de calcul, des fichiers audio et des pages web de formats multiples en Markdown ou HTML structuré.

kolemaravilla
v1.0.0
May 19, 2026
0
749
0

Installer & Télécharger

1. ClawHub CLI

Le moyen le plus rapide d'installer une compétence directement depuis le registre.

npx clawhub@latest install tokenflow

2. Installation manuelle

Copiez le dossier de la compétence dans l'un de ces emplacements

Global
~/.openclaw/skills/
Espace de travail
<project>/skills/

Priorité : Espace de travail > Local > Intégré

3. Installation du prompt

Copiez ce prompt dans OpenClaw pour l'installer automatiquement.

Aide-moi à installer tokenflow via Clawhub. Si Clawhub n'est pas installé, installe-le d'abord (npm i -g clawhub).

Vous préférez télécharger ?

Obtenez les fichiers bruts de la compétence dans une archive ZIP.

Qu'est-ce que TokenFlow ?

TokenFlow est un outil hautement extensible et agnostique aux agents, conçu pour combler le fossé entre les fichiers lourds et non structurés et les fenêtres de contexte LLM. En s'intégrant avec l'API TokenFlow, cette capacité convertit automatiquement les PDF, les feuilles de calcul, les documents Word, les pages web et les fichiers audio en markdown ou HTML analysé et propre. Il constitue un ajout essentiel au catalogue Openclaw Skills de tout développeur, permettant aux agents IA de lire sans effort les fichiers locaux et les pages web externes.

Comme la configuration est entièrement gérée côté agent via un profil JSON local, les développeurs peuvent définir des règles personnalisées pour différents types de documents, gérer les solutions de repli (fallback) en cas d'échec de conversion et établir des invites interactives. En traduisant des actifs binaires en texte sémantique léger, TokenFlow garantit que vos flux de travail maximisent l'efficacité des tokens et maintiennent un contexte de format riche.

Cas d'utilisation de TokenFlow

  • Traitement de documents DOCX et PDF massifs en formats markdown structurés prêts pour les LLM.
  • Prévisualisation et conversion de fichiers de feuilles de calcul complexes (.xlsx, .xls, .csv) avec routage pour feuille unique ou multiple.
  • Transcription de fichiers audio de formats multiples directement en transcriptions structurées pour l'analyse de conversation.
  • Récupération d'URLs collées et conversion des éléments de mise en page web cibles en markdown propre.
  • Optimisation de la surcharge de traitement globale pour les flux de travail personnalisés alimentés par les plateformes Openclaw Skills.

Comment fonctionne TokenFlow

  1. Interception (Interception) : L'agent IA détecte une pièce jointe de document, un fichier audio ou une URL web collée.
  2. Configuration Match (Correspondance de configuration) : La skill traite l'extension par rapport aux politiques de comportement local pour décider de convertir, ignorer ou demander la confirmation de l'utilisateur.
  3. Spreadsheet Previewing (Prévisualisation de feuille de calcul) : Pour les feuilles Excel, la skill exécute une demande de prévisualisation rapide pour inspecter la matrice d'onglets interne avant d'appeler la conversion complète.
  4. Conversion Call (Appel de conversion) : Les données du fichier sont envoyées à l'API TokenFlow via des demandes multipart sécurisées, convertissant l'entrée dans la mise en page cible.
  5. Injection (Injection) : Le texte structuré est renvoyé à la session active, étendant instantanément la mémoire d'exécution de l'agent du développeur.
  6. Error Safeguards (Protections contre les erreurs) : Si des délais d'attente, des limites de débit ou des erreurs de validation se produisent, le système déclenche des solutions de repli prédéfinies, revenant gracieusement à l'utilisation standard du fichier.

Configuration de TokenFlow

Pour intégrer cet utilitaire de conversion dans vos flux de travail, configurez vos identifiants et récupérez le module sur votre instance locale.

Installation

Pour les systèmes utilisant Openclaw Skills, exécutez la commande d'installation du package :

openclaw skills install tokenflow

Alternativement, clonez ou téléchargez l'espace de travail manuellement à l'emplacement configuré :

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

Pour les configurations Hermes, placez le répertoire dans votre chemin de skills actif :

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

Configuration

Créez un fichier de configuration local nommé config.json dans le répertoire de votre 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"
}

Assurez-vous de configurer vos clés d'environnement si votre système d'exécution nécessite des variables d'exécution :

export TOKENFLOW_API_KEY="Your TokenFlow API key"

Schéma de données et taxonomie de TokenFlow

TokenFlow structure toutes les conversions via un profil localisé et interagit avec des nœuds API structurés. Voici la taxonomie de configuration :

Règles de type de fichier

Type de fichier Extensions prises en charge Politique d'action Demander à l'utilisateur (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

Schéma de routage des points de terminaison

  • POST \/convert : Convertit les fichiers en Markdown/HTML structuré en utilisant votre jeton d'autorisation.
  • POST \/convert\/preview : Récupère les enregistrements d'index et les métadonnées d'onglets pour les classeurs multi-feuilles.
  • POST \/convert\/url : Transforme les hyperliens externes en structures markdown lisibles.
  • GET \/health : Sert de point de terminaison de vérification du système.
  • GET \/usage : Surveille les crédits mensuels et les statistiques d'utilisation des requêtes.

Fonctionnalités avancées de TokenFlow

  • Récupération flexible des erreurs : Définissez des comportements de repli comme use_file pour contourner les échecs de conversion et revenir aux pièces jointes brutes.
  • Traitement d'image intégré : Rend les images encodées en base64 directement dans les charges utiles Markdown PDF pour un traitement multimodal continu.
  • Contrôles d'invites interactifs : Activez des avertissements de conversion individuels pour les feuilles de calcul lourdes ou les charges utiles audio afin de garder les développeurs en contrôle total.
  • Analyse du classeur avant conversion : Exécute des prévisualisations de feuilles localisées pour traiter facilement les feuilles de calcul imbriquées sans blocs de surcharge.
  • Portabilité native entre agents : Exécutez la skill sans effort dans les environnements Openclaw Skills et Hermes sans modifier les flux de travail de base des agents.

SKILL.md


Chargement

Compétences Openclaw associées

METADATA

Github Stars: 0
forks: 0

En vedette*