← Back to Skills Marketplace
🔌

Synthetic Supermemory

by Kitsune · GitHub ↗ · v2.1.0 · MIT-0
cross-platform ✓ Security Clean
151
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install synthetic-supermemory
Description
Full automated memory pipeline for OpenClaw agents. Scribe session transcripts into structured daily memory files, ingest them into Supermemory for semantic...
README (SKILL.md)

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 \x3Cdir> OpenClaw agents directory —
--all-sessions Scribe all recently active sessions —
--sessions \x3Cdir> Single agent sessions directory —
--session-id \x3Cid> Specific session UUID —
--auto-session \x3Ckey> Auto-resolve session by key suffix —
--memory-dir \x3Cdir> Directory for daily memory files required
--provider \x3Cname> LLM provider: openai or anthropic auto-detected
--model \x3Cmodel> Summarization model gpt-4o-mini
--api-key-file \x3Cpath> LLM API key file (600 permissions) —
--sm-container \x3Ctag> Supermemory container override --agent value
--agent \x3Cid> Agent label for memory headers agent
--active-within-hours \x3Cn> Only scribe sessions active within window 1
--min-turns \x3Cn> Minimum new turns before scribing 3
--dry-run Print without writing false

ingest.js / recall.js / search.js / add.js options

All take --container \x3Ctag> 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

Usage Guidance
This skill appears to do what it says: it reads OpenClaw session transcripts, summarizes them via an external LLM, writes local memory files, and indexes them in Supermemory. Before installing, consider: - Privacy: session contents (potentially including secrets or PII) will be sent to OpenAI/Anthropic and to Supermemory. Use a low-privilege LLM key with spend limits and avoid including sensitive sessions in the scribed directories. - Secrets handling: follow the SKILL.md advice to store keys securely (not in crontab); verify your crontab lines do not leak secrets in process lists or logs. - Dependencies: the scripts require the 'supermemory' npm package but the bundle has no package.json; you will likely need to install required npm modules yourself. Inspect package source and run npm install in a controlled environment before scheduling cron jobs. - Configuration: point --memory-dir and --agents-dir to only the directories you intend to index; do not point ingest to broad system directories to avoid accidental ingestion of sensitive files. - Minor documentation mismatches: the skill supports ANTHROPIC_API_KEY but the metadata does not list it — set that env if you plan to use Anthropic. Confirm the Supermemory endpoint (api.supermemory.ai) and validate the client library provenance. If you accept these trade-offs and install dependencies manually after inspecting package sources, the skill is coherent with its stated purpose.
Capability Assessment
✓ Purpose & Capability
Name/description (scribe transcripts → create daily memory files → ingest into Supermemory → recall/search) matches the included scripts (scribe.js, ingest.js, recall.js, add.js, search.js). Requested binaries (node) and primary credential (SUPERMEMORY_API_KEY) are appropriate for the stated functionality. One minor mismatch: SKILL metadata declares OPENAI_API_KEY as the second required env var but the code also supports ANTHROPIC_API_KEY; ANTHROPIC_API_KEY is not listed in requires.env.
ℹ Instruction Scope
Instructions and scripts legitimately read OpenClaw session transcripts (~/.openclaw/agents/.../sessions/*.jsonl), summarize them via an external LLM (OpenAI or Anthropic), write local daily memory files, and upload/index content to Supermemory. This does mean session contents (which may include secrets/PII) are sent to external services — the SKILL.md includes a privacy notice. The scripts do not appear to read unrelated system credentials or hidden endpoints beyond OpenAI/Anthropic and Supermemory.
ℹ Install Mechanism
There is no packaged install spec (instruction-only), which keeps surface area low. However, SKILL.md instructs running `npm install` in the skill directory while the registry metadata does not declare dependencies and the skill bundle does not include a package.json. The scripts require the 'supermemory' npm module but that dependency is not declared in the package bundle — the user will need to install dependencies manually. This is an operational inconsistency (not a direct malicious indicator) but worth attention before running.
ℹ Credentials
The two required credentials (SUPERMEMORY_API_KEY and an LLM API key) are proportionate to the task. PrimaryEnv is correctly set to SUPERMEMORY_API_KEY. Minor documentation inconsistency: scripts accept ANTHROPIC_API_KEY as an alternative, but ANTHROPIC_API_KEY is not listed under required env vars in the metadata.
✓ Persistence & Privilege
The skill does not request always:true and does not modify other skills or system-wide settings. It writes state files (.scribe-state.json, .ingest-state.json) into the scripts directory and writes memory files where the user specifies — this is expected for the feature. The agent can invoke the skill autonomously (platform default), which is appropriate for an automated memory pipeline.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install synthetic-supermemory
  3. After installation, invoke the skill by name or use /synthetic-supermemory
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.1.0
Skip directories that should never be ingested
v2.0.0
- Migrated core scripts from the scripts/ directory to top-level files (ingest.js, recall.js, scribe.js, search.js) for simpler access. - Updated documentation: removed extensive usage and setup guides from SKILL.md, and now focus on entry-point script usage. - Removed references/api.md, consolidating API usage to api.md at the top level. - Command-line usage for searching memories is now in search.js at the top-level (sample provided in SKILL.md). - Improved environment variable and argument handling in scripts.
v1.0.0
- Initial release of synthetic-supermemory skill, providing persistent long-term semantic memory via Supermemory API. - Supports adding, searching, recalling, and forgetting memories, with containerTag namespaces for each agent or user. - Includes scripts for ingesting files/directories, recalling context, adding memories, and searching. - Enables integration with session-scribe for automated memory management across sessions. - Requires SUPERMEMORY_API_KEY for operation.
Metadata
Slug synthetic-supermemory
Version 2.1.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 3
Frequently Asked Questions

What is Synthetic Supermemory?

Full automated memory pipeline for OpenClaw agents. Scribe session transcripts into structured daily memory files, ingest them into Supermemory for semantic... It is an AI Agent Skill for Claude Code / OpenClaw, with 151 downloads so far.

How do I install Synthetic Supermemory?

Run "/install synthetic-supermemory" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Synthetic Supermemory free?

Yes, Synthetic Supermemory is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Synthetic Supermemory support?

Synthetic Supermemory is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Synthetic Supermemory?

It is built and maintained by Kitsune (@kitsune); the current version is v2.1.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments