← 返回 Skills 市场
OpenViking Light
作者
melonbanjing
· GitHub ↗
· v1.0.0
· MIT-0
102
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install openviking-light
功能描述
轻量级 RAG 知识库 — 基于 BM25 全文检索 + MiniMax LLM 生成回答。 纯本地 Python 实现,无需 embedding API,不需要下载模型。 触发:用户问"你记得之前..."、"查一下之前..."、"关于...的知识"等需要检索记忆的问题。
安全使用建议
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.
功能分析
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.
能力评估
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.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install openviking-light - 安装完成后,直接呼叫该 Skill 的名称或使用
/openviking-light触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release: BM25 + MiniMax LLM RAG knowledge base
元数据
常见问题
OpenViking Light 是什么?
轻量级 RAG 知识库 — 基于 BM25 全文检索 + MiniMax LLM 生成回答。 纯本地 Python 实现,无需 embedding API,不需要下载模型。 触发:用户问"你记得之前..."、"查一下之前..."、"关于...的知识"等需要检索记忆的问题。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 102 次。
如何安装 OpenViking Light?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install openviking-light」即可一键安装,无需额外配置。
OpenViking Light 是免费的吗?
是的,OpenViking Light 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
OpenViking Light 支持哪些平台?
OpenViking Light 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 OpenViking Light?
由 melonbanjing(@melonbanjing)开发并维护,当前版本 v1.0.0。
推荐 Skills