CyClaw：面向本地文档的安全离线优先 RAG 智能体

cgfixit/CyClaw · CyClaw is a secure, offline-first local AI agent built on three invariants: RAG-first retrieval, LangGraph topology as security policy - https://bit.ly/CyClaw-Demo

GitHub原文发布未知首次收录 2026-10-04上架 2026-10-08 07:06

☆ 收藏查看项目 ↗

ELI5：它是什么，解决什么问题

CyClaw 是基于 Python 的离线优先本地 AI 智能体，核心是在自有硬件上对 Markdown 与 .txt 文档进行检索增强生成。它以 12 节点 LangGraph 构建检索优先流程，所有路径最终汇入审计日志；本地嵌入、BM25 与交叉编码器在 CPU 上运行，仅在选择付费 Grok 或 Claude 回退且用户逐次确认时才发起外部调用。项目提供 FastAPI 网关（绑定 127.0.0.1:8787）、soul 治理、审计与花费台账、可选的按用户认证、记忆、NeMo 护栏、连接器与 Telegram/X 通道等分层能力，并声明其适用场景为一个受信运营者或互信小组，不提供租户隔离。

# MCP # 审计 # agentic-rag # 本地向量检索 # 离线优先

核心能力与快速开始

★ 6 · Python

能做什么: 提供离线优先的本地 RAG 问答：从 Markdown 和 .txt 文档检索后生成答案。检索侧融合 ChromaDB 与 BM25（RRF 融合），交叉编码器以 shadow 模式运行；本地生成通过 Ollama（默认 qwen3.8:27b-mlx），嵌入与重排模型需提前缓存方可离线使用。12 节点 LangGraph 以检索为起点，所有路径汇聚到审计日志。支持 soul 人格文件的 SHA-256 漂移检测与原子写入，soul 变更需人工 reason 并经过注入扫描。外部回退仅在 hybrid 模式、对应提供方启用且用户逐次确认时可用（Grok 或 Claude），并受端点信任检查约束。提供审计哈希记录、花费台账与 cyclaw-metrics 离线统计、确定性护栏（可选 NeMo 包增强）、可选按用户认证、可选记忆、可选连接器（文件系统、只读 SQL、被动 LAN 盘点）、可选 agentic loop、Telegram / OpenTweet 通道、通过 MCP 暴露仅检索能力。FastAPI 网关提供浏览器控制台 /。
适用场景: 适合在自有硬件上基于个人或小组文档库进行私密问答，并希望保留审计与花费记录的场景。适合需要检索优先、结果可审计、外部付费调用需逐次确认的受控环境。适合作为研究或搭建本地 RAG 智能体（LangGraph 拓扑、检索融合、护栏与审计）的参考实现。
项目形态: 可直接使用的工具
部署方式: 本地部署，网关绑定 127.0.0.1:8787，Ollama 默认 127.0.0.1:11434；提供 macOS（Apple Silicon）、Linux、Windows 安装路径与 Docker（GHCR 镜像目标 linux/amd64）。
主要依赖: Python 3.12（>=3.12,<3.13）；依赖 FastAPI、LangGraph；本地 Ollama 提供生成模型；检索模型需缓存以支持离线；可选 NeMo、Postgres（pgvector）等。须绑定回环地址使用。
使用限制: 不提供租户隔离，也不提供 microVM。仅服务一个受信运营者或互信小组。输出护栏为 token 重叠启发式，不验证单个事实性声明。部分可选层（认证、记忆、连接器、agentic loop、Telegram/X 通道）默认关闭。许可证状态为 NOASSERTION，未说明可商用或免费。速率限制等行为需按配置说明确认。
许可证: NOASSERTION
最近推送: 2026-10-04 06:57

官方入门项目文档核对 README 依据 ↗

资料检查：2026-10-04 07:00 · 卡片整理：2026-10-08 07:00
卡片由 AI 根据仓库资料整理，未进行安装或运行验证 · 本次更新未完成，保留上次成功内容

职业应用

程序员

在自有硬件上对本地 Markdown 与 .txt 技术文档做检索增强问答，用于查阅项目文档；可选 agentic 层提供 GitHub 上下文与 clone/plan/patch/verify 流程（默认关闭）。

查看内容依据

CyClaw retrieves Markdown and `.txt` documents before generation.

官方使用入口 ↗

由 AI 根据来源材料整理，未进行安装或运行验证

产品经理

将本地 Markdown/.txt 格式的需求或调研文档作为语料，离线检索并生成带审计记录的答案，用于内部资料问答。

查看内容依据

CyClaw answers questions from **your documents on your hardware**.

官方使用入口 ↗

由 AI 根据来源材料整理，未进行安装或运行验证

相似资源

MemoryMap AI：本地优先的自动归档 AI 笔记应用

MemoryMap AI 是一款本地优先的 AI 笔记应用，输入一条想法后，由本地大模型自动完成分类、打标签和笔记间关联，后续提问时能给出带引用来源的回答。所有数据保存在本机的一个 SQLite 文件中，可通过 Ollama 或任何本地 OpenAI 兼容服务器运行模型；在没有模型的情况下仍能依靠笔记自身词汇进行归档和搜索。应用还提供文档、白板、思维导图、关系图谱、时间线与提醒等功能，并包含面向小模型的逐步操作模式与带工具调用的 Agent 模式。

SyntaxRAG：面向 AI 代理的本地代码检索 MCP 引擎

SyntaxRAG（SYNRAG）是一个本地代码搜索 MCP 引擎，通过 Tree-sitter 按函数、类、类型等 AST 结构切分代码，在 CPU 上用 FlashRank（TinyBERT）对 BM25 候选重排序，并构建依赖影响图。它提供搜索、文件大纲、仓库地图、影响范围分析、测试定位及受控编辑等工具，以减少 AI 代理定位代码时的 token 消耗；附带安装脚本、CLI、可选的变更监视服务和 Gemini 相关可选功能。

Brito：带代码知识图谱与可审核技能的终端编码智能体

Brito 是一个面向软件开发的编码智能体，提供命令行工具 brito-cli 和 macOS/Windows/Linux 桌面应用。它不依赖逐文件 grep 阅读，而是用 tree-sitter 增量索引构建代码知识图谱（符号、调用、导入），支持 TypeScript/JavaScript、Python、Svelte/Vue/Astro 组件及多种后端语言，可通过 graph_search、graph_callers、graph_impact 等工具快速回答“改这里会影响什么”。它还会保存记忆笔记，并在任务完成后反思生成项目技能，新技能先进入试用期，经多次成功使用后转正，涉及危险命令或修改已批准技能时需用户审批，并提供隐私检查（如拒绝密钥、curl | sh 等）与手动/自动编辑/计划/全允许等权限模式。支持 Anthropic API 或 Claude Code 订阅作为后端，也可接入 OpenAI 兼容端点，并可作为 MCP 服务器向其他客户端暴露图谱、记忆与技能。

Vybe Intelligence Vault：面向 AI Agent 与 RAG 工程的开源知识图谱

Vybe Intelligence Vault 是一个自更新的开源知识仓库，索引 AI Agent、RAG、MCP 服务器、提示词、工具和模板等前沿资料，并宣称通过采集管线、LLM 评估和向量关系构建语义知识图谱。项目提供 MCP 网关供 Claude Desktop、Cursor 等 Agent 直接查询节点上下文，还包含基于 React Three Fiber 和 WebGL 的 3D 知识图谱浏览界面，以及若干 7 天工程学习路径与生产蓝图。

这是基于来源内容整理的摘要。原文链接失效后，本页摘要和讨论仍会保留。