← Back to Skills Marketplace
dorongss

TokenSaver

by dorongss · GitHub ↗ · v3.1.0 · MIT-0
cross-platform ⚠ suspicious
380
Downloads
0
Stars
1
Active Installs
12
Versions
Install in OpenClaw
/install openviking-korean
Description
한국어에 최적화된 OpenViking 기반 컨텍스트 DB로 토큰 91% 절감, 계층 구조 메모리 관리 및 자동 압축 기능을 제공합니다.
Usage Guidance
This package appears to implement a local context DB and compression as advertised, but it includes developer artifacts and scripts that will read and index user workspace files and even reference a ClawHub token path. Before installing or running: - Review the bundled Python files (especially auto_sync.py, init_bora_context.py, auto_recall.py, daily_summary.py, HANDOVER.md) for hard-coded paths and any code that opens files in your home/workspace. - Do not run convenience scripts (init_bora_context.py, auto_recall.py, daily_summary.py) unless you inspect and modify paths to a safe test directory. init_bora_context.py in particular tries to open files at C:\Users\Roken\... which is a leftover dev path and may reveal how the package will behave. - If you want to try it, run it inside an isolated environment or container and set the workspace directory explicitly to an empty directory (the AutoSync and ContextStore constructors accept workspace/base_path arguments). Example: create_auto_sync(workspace_path='~/tmp/safe_tokensaver_workspace'). - Search the package for any references to '.secrets', 'clawhub_token', or other token/secret file paths and remove or sandbox them. - Because the skill will read and write files under your home/workspace, avoid running it with sensitive files present or grant only to a directory you control. Given the presence of hard-coded dev paths and secret-file references, treat this skill as potentially privacy-sensitive until you validate and sanitize the code and workspace paths.
Capability Analysis
Type: OpenClaw Skill Name: openviking-korean Version: 3.1.0 The skill bundle contains numerous hardcoded absolute paths to a specific user's directory (C:\Users\Roken\...) across multiple files, including init_bora_context.py, auto_recall.py, and tests/test_tokensaver.py. It specifically targets and ingests sensitive workspace files like SOUL.md, IDENTITY.md, and USER.md into its own local storage. While the core logic for token saving via text compression appears functional and lacks clear exfiltration code, the hardcoded environment and the ingestion of private agent data without generalization are significant red flags for a shared skill.
Capability Assessment
Purpose & Capability
The name/description (TokenSaver / Korean context DB with multi-level compression) aligns with the included code: tokenizers, compressors, context store, search, export/import, auto-sync. However multiple files contain hard-coded developer paths (e.g., C:\Users\Roken\.openclaw\workspace\_auai-engine\openviking-korean) and a HANDOVER.md entry pointing at `.secrets/clawhub_token.txt`. Those are residual dev artifacts that don't belong in a clean published package and may cause the code to attempt to access the packager's local paths on import or when running convenience scripts.
Instruction Scope
SKILL.md advertises automatic sync/heartbeat behavior but does not clearly warn that runtime modules (AutoSync, create_auto_sync, index_workspace, init_bora_context.py, daily_summary.py, auto_recall.py) will read many local files (MEMORY.md, USER.md, AGENTS.md, memory/*.md, context-summary.md) under the workspace (~/.openclaw/workspace by default) and may create cache files there. Several convenience scripts also open absolute Windows paths. This means installing/using the skill (or running its auto-sync/heartbeat) can scan or read user workspace files and write cache/summary files — behavior that is relevant to a context DB but is not explicitly highlighted or gated in the SKILL.md.
Install Mechanism
There is no install spec in the registry (instruction-only SKILL.md). The README/SKILL.md suggests pip install tokensaver but the package here is included as code files; no remote downloads, no brew/npm installs, and no extract-from-URL steps are present in the provided manifest. From an installation-risk POV this is lower-risk than remote installers, but you still need to review bundled code before running.
Credentials
The skill declares no required environment variables or credentials, which fits its function. However, repository files (HANDOVER.md, context.md, init scripts) reference a ClawHub token file path and other project-local secret paths. The code will read and write files under home/workspace directories (e.g., ~/.openviking, ~/.openclaw/workspace). While not requesting cloud credentials, references to secret file paths and use of workspace content means sensitive data could be read if those files exist — the skill does not explicitly request or justify access to those secrets in SKILL.md.
Persistence & Privilege
The skill does not request 'always: true' and does not modify other skills. It will create directories and files under user home/workspace (cache files, context JSON, export files). Auto-sync/heartbeat functionality implies periodic reads/writes to the workspace and saving caches (e.g., ~/.openclaw/.openviking/sync_cache.json, context summaries). Writing to user home/workspace is within the expected scope for a local context DB but is a persistence and privacy consideration the user should be aware of.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install openviking-korean
  3. After installation, invoke the skill by name or use /openviking-korean
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v3.1.0
v3.1: 한영겸용 지원 + Async + orjson + LRU
v1.4.0
WAL 프로토콜, SESSION-STATE, 엔티티 추출 추가 (elite-longterm-memory + smart-memory에서 이식)
v1.3.0
중복제거, 가중치검색, 자동카테고리, 자동요약, 버전백업 추가
v1.2.0
영어 지원 추가 (다국어 토크나이저), 언어 자동 감지, nltk 영어 불용어 처리
v1.1.0
캐싱 시스템 추가 (TTL 5분), 에러 처리 강화, 손상된 파일 스킵
v2.0.1
마케팅 카피로 설명 개선, 1개월 무료 체험 추가
v2.0.0
v2.0: 벡터 검색, 형태소 분석 개선, 자동 동기화 추가
v1.0.4
예시 일반화 - 특정 브랜드 내용 제거
v1.0.3
설명 대폭 개선! 장단점, 사용 사례, 비용 절약 예시 추가. 한국어 특화 기능 설명 강화.
v1.0.2
토큰 96% 절감! Cron 자동화 추가. 사용법 개선.
v1.0.1
설치 간편화! pip install만으로 작동. 토큰 72% 절감. Windows/Mac/Linux 모두 지원.
v1.0.0
Initial release - Korean Context DB for AI Agents, 91% token saving
Metadata
Slug openviking-korean
Version 3.1.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 12
Frequently Asked Questions

What is TokenSaver?

한국어에 최적화된 OpenViking 기반 컨텍스트 DB로 토큰 91% 절감, 계층 구조 메모리 관리 및 자동 압축 기능을 제공합니다. It is an AI Agent Skill for Claude Code / OpenClaw, with 380 downloads so far.

How do I install TokenSaver?

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

Is TokenSaver free?

Yes, TokenSaver is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does TokenSaver support?

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

Who created TokenSaver?

It is built and maintained by dorongss (@dorongss); the current version is v3.1.0.

💬 Comments