Synapse Layer Skill#

Synapse Layer provides persistent, encrypted memory for AI agents with a 4-layer security pipeline.

Quick Setup#

Python SDK (Recommended for OpenClaw)#

Install and use:

bash

pip install synapse-layer

python

from synapse_test import SynapseClient

client = SynapseClient(api_key="sk_connect_...")

# Save memory
result = client.remember("User prefers dark mode", agent="mel")

# Retrieve memories
memories = client.recall("user preferences", agent="mel")

See scripts/synapse_client.py for a complete client implementation.

MCP Integration (External Tools)#

Add to OpenClaw gateway config for external MCP clients:

json

{
  "mcp": {
    "servers": {
      "synapse-layer": {
        "url": "https://forge.synapselayer.org/mcp",
        "headers": {
          "Authorization": "Bearer sk_connect_YOUR_API_KEY"
        }
      }
    }
  }
}

Note: This is for external MCP clients (Claude Desktop, Cursor) to connect to SynapseLayer, not for OpenClaw agents to use directly.

Available Tools#

Once configured via Python SDK, these operations are available:

• save_to_synapse - Store memory with full security pipeline
• recall - Retrieve memories ranked by Trust Quotient™
• search - Cross-agent memory search with full-text matching
• process_text - Auto-detect decisions, milestones, and alerts
• health_check - System health, version, and capability report

Cognitive Security Pipeline#

Every memory passes through 4 non-bypassable layers:

1. Semantic Privacy Guard™ - 15+ regex patterns detect PII, secrets, credentials
2. Intelligent Intent Validation™ - Two-step categorization with self-healing
3. AES-256-GCM Encryption - Authenticated encryption with PBKDF2 key derivation
4. Differential Privacy - Calibrated Gaussian noise on embeddings

Key Concepts#

Trust Quotient™ (TQ)#

Score (0-1) ranking memory reliability. Higher TQ = more trusted memory.

Cross-Agent Memory#

Memories can be shared across agents using the same agent_id or cross-agent search.

Storage Backends#

• Remote (Forge) - PostgreSQL via forge.synapselayer.org (recommended)
• SQLite - Local .synapse/memories.db (requires local setup)

Usage Patterns#

Basic Memory Operations#

Use the Python SDK client:

python

from scripts.synapse_client import SynapseClient

client = SynapseClient(api_key="sk_connect_...")

# Save
client.remember("Important decision", agent="mel", importance=5)

# Recall
memories = client.recall("recent decisions", agent="mel", limit=5)

# Search
all_memories = client.search("project deadlines", limit=10)

Process Text Automatically#

Extract events from free-form text:

python

events = client.process_text(
    "Decided to use PostgreSQL. Deadline is May 1st.",
    agent="hermes",
    project="website-redesign"
)

Security Considerations#

Data Privacy#

• PII automatically redacted before storage
• All data encrypted at rest (AES-256-GCM)
• Differential privacy protects individual entries
• Zero-knowledge architecture

Resilience Strategy#

Recommended approach for production:

1. Use SynapseLayer as primary memory store
2. Keep OpenClaw's MEMORY.md/memory/ as backup
3. Monitor service health via health_check
4. Have fallback procedure if service unavailable

Troubleshooting#

Connection Issues#

1. Run health_check to verify connectivity
2. Verify API key is valid
3. Check network access to forge.synapselayer.org

Memory Not Persisting#

1. Check API key permissions
2. Verify security pipeline didn't reject content
3. Review Trust Quotient in response

Low Trust Quotient#

1. Review security pipeline logs
2. Increase confidence/importance scores
3. Check if content was sanitized

Testing#

Use the test script:

bash

python3 /app/skills/synapse-layer/scripts/synapse_test.py

This script verifies:

• Service connectivity (health_check)
• Basic save operations
• Memory retrieval
• Cross-agent search

Reference Documentation#

For more details, see:

• API Reference - Complete tool documentation
• Security Details - Deep dive on security pipeline
• Framework Integrations - Integration guides
• Python Client - Ready-to-use SDK wrapper