Graphiti知识图谱操作

技能简介

Graphiti技能通过REST API连接Graphiti服务，支持对知识图谱进行事实搜索、添加记忆片段、提取实体与关系等操作。该技能采用动态服务发现机制，自动识别Neo4j图数据库和Qdrant向量存储的部署位置。

业务背景

Graphiti技能帮助企业快速构建智能知识管理体系。业务人员无需技术背景，即可通过自然语言搜索沉淀在图谱中的经验与数据，自动关联分散信息形成洞察。支持持续追加新记忆片段，让组织知识随业务运转动态生长，解决"信息孤岛"和"知识流失"痛点。

落地案例：某产品团队使用Graphiti管理用户反馈：客服录入一段投诉语音转写的文本，系统自动提取"支付失败""iOS端"等实体及关联关系；后续产品经理搜索"近期高频问题"，图谱返回相关事实并按语义相似度排序，快速定位需优先修复的Bug，避免翻阅大量原始记录。

能做什么

• 搜索知识图谱中的相关事实与信息
• 向图谱添加新的记忆片段（episode）
• 自动提取文本中的实体和关系
• 通过向量检索实现语义相似度匹配

使用说明

安装部署

需预先部署以下服务栈：

1. Neo4j数据库（图数据存储）
2. Qdrant（向量搜索引擎）
3. Graphiti服务（默认端口8001）

推荐使用Docker Compose一键安装：

docker-compose up -d neo4j qdrant graphiti

服务地址配置

技能按以下优先级自动发现Graphiti服务：

1. Clawdbot配置：clawdbot config get skills.graphiti.baseUrl
2. 环境变量：$GRAPHITI_URL
3. 默认回退：http://localhost:8001

手动设置地址：

export GRAPHITI_URL="http://10.0.0.10:8001"
# 或
clawdbot config set skills.graphiti.baseUrl "http://10.0.0.10:8001"

搜索事实

GRAPHITI_URL=$({baseDir}/references/env-check.sh)
curl -s -X POST "$GRAPHITI_URL/facts/search" \
  -H 'Content-Type: application/json' \
  -d '{"query": "查询内容", "max_facts": 10}' | jq .

添加记忆

GRAPHITI_URL=$({baseDir}/references/env-check.sh)
curl -s -X POST "$GRAPHITI_URL/messages" \
  -H 'Content-Type: application/json' \
  -d '{"name": "记忆名称", "content": "记忆内容"}' | jq .

输入与输出

见下方输入与输出表格。

风险提示

• 需确保Neo4j和Qdrant服务已正常启动，否则API调用将失败
• 环境变量配置错误会导致服务发现失败
• 大规模数据写入前建议测试单条记录
• 生产环境应配置服务认证机制

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/emasoudy/graphiti/SKILL.md
来源类型：GitHub仓库