Graphiti

emasoudy/graphiti

Installation

clawhub install emasoudy/graphiti

Summary

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

SKILL.md

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

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

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:

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

To change the Graphiti URL:

bash

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

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

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