Graphiti Knowledge Graph

Query and manage your knowledge graph using Graphiti's REST API with dynamic service discovery.

Prerequisites

• Neo4j database (graph storage)
• Qdrant (vector search)
• Graphiti service running (default: http://localhost:8001)

Tools

graphiti_search

Search the knowledge graph for relevant facts.

Usage:

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

Add a new episode/memory to the knowledge graph.

Usage:

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 .
"

Dynamic Configuration

The skill uses environment discovery to find Graphiti automatically:

1. Clawdbot config: clawdbot config get skills.graphiti.baseUrl
2. Environment variable: $GRAPHITI_URL
3. Default fallback: http://localhost:8001

To change the Graphiti URL:

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

Examples

Search for information:

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}'
"

Add a memory:

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"}'
"