← 返回 Skills 市场
mozi1924

LiteRAG

作者 Mozi Arasaka · GitHub ↗ · v0.2.2 · MIT-0
cross-platform ✓ 安全检测通过
95
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install literag
功能描述
Local retrieval skill for large documentation corpora using independent SQLite knowledge libraries with keyword plus vector hybrid search. Use when searching...
使用说明 (SKILL.md)

LiteRAG

Use this skill when the target corpus is too large or too noisy for main agent memory.

Install

Packaged dependency install:

python3 -m pip install -r {baseDir}/requirements.txt

Layout

  • Config + databases live under \x3Cworkspace>/.literag/
  • Main config: \x3Cworkspace>/.literag/knowledge-libs.json
  • Default workspace resolution order: OPENCLAW_WORKSPACE → WORKSPACE → walk upward from the current path until the OpenClaw workspace sentinel files are found
  • Core scripts live under skills/literag/scripts/
  • Skill bin entrypoint: skills/literag/bin/literag
  • Workspace convenience wrappers live at scripts/literag-query.py, scripts/literag-index.py, scripts/literag-status.py, scripts/literag-meta.py, and scripts/lq

Rules

  • Keep personal/work memory in OpenClaw builtin memory
  • Keep large external corpora in LiteRAG, not memory_search
  • Treat each knowledge base as an independent library with its own SQLite
  • Search first, inspect second
  • Prefer grouped document hits over raw chunk spam
  • Prefer source-relative paths when citing files back to the user
  • Use local OpenAI-compatible embeddings by default unless explicitly changed in config

Read these files when needed

  • Always read \x3Cworkspace>/.literag/knowledge-libs.json when targeting a library or changing config
  • Read references/usage.md when you need command examples, output schema, or the intended search → inspect workflow
  • Read references/configuration.md when adding libraries, source roots, excludes, chunking overrides, or ranking overrides
  • Read references/agent-prompts.md when another agent / ACP harness needs a ready-made LiteRAG prompt template
  • Read references/optimization-playbook.md when a specific library needs retrieval-quality tuning, ranking cleanup, or indexing-throughput tuning
  • Read scripts under skills/literag/scripts/ only when editing behavior or diagnosing bugs

Slash / user-invocable usage

When invoked as /literag ..., parse the remaining argument string as a subcommand.

Supported forms:

  • /literag search \x3Clibrary> \x3Cquery>
  • /literag inspect \x3Clibrary> \x3Cpath> [--start N --end N]
  • /literag index \x3Clibrary> [--limit-files N] [--embedding-batch-size N]
  • /literag index-all [--limit-files N] [--embedding-batch-size N]
  • /literag status \x3Clibrary>
  • /literag meta \x3Clibrary>
  • /literag benchmark \x3Clibrary> --query ...

If the user gives a natural-language request instead of a strict subcommand, translate it to the nearest supported operation instead of being pedantic.

Supported commands

  • index_library.py — index one library
  • index_all.py — index all configured libraries
  • search_library.py — grouped hybrid/fts/vector retrieval
  • inspect_result.py — expand a hit by file path + chunk range
  • status_library.py — show index health / compatibility / counts
  • meta_library.py — dump raw sqlite meta records
  • benchmark_library.py — benchmark hybrid/fts/vector latency + hit shape across fixed query sets
  • bin/literag — packaged CLI entrypoint for search / inspect / index / status / meta / benchmark
  • scripts/literag-query.py — query/search/inspect wrapper
  • scripts/literag-index.py — index wrapper for one library or all libraries
  • scripts/literag-status.py — status wrapper
  • scripts/literag-meta.py — meta wrapper
  • scripts/literag-benchmark.py — benchmark wrapper
  • scripts/lq — tiny shell alias for literag-query.py

Operating workflow

  1. Read \x3Cworkspace>/.literag/knowledge-libs.json
  2. Resolve the target library
  3. Run search_library.py for grouped retrieval
  4. If needed, run inspect_result.py on the top hit or chosen range
  5. For quick operator use, prefer scripts/literag-query.py or scripts/lq
  6. Use scripts/literag-index.py when you need a short indexing entrypoint
  7. Use scripts/literag-status.py before debugging weird retrieval or after config changes
  8. Use scripts/literag-meta.py when you need the raw stored metadata
  9. Use scripts/literag-benchmark.py or skills/literag/scripts/benchmark_library.py when you need repeatable retrieval latency / hit-shape comparisons
  10. Keep LiteRAG separate from builtin memory unless the user explicitly wants a durable summary copied into workspace memory

