← Back to Skills Marketplace
melonbanjing

OpenViking Light

by melonbanjing · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
102
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install openviking-light
Description
轻量级 RAG 知识库 — 基于 BM25 全文检索 + MiniMax LLM 生成回答。 纯本地 Python 实现,无需 embedding API,不需要下载模型。 触发:用户问"你记得之前..."、"查一下之前..."、"关于...的知识"等需要检索记忆的问题。
Usage Guidance
This skill implements local BM25 retrieval but uses a remote MiniMax chat API for generation. Before installing: (1) expect to provide MINIMAX_API_KEY (not declared in metadata) — queries and retrieved context will be sent to the configured MINIMAX_API_HOST; do not store sensitive secrets or private data in the skill's JSON store unless you trust that endpoint. (2) The scripts auto-install 'jieba' via pip at runtime — consider pre-installing dependencies in a controlled environment. (3) If you want a truly offline solution, remove or modify the chat() calls to use a local model instead. (4) Ask the publisher to update the skill metadata to declare required environment variables and to document the network call to the MiniMax endpoint. If you don't trust the MiniMax provider or cannot provide a dedicated API key with limited scope, treat the generation feature as risky and use search-only commands instead.
Capability Analysis
Type: OpenClaw Skill Name: openviking-light Version: 1.0.0 The skill implements a local RAG (Retrieval-Augmented Generation) system using the BM25 algorithm and the MiniMax LLM. It is classified as suspicious because multiple files (ask.py, bm25.py, and search.py) use os.system to automatically install the 'jieba' library if it is missing. While this is likely intended for user convenience, programmatically executing shell commands to modify the environment is a high-risk behavior that could be exploited. The code also makes external network requests to the MiniMax API (api.minimaxi.com), which is consistent with its stated purpose, and no evidence of data exfiltration or intentional malice was found.
Capability Assessment
Purpose & Capability
The README/SKILL.md emphasizes '纯本地' retrieval and '无需 embedding API', which is true for retrieval, but both ask.py and bm25.py call a remote MiniMax chat API and require MINIMAX_API_KEY/MINIMAX_API_HOST. The registry metadata lists no required environment variables or credentials, which contradicts the code. Requiring an external LLM API is plausible for generation but should be declared.
Instruction Scope
Runtime instructions and scripts operate on a local data path (~/.openviking/light/data/bm25_store.json) and implement BM25 search and CLI for add/search/ask. The ask/ask.py and bm25.py build prompts from retrieved content and POST it to the configured MiniMax endpoint; they do not access unrelated system paths. However, prompts and retrieved content are sent to an external host, so any sensitive content stored in the local JSON would be transmitted.
Install Mechanism
There is no formal install spec (instruction-only). At runtime the scripts attempt to auto-install 'jieba' via os.system pip calls if missing. Auto-installing packages at runtime is common but increases attack surface (network fetch + executing whatever is on PyPI) and should be disclosed and controlled.
Credentials
The skill files require MINIMAX_API_KEY and optionally MINIMAX_API_HOST, but the skill metadata declared no required env vars or primary credential. This is a direct mismatch. The number of secrets is small and appropriate for an LLM-backed generator, but they must be declared and the user informed that queries/contexts will be sent to the external MiniMax host.
Persistence & Privilege
The skill does not request always:true, does not modify other skills or system-wide settings, and only writes to its own data directory under the user's home. No elevated privileges are requested.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install openviking-light
  3. After installation, invoke the skill by name or use /openviking-light
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: BM25 + MiniMax LLM RAG knowledge base
Metadata
Slug openviking-light
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is OpenViking Light?

轻量级 RAG 知识库 — 基于 BM25 全文检索 + MiniMax LLM 生成回答。 纯本地 Python 实现,无需 embedding API,不需要下载模型。 触发:用户问"你记得之前..."、"查一下之前..."、"关于...的知识"等需要检索记忆的问题。 It is an AI Agent Skill for Claude Code / OpenClaw, with 102 downloads so far.

How do I install OpenViking Light?

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

Is OpenViking Light free?

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

Which platforms does OpenViking Light support?

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

Who created OpenViking Light?

It is built and maintained by melonbanjing (@melonbanjing); the current version is v1.0.0.

💬 Comments