Kb Mini

Store, search, and automatically manage a personal or shared knowledge base integrated with OpenClaw through before/after hooks.

Knowledge Base Skill

Version: v1.2.0 Repository: https://github.com/ThomasLiu/knowledge-base-skill

---

触发条件

当用户提到以下关键词时触发：

• "加入知识库" / "存到 KB" / "存入知识库"
• "knowledge base" / "知识库" / "KB"
• "记得这个" / "保存上下文" / "记忆"
• "检索知识库" / "查一下 KB"

---

功能

1. Collect - 存储

bash

kb store --title "标题" --content "内容" --source "manual"

2. Retrieve - 检索

bash

kb search --query "关键词"
kb retrieve --topic-key "entry-key"

3. Recall - 对话前自动检索

在 before_agent_start hook 中自动调用，检索与当前对话相关的知识。

4. Capture - 对话后自动存储

在 after_turn hook 中自动调用，判断并存储重要内容。

---

使用方式

存储信息

text

用户: 把这个配置加入知识库
Agent: 使用 kb store 命令存储

检索信息

text

用户: 查一下知识库里关于 OpenClaw 的内容
Agent: 使用 kb search 查询并返回结果

---

脚本列表

脚本	功能
scripts/storage.sh	核心存储 API
scripts/retriever.sh	检索 + recall/capture
scripts/hooks.sh	OpenClaw Hooks 集成
scripts/lifecycle.sh	生命周期管理

依赖

• bash
• sqlite3
• python3

---

配置

默认模式（安装即用）

Skill 安装后默认使用自身目录存储，无需任何配置：

text

~/.openclaw/workspace/skills/kb-mini/data/knowledge.db

共享 KB 模式（多 Agent 共用）

多个 Agent 共用同一个知识库：

bash

# 在调用 skill 前设置
export KNOWLEDGE_SHARED_NAME="coding-kb"
# 实际路径: ~/.openclaw/shared/knowledge-bases/coding-kb/knowledge.db

显式路径模式

指定任意路径作为 KB：

bash

export KNOWLEDGE_DB="/path/to/your/knowledge.db"

环境变量优先级

优先级	变量	说明
1	KNOWLEDGE_DB	显式指定路径
2	KNOWLEDGE_SHARED_NAME	共享 KB 名称
3	Skill 内部目录	默认，安装即用

---

目录结构

text

kb-mini/
├── data/
│   └── knowledge.db      # 默认 KB 路径
├── scripts/
│   ├── storage.sh        # 存储 API
│   ├── retriever.sh      # 检索 API
│   ├── hooks.sh          # Hooks 集成
│   └── lifecycle.sh      # 生命周期
└── SKILL.md