← Back to Skills Marketplace
wangyaok1

TokFlow

by Eadon Wang · GitHub ↗ · v0.5.0
cross-platform ✓ Security Clean
951
Downloads
2
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install tokflow
Description
Token 消耗监控与优化分析工具。查询 LLM 模型用量、费用、各渠道余额、提问方式分析与优化建议。当用户询问 token 消耗、模型费用、优化建议、渠道余额、提问方式优化等问题时使用此技能。
Usage Guidance
This skill is a thin client that calls a local TokFlow service on http://localhost:8001 to get token/usage reports and suggestions; the wrapper itself is low-risk (no external downloads, no env-vars requested), but the backend it depends on will have access to your OpenClaw session files and any provider credentials needed to check balances. Before installing or using: (1) confirm you actually have a trusted TokFlow backend running on localhost (or else the calls will fail); (2) inspect and trust the TokFlow backend code/config — it will read conversation logs and may store/provider API keys; (3) ensure provider credentials are stored securely and not exposed to untrusted services; (4) if you lack assurance about the backend, run this skill in an isolated/test environment or review the backend implementation first.
Capability Analysis
Type: OpenClaw Skill Name: tokflow Version: 0.5.0 The TokFlow skill is designed to query a local service running on `http://localhost:8001/api` for LLM token usage and optimization data. The `scripts/tokflow_query.py` script uses standard Python libraries (`urllib.request`, `json`) to make HTTP GET/POST requests to this local endpoint. User-provided arguments like `model_id` are properly URL-encoded using `urllib.parse.quote`, and numeric arguments like `days` are type-casted to integers, preventing injection vulnerabilities. There is no evidence of external network calls, file system manipulation, shell command execution of untrusted input, data exfiltration, persistence mechanisms, or malicious prompt injection attempts against the AI agent in `SKILL.md` or `README.md`. The skill's functionality is entirely confined to interacting with a presumed legitimate local service, aligning with its stated purpose.
Capability Assessment
Purpose & Capability
Name/description (token consumption monitoring, optimization, prompt stats) matches the provided code and SKILL.md. The included script only queries a local API (http://localhost:8001/api) for dashboards, models, provider balances, suggestions, analysis and prompt statistics — this is consistent with the stated purpose. No extraneous credentials or unrelated binaries are requested by the skill itself.
Instruction Scope
SKILL.md instructs the agent to run scripts/tokflow_query.py which issues HTTP requests to a local backend. The skill does not instruct reading arbitrary files or env vars itself, but explicitly states the data source is OpenClaw local JSONL session files and that provider balances are queried from platform APIs — those actions are performed by the TokFlow backend, not by this wrapper script. That means the runtime behavior and data access depend on the backend implementation; the skill delegates potentially sensitive actions (reading conversation history, contacting provider APIs) to that local service.
Install Mechanism
No install spec is present (instruction-only plus a small helper script). There are no downloads, package installs, or archive extraction. The included Python script is straightforward and only connects to localhost; nothing is written to disk by an installer as part of this skill package.
Credentials
The skill itself requests no environment variables or credentials, which is proportionate for a thin wrapper that queries a local service. However, the SKILL.md and README indicate the TokFlow backend will access OpenClaw session JSONL files and external provider APIs — that backend will therefore require access to conversation data and provider credentials. Users should verify where and how those credentials are stored and ensure the backend handles them securely.
Persistence & Privilege
Flags show always:false (not force-included) and normal autonomous invocation allowed. The skill does not request to modify other skills or system-wide settings and does not require persistent elevated privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install tokflow
  3. After installation, invoke the skill by name or use /tokflow
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.5.0
v0.5.0 提问方式监控与优化
Metadata
Slug tokflow
Version 0.5.0
License
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is TokFlow?

Token 消耗监控与优化分析工具。查询 LLM 模型用量、费用、各渠道余额、提问方式分析与优化建议。当用户询问 token 消耗、模型费用、优化建议、渠道余额、提问方式优化等问题时使用此技能。 It is an AI Agent Skill for Claude Code / OpenClaw, with 951 downloads so far.

How do I install TokFlow?

Run "/install tokflow" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is TokFlow free?

Yes, TokFlow is completely free (open-source). You can download, install and use it at no cost.

Which platforms does TokFlow support?

TokFlow is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created TokFlow?

It is built and maintained by Eadon Wang (@wangyaok1); the current version is v0.5.0.

💬 Comments