synthetic-supermemory
Full memory pipeline for OpenClaw agents. Three components that work together:
session transcripts
↓ scribe.js (hourly system cron)
memory/YYYY-MM-DD.md
↓ ingest.js (every 2h system cron)
Supermemory (containerTag per agent)
↓ recall.js (session startup)
enriched context
No gateway involvement. No context bloat. Fully automated.
⚠️ Privacy notice
scribe.js sends conversation transcript content to an external LLM (OpenAI or Anthropic) for summarization. If your sessions contain secrets, API keys, or PII — be aware that content will be sent to the provider. Use a dedicated low-privilege API key with spend limits.
Quick setup
# Install dependencies
cd /path/to/skills/synthetic-supermemory && npm install
# Store keys securely (do NOT put secrets in crontab)
mkdir -p ~/.openclaw/secrets
echo "sk-your-openai-key" > ~/.openclaw/secrets/scribe-key && chmod 600 ~/.openclaw/secrets/scribe-key
echo "sm-your-supermemory-key" > ~/.openclaw/secrets/supermemory-key && chmod 600 ~/.openclaw/secrets/supermemory-key
# Test scribe (dry-run)
SUPERMEMORY_API_KEY=$(cat ~/.openclaw/secrets/supermemory-key) \
node scripts/scribe.js \
--agents-dir ~/.openclaw/agents \
--all-sessions \
--memory-dir ~/.openclaw/workspace/memory \
--api-key-file ~/.openclaw/secrets/scribe-key \
--dry-run
# Test recall
SUPERMEMORY_API_KEY=$(cat ~/.openclaw/secrets/supermemory-key) \
node scripts/recall.js --container my-agent
Cron setup (add via crontab -e)
# Scribe active sessions hourly
0 * * * * SUPERMEMORY_API_KEY=$(cat ~/.openclaw/secrets/supermemory-key) node /path/to/synthetic-supermemory/scripts/scribe.js --agents-dir ~/.openclaw/agents --all-sessions --memory-dir ~/.openclaw/workspace/memory --api-key-file ~/.openclaw/secrets/scribe-key >> /tmp/scribe.log 2>&1
# Ingest changed memory files into Supermemory every 2 hours
0 */2 * * * SUPERMEMORY_API_KEY=$(cat ~/.openclaw/secrets/supermemory-key) node /path/to/synthetic-supermemory/scripts/ingest.js --dir ~/.openclaw/workspace/memory --container my-agent >> /tmp/ingest.log 2>&1
Scripts
| Script | Purpose | Usage |
|---|---|---|
scribe.js | Summarize session transcripts → daily memory files + Supermemory | Hourly cron |
ingest.js | Ingest changed memory files → Supermemory (upsert, change-tracked) | Every 2h cron |
recall.js | Retrieve context at session startup | Session start |
add.js | Add a single memory from CLI or stdin | On demand |
search.js | Semantic search across memories | On demand |
scribe.js options
| Flag | Description | Default |
|---|---|---|
--agents-dir <dir> | OpenClaw agents directory | — |
--all-sessions | Scribe all recently active sessions | — |
--sessions <dir> | Single agent sessions directory | — |
--session-id <id> | Specific session UUID | — |
--auto-session <key> | Auto-resolve session by key suffix | — |
--memory-dir <dir> | Directory for daily memory files | required |
--provider <name> | LLM provider: openai or anthropic | auto-detected |
--model <model> | Summarization model | gpt-4o-mini |
--api-key-file <path> | LLM API key file (600 permissions) | — |
--sm-container <tag> | Supermemory container override | --agent value |
--agent <id> | Agent label for memory headers | agent |
--active-within-hours <n> | Only scribe sessions active within window | 1 |
--min-turns <n> | Minimum new turns before scribing | 3 |
--dry-run | Print without writing | false |
ingest.js / recall.js / search.js / add.js options
All take --container <tag> to namespace memories per agent.
# Ingest a directory
node scripts/ingest.js --dir ~/.openclaw/workspace/memory --container sapphire
# Recall context at session start
node scripts/recall.js --container sapphire --query "recent projects and identity"
# Add a one-off memory
node scripts/add.js --container sapphire --content "Kitsune prefers dark mode"
# Search
node scripts/search.js --container sapphire --query "TokTeam deployment"
References
- references/api.md — Full Supermemory API reference (batch add, delete, container management)
- references/transcript-format.md — OpenClaw session transcript JSONL structure