What ships in the DB
Every v1.5+ release includes these workspace='openclaw' nodes out of the box:
| Table | Nodes | What's there |
|---|---|---|
| Soul | 4 | Prime Directive · Identity (placeholder) · Safety · Heartbeat Protocol |
| Memory | 2 | Principal (placeholder) · Infrastructure (placeholder) |
| AgentConfig | 9 | Every Session · Delegation · Safety · Heartbeats · Memory · TOON · Search Resilience · Schema Rules · Path Aliases |
| Tool | 21 | All standard OpenClaw tools · sessions_spawn=true |
| SkillCluster | 27 | Semantic skill groupings · first-class nodes with IN_CLUSTER edges |
These work out of the box. The placeholders tell you exactly what to fill in.
Verify the defaults loaded
cypher-shell "MATCH (s:Soul) WHERE s.workspace = 'openclaw' RETURN s.section, s.priority ORDER BY s.priority" cypher-shell "MATCH (a:AgentConfig) WHERE a.workspace = 'openclaw' RETURN a.key ORDER BY a.id"
You should see 4 Soul sections and 9 AgentConfig keys. If not, run python3 seed.py to seed them.
Update your Identity
The Identity soul node ships as a placeholder. Replace it with your agent's name and role:
cypher-shell "MATCH (s:Soul {id:'soul-openclaw-identity'})
SET s.content = 'Name: Aria | Role: DevOps automation agent | Emoji: 🛡️ | Workspace: openclaw'"Fill in your Principal and Infrastructure
These Memory nodes tell the agent who it works for and what environment it operates in.
# Principal — who you're helping cypher-shell "MATCH (m:OCMemory {id:'mem-openclaw-principal'}) SET m.content = 'Name: Alice | Timezone: America/Chicago | Channel: signal | UUID: uuid:...'" # Infrastructure — your environment facts cypher-shell "MATCH (m:OCMemory {id:'mem-openclaw-infrastructure'}) SET m.content = 'Neo4j: bolt://localhost:7687 | Python: python3 | Workspace: ~/.openclaw/workspace/'"
Add more Memory domains
Create additional memory nodes for any factual context your agent needs:
cypher-shell "CREATE (m:OCMemory {
id: 'mem-openclaw-api-keys',
workspace: 'openclaw',
domain: 'API Keys',
content: 'Brave Search: \$BRAVE_API_KEY | xAI: \$XAI_API_KEY (env vars in shell profile)',
timestamp: '2026-01-01'
})"Store API keys as environment variable references, not raw values. The agent reads them from the shell at runtime.
Restrict or expand tools
Disable tools to create a restricted agent, or re-enable them for a capable one:
# Disable sub-agent delegation for a restricted agent cypher-shell "MATCH (t:OCTool {id:'tool-sessions-spawn'}) SET t.available = false, t.notes = 'BLOCKED — standalone agent'" # Re-enable it cypher-shell "MATCH (t:OCTool {id:'tool-sessions-spawn'}) SET t.available = true"
Running multiple workspaces (fleet setup)
For an 8-agent fleet, give each agent its own workspace ID:
# Seed separate workspaces python3 seed.py --workspace intel-agent python3 seed.py --workspace code-agent python3 seed.py --workspace ops-agent # Each agent's workspace stubs point to its own workspace # ~/.openclaw/workspace-intel/SOUL.md: # <!-- GRAPH: MATCH (s:Soul) WHERE s.workspace = 'intel-agent' ... -->
See Fleet Management in the Admin Guide for the full topology and per-workspace tool overrides.
Customizing the seed script
For full control, modify the workspace defaults in seed.py:
Edit the Soul, Memory, AgentConfig, and Tool data structures, then run:
python3 seed.py --workspace myagent
The seed script uses MERGE — safe to re-run. Existing nodes are updated, not duplicated.
Keeping your customizations across upgrades
The seed script uses MERGE (not CREATE), so it's safe to re-run after pulling new versions. Your customizations to existing nodes are preserved.
# Pull latest and re-run
cd openclaw-graph && git pull
python3 seed.pySee Upgrading in the Admin Guide for the full workflow.
Quick reference — node IDs shipped in default workspace
| ID | Type | Section / Domain / Key |
|---|---|---|
soul-openclaw-prime-directive | Soul | Prime Directive |
soul-openclaw-identity | Soul | Identity |
soul-openclaw-safety | Soul | Safety |
soul-openclaw-heartbeat | Soul | Heartbeat Protocol |
mem-openclaw-principal | Memory | Principal |
mem-openclaw-infrastructure | Memory | Infrastructure |
agentcfg-openclaw-every-session | Config | Every Session |
agentcfg-openclaw-delegation | Config | Delegation |
agentcfg-openclaw-safety | Config | Safety |
agentcfg-openclaw-heartbeats | Config | Heartbeats |
agentcfg-openclaw-memory | Config | Memory |
agentcfg-openclaw-toon | Config | Token Optimization — TOON |
agentcfg-openclaw-search-resilience | Config | Search Resilience |
agentcfg-openclaw-schema-rules | Config | Schema Rules |
agentcfg-openclaw-path-aliases | Config | Path Aliases |
tool-sessions-spawn | Tool | sessions_spawn (available=true) |
| + 20 other tool-* nodes — all standard OpenClaw tools | ||