Current intent

Use LiteRAG for:

  • Blender manual + Blender Python reference
  • Future blog/article/site knowledge bases
  • Any large external docs where hybrid retrieval is needed without polluting builtin memory
安全使用建议
This skill appears to be what it says: a local SQLite-based hybrid search/indexer. Before installing/use: 1) Inspect <workspace>/.literag/knowledge-libs.json — it may contain an embedding.baseUrl and apiKey; ensure the endpoint is trusted (default is localhost) because document text will be sent there for embeddings. 2) Review the configured library 'paths' to confirm only the intended files will be indexed (the tool will read and store chunks from those paths). 3) Install requirements (sqlite-vec) in a controlled environment — it may require native extensions or a Python build with SQLite extension-loading support. 4) Be aware that the sqlite DBs and metadata live under <workspace>/.literag/ and should be protected if they contain sensitive content. If you want to avoid any network leakage, set embedding.baseUrl to a trusted local endpoint or disable vector embeddings in config.
功能分析
Type: OpenClaw Skill Name: literag Version: 0.2.2 The LiteRAG skill bundle is a legitimate implementation of a local Retrieval-Augmented Generation (RAG) system using SQLite with FTS5 and vector search capabilities. The code in 'literag_common.py' and associated scripts handles document indexing, chunking, and hybrid retrieval through standard OpenAI-compatible embedding endpoints (defaulting to localhost). No evidence of data exfiltration, malicious execution, or harmful prompt injection was found; the instructions in 'SKILL.md' and 'agent-prompts.md' are appropriately focused on guiding the agent to use the retrieval tools effectively for documentation queries.
能力标签
requires-oauth-token
能力评估
✓ Purpose & Capability
Name/description (local hybrid SQLite retrieval and indexing) match the included scripts and declared runtime needs. The only required binary is python3 and the code implements indexing, search, inspect, status, meta, and benchmark workflows that align with the stated purpose.
✓ Instruction Scope
SKILL.md and the scripts consistently instruct the agent to read workspace config (.literag/knowledge-libs.json), iterate configured source paths, and run local indexing/search scripts. This is expected for a local retrieval tool. Note: the indexer will read files under the configured library paths and will send texts to the configured embedding endpoint (embedding.baseUrl) during indexing/search, which is necessary for embedding-based retrieval.
✓ Install Mechanism
There is no automatic install spec; SKILL.md recommends running pip install -r requirements.txt. requirements.txt contains sqlite-vec (a native-backed package). No remote arbitrary downloads or URL/extract installs are present in the bundle. Installing sqlite-vec may require native build support or a Python+SQLite build that allows loading SQLite extensions—this is an expected but higher-footprint dependency for vector search.
ℹ Credentials
The skill declares no required env vars and reads only OPENCLAW_WORKSPACE / WORKSPACE / LITERAG_PYTHON for workspace resolution and preferred python. However, sensitive credentials (embedding.apiKey) are stored in the librag config (.literag/knowledge-libs.json) rather than environment variables; the skill will use that apiKey and the embedding.baseUrl to contact an embedding provider. This is proportionate for an indexer, but you should verify the config and endpoint are trusted before indexing.
✓ Persistence & Privilege
The skill is not always-enabled (always: false) and is user-invocable only. It does not request persistent platform privileges. It stores DBs/config under the workspace (.literag/) which is expected for a local indexer.
如何使用
  1. 确保已安装 OpenClaw（本地或 Docker 部署）
  2. 在对话框中输入安装命令：/install literag
  3. 安装完成后，直接呼叫该 Skill 的名称或使用 /literag 触发
  4. 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v0.2.2
Clarify workspace-relative .literag paths and document environment overrides used for workspace and Python resolution.
v0.2.1
Initial public release with sqlite-vec backend, packaged CLI, metadata, and docs.
元数据
Slug literag
版本 0.2.2
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 2
常见问题

LiteRAG 是什么？

Local retrieval skill for large documentation corpora using independent SQLite knowledge libraries with keyword plus vector hybrid search. Use when searching... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 95 次。

如何安装 LiteRAG？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install literag」即可一键安装，无需额外配置。

LiteRAG 是免费的吗？

是的，LiteRAG 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

LiteRAG 支持哪些平台？

LiteRAG 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 LiteRAG？

由 Mozi Arasaka（@mozi1924）开发并维护，当前版本 v0.2.2。

推荐 Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191113 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 留言讨论