← Back to Skills Marketplace
TokenRanger
by
synchronic1
· GitHub ↗
· v1.0.0
313
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install tokenranger
Description
Install, configure, and operate the TokenRanger OpenClaw plugin. Use when you want to reduce cloud LLM token costs by 50-80% via local Ollama context compres...
Usage Guidance
This skill is internally consistent with a local compression sidecar, but before installing you should: (1) verify the plugin package and repo (openclaw-plugin-tokenranger) on GitHub and npm to ensure you trust the maintainer; (2) inspect the plugin's service unit / launchd plist and start scripts that will be installed (~/.openclaw/extensions/... and user-level systemd/LaunchAgents) so you know what commands will run as a persistent service; (3) be aware the setup downloads Ollama models and Python deps (large network activity and disk usage) and will run a local HTTP sidecar bound to localhost — confirm it does not expose data to the network; (4) backup any important OpenClaw config before changing plugin entries; and (5) if you need higher assurance, review the plugin source code or test in an isolated VM/container first.
Capability Analysis
Type: OpenClaw Skill
Name: tokenranger
Version: 1.0.0
The OpenClaw skill 'tokenranger' is classified as benign. The `SKILL.md` file transparently describes the installation and operation of a local sidecar plugin designed to reduce LLM token costs. It uses standard OpenClaw CLI commands for plugin management and configuration, and standard system commands (`systemctl`, `launchctl`) for registering and managing a user-level background service. While installing a system service is a powerful capability, it is explicitly stated and appears necessary for the plugin's continuous operation as a 'sidecar'. There is no evidence of prompt injection, data exfiltration, unauthorized remote access, or other malicious intent within the provided files. All described actions are consistent with the stated purpose and use local resources (localhost:8100, localhost:11434).
Capability Assessment
Purpose & Capability
The skill claims to install and operate a local TokenRanger sidecar that compresses context via Ollama and LangChain; the SKILL.md only requires the openclaw CLI and instructs installing an OpenClaw plugin and running local setup. Required binaries/envs are consistent with that purpose.
Instruction Scope
The runtime instructions include installing the plugin, creating a Python venv, pulling Ollama models, installing FastAPI/LangChain deps, and registering a user-level service (systemd/launchd). These actions are within scope for a sidecar-based compression plugin, but they do modify user configuration and start persistent local services and access local logs/service status for troubleshooting.
Install Mechanism
This is an instruction-only skill (no embedded install spec). It instructs the user to run 'openclaw plugins install openclaw-plugin-tokenranger' (and references a GitHub repo and npm package). That is lower risk than an arbitrary URL download, but the actual code will be fetched when the user runs the install command — so verify the upstream package/source before installing.
Credentials
The skill does not request environment variables, secrets, or unrelated credentials. Its operations (local sidecar, Ollama, service files, logs) are proportional to the stated functionality.
Persistence & Privilege
The setup registers a user-level persistent service (systemd user or launchd agent) and writes files under the user's home (~/.openclaw, ~/.config, ~/Library). This persistent presence is expected for a local sidecar but is a privileged local change — the skill does not set always:true and does not request system-wide elevated privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install tokenranger - After installation, invoke the skill by name or use
/tokenranger - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release. Skill for installing, configuring, and operating the TokenRanger context compression plugin. Plugin at https://github.com/peterjohannmedina/openclaw-plugin-tokenranger
Metadata
Frequently Asked Questions
What is TokenRanger?
Install, configure, and operate the TokenRanger OpenClaw plugin. Use when you want to reduce cloud LLM token costs by 50-80% via local Ollama context compres... It is an AI Agent Skill for Claude Code / OpenClaw, with 313 downloads so far.
How do I install TokenRanger?
Run "/install tokenranger" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is TokenRanger free?
Yes, TokenRanger is completely free (open-source). You can download, install and use it at no cost.
Which platforms does TokenRanger support?
TokenRanger is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created TokenRanger?
It is built and maintained by synchronic1 (@synchronic1); the current version is v1.0.0.
More Skills