Openclaw용 TokenFlow

다양한 형식의 문서, 스프레드시트, 오디오 파일 및 웹 페이지를 구조화된 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 문서, 웹 페이지 및 오디오 파일을 자동으로 파싱된 깔끔한 Markdown 또는 HTML로 변환합니다. 이는 모든 개발자의 Openclaw Skills 카탈로그에 필수적인 추가 기능이며, AI 에이전트가 로컬 파일과 외부 웹 페이지를 쉽게 읽을 수 있도록 해줍니다.

구성은 로컬 JSON 프로필을 통해 전적으로 에이전트 측에서 관리되므로, 개발자는 다양한 문서 유형에 대한 사용자 지정 규칙을 설정하고, 변환 실패 시 대체 경로(fallback)를 관리하며, 대화형 프롬프트를 설정할 수 있습니다. 이진 자산을 경량 의미론적 텍스트로 변환함으로써, TokenFlow는 워크플로우가 토큰 효율성을 극대화하고 풍부한 포맷 컨텍스트를 유지하도록 보장합니다.

TokenFlow 활용 사례

  • 방대한 DOCX 및 PDF 문서를 구조화된 LLM 준비 완료 Markdown 형식으로 처리.
  • 단일 또는 다중 시트 라우팅을 통해 복잡한 스프레드시트 파일(.xlsx, .xls, .csv) 미리보기 및 변환.
  • 대화 파싱을 위해 다중 형식 오디오 파일을 구조화된 대본으로 직접 전사.
  • 붙여넣은 URL을 가져와 대상 웹 레이아웃 요소를 깔끔한 Markdown으로 변환.
  • Openclaw Skills 플랫폼으로 구동되는 사용자 지정 워크플로우의 전반적인 처리 오버헤드 최적화.

TokenFlow 작동 원리

  1. 인터셉션 (Interception): AI 에이전트가 들어오는 문서 첨부 파일, 오디오 파일 또는 붙여넣은 웹 URL을 감지합니다.
  2. 구성 일치 (Configuration Match): 기술(skill)은 로컬 동작 정책에 따라 확장자를 처리하여 변환, 건너뛰기 또는 사용자 확인 요청 여부를 결정합니다.
  3. 스프레드시트 미리보기 (Spreadsheet Previewing): Excel 시트의 경우, 전체 변환을 호출하기 전에 내부 탭 매트릭스를 검사하기 위해 빠른 미리보기 요청을 실행합니다.
  4. 변환 호출 (Conversion Call): 파일 데이터는 안전한 multipart 요청을 통해 TokenFlow API로 전송되며, 입력을 대상 출력 레이아웃으로 변환합니다.
  5. 주입 (Injection): 구조화된 텍스트가 활성 세션으로 반환되어, 개발자의 에이전트 실행 메모리를 즉시 확장합니다.
  6. 오류 방지 (Error Safeguards): 시간 초과, 속도 제한 또는 유효성 검사 오류가 발생하면, 시스템은 미리 정의된 fallback을 트리거하여 표준 파일 사용 방식으로 우아하게 복구합니다.

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과 같은 fallback 동작을 정의하여 변환 실패를 우회하고 원본 첨부 파일로 돌아갑니다.
  • 임베디드 이미지 처리: 지속적인 멀티모달 처리를 위해 base64로 인코딩된 이미지를 PDF Markdown 페이로드 내에서 직접 렌더링합니다.
  • 대화형 프롬프트 제어: 대형 스프레드시트나 오디오 페이로드에 대해 개별 변환 경고를 활성화하여 개발자가 완전한 제어권을 유지하도록 합니다.
  • 변환 전 통합 문서 분석: 로컬화된 시트 미리보기를 실행하여 오버헤드 블록 없이 중첩된 스프레드시트를 쉽게 처리합니다.
  • 네이티브 크로스 에이전트 이식성: 핵심 에이전트 워크플로우를 수정하지 않고도 Openclaw Skills 및 Hermes 환경 전반에서 스킬을 쉽게 실행합니다.

SKILL.md


로드 중

관련 Openclaw 스킬

METADATA

Github Stars: 0
forks: 0

추천*