Knowledge Base with Faiss and Bailian (embedding and rerank)
v1.0.0使用 Python、FAISS、MarkItDown、阿里云百炼 text-embedding-v4 与可选的 qwen3-rerank，维护基于文件目录的本地知识库；适用于文件转 Markdown、遍历 chunks 与 T2Q 建立索引，以及对指定知识库或全部知识库做语义查询。
⭐ 0· 19·0 current·0 all-time
by@kadbbz
MIT-0
Download zip
LicenseMIT-0 · Free to use, modify, and redistribute. No attribution required.
Security Scan
OpenClaw
Benign
high confidencePurpose & Capability
Name/description, declared primary credential (BAILIAN_SK), required binary (python3), requirements.txt (faiss-cpu, markitdown, numpy, requests), and the included Python script all align with a local FAISS-based knowledge base that calls Bailian embedding/rerank APIs. No unrelated cloud credentials or unexpected binaries are requested.
Instruction Scope
The SKILL.md and script confine operations to the configured KB root (default /var/openclaw-kb) and only send chunk and T2Q text to the declared Aliyun endpoints. The script loads the Bailian key from BAILIAN_SK (or BAILIAN-SK) and uses requests to POST embeddings/rerank requests. Minor note: the MarkItDown conversion library may depend on optional external converters (depending on the 'markitdown[all]' extras), which could invoke native utilities; the skill claims it "does not execute shell", but indirect execution via third-party conversion tools is possible depending on installed markitdown backends.
Install Mechanism
There is no automatic install spec (instruction-only install). The README instructs installing Python packages via pip -r requirements.txt. Required packages are from common registries; no arbitrary remote binary downloads or extract steps are present in the bundle.
Credentials
Only one credential is declared (primaryEnv: BAILIAN_SK) and the script only reads BAILIAN_SK or BAILIAN-SK. No other environment variables, unrelated secrets, or config paths are requested. The embedding/rerank calls legitimately require an API key.
Persistence & Privilege
The skill does not request always:true and is not declared to modify other skills or agent-wide settings. It reads/writes only under the KB directory and writes per-kb config/manifest/index files as expected.
Assessment
This skill appears coherent for building and querying a local FAISS knowledge base using Aliyun Bailian embeddings and optional rerank. Before installing: 1) Be aware that all chunk text and T2Q text will be sent to the Bailian endpoints (provide only non-sensitive text or use an environment with acceptable data handling). 2) You must supply a Bailian API key in BAILIAN_SK (or BAILIAN-SK). 3) The markitdown[all] extra can pull in converters that may rely on native binaries (pandoc/unoconv/etc.); if you need strict 'no external execution' guarantees, audit or restrict those converters. 4) The package requires faiss-cpu and numpy (native/compiled deps) — install in a controlled environment. 5) Ensure the KB root (/var/openclaw-kb by default) is an appropriate, isolated directory and that you are comfortable the skill will read/write all files under KB subdirectories.Like a lobster shell, security has layers — review code before you run it.
latestvk973av00nwhg7qt77xxe3hwvqx84kp4c
License
MIT-0
Free to use, modify, and redistribute. No attribution required.
Runtime requirements
Binspython3
Primary envBAILIAN_SK