核心用法
clawsqlite-knowledge 是一个轻量级的 wrapper skill，封装了 PyPI 发布的 clawsqlite CLI 工具，提供知识库摄取、搜索、展示和维护的完整工作流。
安装与初始化
- 安装后需运行
bootstrap_deps.sh从 PyPI 安装clawsqlite包 - 使用
bin/clawsqlite作为稳定入口（非全局 PATH） - 知识库数据存储在
~/.openclaw/workspace/data/clawsqlite-knowledge/default/，通过./clawsqlite.toml配置
三大命令树
record: 摄取（ingest）、搜索（search）、展示（show）maintenance: 初始化配置（init-config）、健康检查（doctor）、重新索引（reindex）、清理（cleanup）、备份（backup）analysis: 兴趣聚类（build-interest-clusters）、兴趣报告（report-interest）
典型工作流
1. URL 摄取：knowledge record ingest --url <URL> --category <类型>
2. 混合搜索：knowledge record search <query> --mode hybrid --topk 5
3. 完整展示：knowledge record show --id <ID> --full
4. 维护验证：knowledge maintenance doctor --json
显著优点
- 官方 CLI 直通：不 vendor 源码、不二次封装 API，完全复用官方命令树
- 严格的配置管理：强制单文件配置（
clawsqlite.toml），拒绝环境变量和猜测路径 - 降级模式可控：支持
--gen-provider off等降级参数，但需用户显式声明 - JSON 输出友好：所有命令支持
--json，便于程序化解析 - 实例化隔离：支持多知识库实例，数据与配置分离于 skill 目录
潜在缺点与局限
- 依赖外部 bootstrap：技能本身仅为 wrapper，需额外运行脚本安装核心依赖，网络失败则不可用
- Python 环境依赖：要求 managed Python 环境可能无法暴露全局命令，需使用 skill-local 路径
- 功能边界受限：严格限定为 CLI wrapper，无法扩展或自定义
clawsqlite内部逻辑 - 无内置 LLM/Embedding：依赖外部 provider，需单独配置
--check-llm/--check-embedding验证 - 学习成本：三级命令树（
record/maintenance/analysis）较复杂，旧版 flat 命令已废弃
适合人群
- 需要本地化 SQLite 知识库的开发者与技术用户
- 偏好 CLI 工作流、习惯脚本化知识管理的自动化用户
- 已熟悉
clawsqlite生态、需要多实例隔离的高级用户 - 对数据主权有要求、不愿依赖云端知识库服务的隐私敏感用户
常规风险
- bootstrap 失败风险：PyPI 网络不稳定或依赖冲突可能导致安装中断
- 配置漂移风险：未遵循"单文件配置"原则可能导致运行时错误
- 降级功能误用：显式降级参数（如
--allow-heuristic）可能降低数据质量，需用户自担风险 - 路径硬编码依赖：脚本中大量使用
<workspace>占位符，环境迁移时需重新适配