Memphis Brain Skill

This skill enables OpenClaw agents to use Memphis as persistent, semantic memory. Each agent gets its own chains (journal, decisions, ask) and can sync with other agents via IPFS.

1. Quick Start

Check Health

memphis status

Expected: healthy providers, chains listed, embeddings available.

Journal First Block

memphis journal "I am [agent-name], created by [user], my role is [X]" --tags identity

Embed Context

memphis embed --chain journal

2. Core Workflows

2.1 Journaling (Capture Everything)

When to journal:

• User shares important info ("remember this...")
• Agent learns something new
• Decisions are made
• Sessions start/end
• Insights discovered

Syntax:

memphis journal "text" --tags tag1,tag2

Tag conventions:

• identity — who/what agent is
• preferences — user/agent preferences
• decision — choice made
• session — session markers
• learning — new knowledge
• project:<name> — project context
• share — blocks to sync via IPFS

Examples:

# Identity
memphis journal "I prefer concise responses, avoid fluff" --tags preferences,communication

# Decision
memphis journal "Chose local-first over cloud for privacy" --tags decision,philosophy

# Learning
memphis journal "Discovered qwen2.5:3b works best for code tasks" --tags learning,models

# Session
memphis journal "Session started, working on Memphis integration" --tags session,daily

2.2 Asking Memphis (Recall)

Use semantic search to find relevant context:

memphis ask "What are my preferences for code style?" --top 20 --provider ollama

Flags:

• --top N — more context (default 8, use 20 for complex queries)
• --provider ollama — use local model
• --graph — include knowledge graph edges
• --prefer-summaries — use condensed context
• --since YYYY-MM-DD — filter by date
• --json — machine-readable output

When to recall:

• User asks "what did I say about X?"
• Need context from previous sessions
• Checking decisions made
• Understanding user preferences

2.3 Decisions (Track Choices)

For important choices with long-term impact:

memphis decide "Title" "Choice" --options "A|B|C" --reasoning "..." --tags tag1,tag2

Example:

memphis decide "Memory Strategy" "Local-first + IPFS sync" \
  --options "cloud|local|hybrid" \
  --reasoning "Privacy + resilience + no vendor lock-in" \
  --tags philosophy,memory

View decision:

memphis show decision <id>

2.4 Reflection (Pattern Recognition)

Run reflections to find patterns:

# Daily (quick)
memphis reflect --daily

# Weekly (comprehensive)
memphis reflect --weekly --save

# Deep (full analysis)
memphis reflect --deep --save

Reflection outputs:

• Tag frequency analysis
• Theme extraction
• Decision patterns
• Graph clusters
• Insights (stale decisions, contradictions, opportunities)