核心用法
Graphiti 技能提供知识图谱的查询与管理能力，通过 REST API 与本地部署的 Graphiti 服务交互。主要功能包括：
1. 事实搜索（graphiti_search）：使用自然语言查询知识图谱，检索相关实体、关系及事实，支持设置返回结果数量（max_facts）。
2. 记忆添加（graphiti_add）：将新的对话片段或信息以"episode"形式写入图谱，系统自动提取实体与关系，实现知识的持续积累。
3. 动态服务发现：通过三级配置机制（clawdbot config → 环境变量 → 默认地址）自动定位 Graphiti 服务，无需硬编码地址。
显著优点
- 完全本地化：数据仅在内网传输（默认 localhost），不上传至任何第三方服务器，隐私可控性极强。
- 架构清晰：基于成熟的 Graphiti（Zep 开源项目）+ Neo4j（图存储）+ Qdrant（向量检索）技术栈，扩展性强。
- 零代码侵入：纯 curl API 调用，无复杂依赖，与现有系统易于集成。
- 配置灵活：支持环境变量与配置文件双模式，适配开发、测试、生产多环境。
潜在缺点与局限性
- 部署门槛高：需自行搭建 Neo4j、Qdrant、Graphiti 三个服务，对运维能力有要求。
- 来源可信度有限：当前为个人开发者维护（T3），非 Getzep 官方直接背书。
- 功能边界明确：仅覆盖搜索与添加两类操作，不支持图谱可视化、复杂查询语言（如 Cypher）直接执行。
- 网络依赖：虽为本地服务，但仍需确保服务健康，否则操作将失败。
适合的目标群体
- 需要私有化知识管理的企业技术团队
- 研究记忆增强型 AI 应用的开发者
- 已使用或计划采用 Graphiti/Zep 作为记忆层的项目
- 对数据主权敏感、拒绝 SaaS 化方案的用户
使用风险
- 服务可用性风险：三组件任一故障将导致技能不可用，需建立监控与备份机制。
- 配置错误风险：若错误配置 GRAPHITI_URL 指向不可信服务，可能导致数据泄露。
- 版本兼容性：Graphiti API 若升级，技能可能需要同步更新。
- 无内置加密：默认 HTTP 通信，跨网络部署需自行配置 TLS。