TokenFlow for Openclaw

To integrate this conversion utility into your workflows, configure your credentials and pull the module to your local instance.

Installation

For systems utilizing Openclaw Skills, run the package installation command:

openclaw skills install tokenflow

Alternatively, clone or download the workspace manually into your configured location:

cp -r tokenflow ~/.openclaw/skills/

For Hermes configurations, place the directory into your active skills path:

cp -r tokenflow ~/.hermes/skills/

Configuration

Create a local configuration file named config.json inside your skill's directory:

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

Ensure you configure your environment keys if your runtime system requires execution variables:

export TOKENFLOW_API_KEY="Your TokenFlow API key"

TokenFlow structures all conversions through a localized profile and interacts with structured API nodes. Below is the configuration taxonomy mapping:

Filetype Rules

Endpoint Routing Schema

• POST /convert: Converts files to structured Markdown/HTML using your authorization token.
• POST /convert/preview: Retrieves index records and tab metadata for multi-sheet workbooks.
• POST /convert/url: Transforms external hyperlinks into readable markdown structures.
• GET /health: Serves as the system check endpoint.
• GET /usage: Monitors monthly credits and query usage stats.