名称： graphiti
描述： 通过 Graphiti API 进行知识图谱操作。搜索事实、添加事件、提取实体与关系。
主页： https://github.com/getzep/graphiti
元数据： {"clawdbot":{"emoji":"🕸️","requires":{"services":["neo4j","qdrant","graphiti"]},"install":[{"id":"docker","kind":"docker-compose","label":"安装 Graphiti 技术栈 (Docker)"}]}}

Graphiti 知识图谱

使用 Graphiti 的 REST API 动态查询和管理知识图谱，支持服务自动发现。

前提条件

• Neo4j 数据库（图存储）
• Qdrant（向量搜索）
• Graphiti 服务已运行（默认地址：http://localhost:8001）

工具

graphiti_search

在知识图谱中搜索相关事实。

用法：

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

graphiti_add

向知识图谱添加新事件/记忆。

用法：

bash command:"
GRAPHITI_URL=\$({baseDir}/references/env-check.sh)
curl -s -X POST \"\$GRAPHITI_URL/messages\" \
  -H 'Content-Type: application/json' \
  -d '{\"name\": \"EPISODE_NAME\", \"content\": \"EPISODE_CONTENT\"}' | jq .
"

动态配置

本技能通过环境发现自动定位 Graphiti 服务，优先级如下：

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

如需修改 Graphiti 地址：

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

示例

搜索信息：

bash command:"
GRAPHITI_URL=\$({baseDir}/references/env-check.sh)
curl -s -X POST \"\$GRAPHITI_URL/facts/search\" \
  -H 'Content-Type: application/json' \
  -d '{\"query\": \"Tell me about Essam Masoudy\", \"max_facts\": 5}'
"

添加记忆：

bash command:"
GRAPHITI_URL=\$({baseDir}/references/env-check.sh)
curl -s -X POST \"\$GRAPHITI_URL/messages\" \
  -H 'Content-Type: application/json' \
  -d '{\"name\": \"Project Update\", \"content\": \"Completed Phase 1 of Clawdbot integration\"}'
"