clawrag

🧠 自托管隐私知识库与智能检索

基于 ClawRAG 开源项目的本地知识库连接器,通过 Docker 自托管实现数据完全本地化的隐私保护型 RAG 检索方案。

收藏
4.3k
安装
1.1k
版本
1.2.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

ClawRAG Connector 是一款面向 OpenClaw 用户的自托管 RAG(检索增强生成)连接工具,旨在通过本地部署实现完全的数据隐私保护。该 Skill 本身为纯文档型资产,提供了将 OpenClaw 连接至本地 ClawRAG 实例的完整部署指南,使用户能够在本地 Docker 环境中构建私有知识库。

核心用法方面,用户需通过 Docker Compose 在本地启动 ClawRAG 服务(基于 ChromaDB 向量数据库),随后通过 MCP 协议将 OpenClaw 与该本地服务连接。Skill 支持混合搜索模式,结合向量相似度与 BM25 关键词匹配,可处理 PDF、Word、Markdown 等多种文档格式,并为所有回答提供可追溯的引用来源。用户可通过 API 或文件夹方式批量导入文档,并按项目组织多集合知识库。

显著优点在于其隐私优先的设计理念。所有数据(包括向量化和文档内容)均保留在本地 Docker 环境中,无需上传至第三方云服务,特别适合处理敏感信息。混合搜索架构提升了检索精度,而 MCP-native 设计确保了与 OpenClaw 的无缝集成。此外,开源特性允许用户审查和定制底层代码。

然而,该 Skill 存在若干局限性。首先,部署门槛较高,要求用户具备 Docker 操作经验及至少 4GB RAM(推荐 8GB),对非技术用户不够友好。其次,作为 T3 来源的个人开源项目,长期维护稳定性和企业级支持存在不确定性。再者,虽然 Skill 本身安全,但依赖外部 GitHub 仓库和 npm 包(@clawrag/mcp-server),存在潜在的供应链安全风险。

适合目标群体包括:注重数据隐私的技术从业者、需要在本地环境搭建知识库的 OpenClaw 用户、以及对 RAG 技术有基础了解并具备 Docker 环境的管理员。特别适合处理机密文档且不希望数据离开本地网络的企业或个人。

使用风险主要包括:外部依赖的安全审查责任转移至用户,需自行验证 ClawRAG 项目及 MCP Server 包的代码安全性;Docker 环境的配置复杂性可能导致部署失败;本地 LLM 运行对硬件资源要求较高,若使用云 LLM API 则需注意密钥管理安全。建议在生产环境使用前进行充分的安全审计。

安全解读

核心用法

ClawRAG Connector 是一款纯文档型 Skill,作为 OpenClaw 与本地 ClawRAG 实例之间的 MCP 桥梁。用户需先通过 Docker 部署 ClawRAG 服务(含 ChromaDB 向量数据库),再通过 npx @clawrag/mcp-server 完成 MCP 接入。Skill 本身无可执行代码,仅提供标准化的安装指引、架构说明和验证命令,支持 PDF、DOCX、Markdown 等文档的本地向量化存储与混合检索(语义 + BM25 + RRF)。

显著优点

极致隐私架构:完全自托管设计,向量数据库与 LLM 推理均在本地运行,数据不出境,天然符合 GDPR 等隐私法规。

混合检索能力:支持语义相似度与关键词匹配(BM25)的融合排序(RRF),检索精准度优于纯向量方案。

零代码信任成本:T-MD 分类纯文档型 Skill,无可执行代码、无依赖文件,静态分析得分 95 分,杜绝供应链投毒风险。

MCP 原生集成:遵循 Model Context Protocol 标准,与 OpenClaw 无缝协作,无需额外权限申请。

潜在局限

基础设施门槛:强制依赖 Docker 与 4GB+ 内存(推荐 8GB),对无技术背景用户存在部署门槛。

本地运维负担:需自行维护 ChromaDB 数据、Docker 镜像更新及本地 API 端口安全策略,无托管 SaaS 的免运维优势。

T3 来源信任:维护者为个人开发者(2dogsandanerd),无企业背书,长期维护稳定性需社区观察。

适合人群

  • 对数据隐私高度敏感的企业/个人(法律、医疗、金融场景)
  • 具备 Docker 基础的技术团队
  • 需本地化知识库管理的 OpenClaw 深度用户

常规风险

  • Docker 供应链风险:上游镜像若遭篡改将直接影响本地安全,建议验证镜像签名与来源
  • 本地端口暴露风险:localhost:8080 需严格限制外部访问,防止本地 API 被局域网嗅探
  • 版本漂移风险:MCP Server 与 ClawRAG 后端版本需保持兼容,建议锁定版本或及时同步更新

clawrag 内容

手动下载zip · 1.7 kB
SKILL.mdtext/markdown
请选择文件