Knowledge Graph

Maintain Clawdbot's compounding knowledge graph under life/areas/** by adding/superseding atomic facts (items.json), regenerating entity summaries (summary.md), and keeping IDs consistent. Use when you need deterministic updates to the knowledge graph rather than manual JSON edits.

Audits

Pass

ClawScanPass

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install knowledge-graph

Knowledge Graph (file-based)

Use the bundled Python script to safely update life/areas/**.

Commands

Add a new fact:

python3 skills/knowledge-graph/scripts/kg.py add \
  --entity people/safa \
  --category status \
  --fact "Runs Clawdbot on a Raspberry Pi" \
  --source conversation

Supersede an old fact (mark old as superseded + create new fact):

python3 skills/knowledge-graph/scripts/kg.py supersede \
  --entity people/safa \
  --old safa-002 \
  --category status \
  --fact "Moved Clawdbot from Pi to a Mac mini"

Regenerate an entity summary from active facts:

python3 skills/knowledge-graph/scripts/kg.py summarize --entity people/safa

Notes

Entities live under: life/areas/<kind>/<slug>/
Facts live in items.json (array). Summaries live in summary.md.
IDs auto-increment per entity: <slug>-001, <slug>-002, ...
Never delete facts; supersede them.