Openclaw向けTokenFlow

さまざまな形式のドキュメント、スプレッドシート、オーディオファイル、Webページを、構造化されたMarkdownまたはHTMLに変換するためのエージェント非依存型ツールです。

kolemaravilla
v1.0.0
May 19, 2026
0
749
0

インストール&ダウンロード

1. ClawHub CLI

レジストリから直接スキルをインストールする最速の方法です。

npx clawhub@latest install tokenflow

2. 手動インストール

スキルフォルダを以下のいずれかの場所にコピーしてください

グローバル
~/.openclaw/skills/
ワークスペース
<project>/skills/

優先順位:ワークスペース > ローカル > バンドル

3. プロンプトのインストール

このプロンプトをOpenClawにコピーするだけで、自動的にインストールされます。

Clawhubを使って tokenflow をインストールして。Clawhubがインストールされていない場合は、先にインストールしてください(npm i -g clawhub)。

ダウンロードをご希望ですか?

ZIPアーカイブで生のスキルファイルを取得します。

TokenFlow とは?

TokenFlowは、巨大で非構造化なファイルとLLMのコンテキストウィンドウ間のギャップを埋めるために設計された、拡張性の高いエージェント非依存型ツールです。TokenFlow APIと統合することで、この機能はPDF、スプレッドシート、Wordドキュメント、Webページ、オーディオファイルを、解析済みのクリーンなMarkdownまたはHTMLに自動変換します。これはあらゆる開発者のOpenclaw Skillsカタログに不可欠な追加機能であり、AIエージェントがローカルファイルや外部Webページを簡単に読み取れるようにします。

構成はローカルのJSONプロファイルを通じてエージェント側で完全に管理されるため、開発者はさまざまなドキュメントタイプに対してカスタムルールを設定したり、変換失敗時のフォールバックを管理したり、対話型のプロンプトを設定したりできます。バイナリ資産を軽量なセマンティックテキストに変換することで、TokenFlowはワークフローのトークン効率を最大化し、豊かなフォーマットコンテキストを維持することを保証します。

TokenFlow のユースケース

  • 大規模なDOCXおよびPDFドキュメントを、LLM対応の構造化Markdown形式に処理。
  • シングルまたはマルチシートルーティングによる、複雑なスプレッドシートファイル(.xlsx, .xls, .csv)のプレビューおよび変換。
  • 会話解析のための、多形式オーディオファイルの構造化トランスクリプトへの直接文字起こし。
  • 貼り付けられたURLを取得し、ターゲットWebレイアウト要素をクリーンなMarkdownに変換。
  • Openclaw Skillsプラットフォームで動作するカスタムワークフロー全体の処理オーバーヘッドを最適化。

TokenFlow の仕組み

  1. インターセプション (Interception): AIエージェントが、受信したドキュメントの添付ファイル、オーディオファイル、または貼り付けられたWeb URLを検出します。
  2. 設定照合 (Configuration Match): スキルはローカルの動作ポリシーに基づいて拡張子を処理し、変換、スキップ、またはユーザー確認を要求するかを決定します。
  3. スプレッドシートプレビュー (Spreadsheet Previewing): Excelシートの場合、スキルは完全な変換を呼び出す前に、内部タブマトリックスを検査するための高速プレビュー要求を実行します。
  4. 変換呼び出し (Conversion Call): ファイルデータは安全なマルチパート要求を通じてTokenFlow APIに送信され、入力をターゲットの出力レイアウトに変換します。
  5. 注入 (Injection): 構造化テキストがアクティブなセッションに返され、開発者のエージェント実行メモリを即座に拡張します。
  6. エラーセーフガード (Error Safeguards): タイムアウト、レート制限、または検証エラーが発生した場合、システムは事前定義されたフォールバックをトリガーし、標準のファイル使用方法へスムーズに切り替えます。

TokenFlow のセットアップ

この変換ユーティリティをワークフローに統合するには、資格情報を構成し、モジュールをローカルインスタンスにプルします。

インストール

Openclaw Skillsを使用しているシステムの場合、パッケージインストールコマンドを実行します:

openclaw skills install tokenflow

または、ワークスペースを手動でクローンするか、構成した場所にダウンロードしてください:

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

Hermes構成の場合は、ディレクトリをアクティブなスキルパスに配置します:

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

構成

スキルディレクトリ内に config.json という名前のローカル構成ファイルを作成します:

{
  "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"
}

ランタイムシステムが実行変数を必要とする場合は、環境変数のキーを構成していることを確認してください:

export TOKENFLOW_API_KEY="Your TokenFlow API key"

TokenFlow のデータスキーマとタクソノミー

TokenFlowはローカライズされたプロファイルを通じてすべての変換を構造化し、構造化されたAPIノードと対話します。以下は構成の分類マッピングです:

ファイルタイプルール

ファイルタイプ サポートされている拡張子 アクションポリシー ユーザーへのプロンプト (askEachTime)
docx .docx, .pptx "convert" または "skip" True/False
xlsx .xlsx, .xls, .csv "convert" または "skip" True/False
pdf .pdf "convert" または "skip" True/False
audio .wav, .mp3, .ogg, .flac, .m4a "convert" または "skip" True/False

エンドポイントルーティングスキーマ

  • POST \/convert: 認証トークンを使用して、ファイルを構造化されたMarkdown/HTMLに変換します。
  • POST \/convert\/preview: マルチシートブックのインデックスレコードとタブメタデータを取得します。
  • POST \/convert\/url: 外部ハイパーリンクを読み取り可能なMarkdown構造に変換します。
  • GET \/health: システムチェックエンドポイントとして機能します。
  • GET \/usage: 月次クレジットとクエリ使用統計を監視します。

TokenFlow の高度な機能

  • 柔軟なエラー回復: use_fileなどのフォールバック動作を定義して、変換失敗を回避し、生の添付ファイルに戻します。
  • 埋め込み画像処理: PDF Markdownペイロード内でbase64エンコードされた画像を直接レンダリングし、継続的なマルチモーダル処理を実現します。
  • 対話型プロンプト制御: 大規模なスプレッドシートやオーディオペイロードに対して個別の変換警告を有効にし、開発者が完全に制御できるようにします。
  • 変換前のブック分析: ローカライズされたシートプレビューを実行して、オーバーヘッドブロックなしでネストされたスプレッドシートを簡単に処理します。
  • ネイティブのクロスエージェントポータビリティ: コアエージェントのワークフローを変更することなく、Openclaw SkillsとHermes環境全体でスキルを簡単に実行します。

SKILL.md


ローディング

関連するOpenclawのスキル

METADATA

Github Stars: 0
forks: 0

特徴*