supermemory-free

# Supermemory Free — Cloud Knowledge Backup

Backs up important knowledge and insights to Supermemory.ai's cloud using the **free tier API**.  
Uses only `/v3/documents` (store) and `/v3/search` (retrieve) — no Pro-only endpoints.

## Prerequisites

Set in `.env`
```
SUPERMEMORY_OPENCLAW_API_KEY="sm_..."
```

## Tools

### supermemory_cloud_store
Store a knowledge string to the cloud.

```bash
python3 skills/supermemory-free/store.py "Your knowledge string here"

# With optional container tag (namespace/filter)
python3 skills/supermemory-free/store.py "knowledge string" --tag openclaw

# With metadata
python3 skills/supermemory-free/store.py "knowledge string" --tag fixes --source "session"

# Output raw JSON
python3 skills/supermemory-free/store.py "knowledge string" --json
```

**When to use:**
- User asks to "remember" something permanently
- Important configuration/setup knowledge
- Resolved problems / solutions discovered
- Key facts you want cross-session persistence for

---

### supermemory_cloud_search
Search the cloud memory for relevant knowledge.

```bash
python3 skills/supermemory-free/search.py "your query"

# With container tag filter
python3 skills/supermemory-free/search.py "your query" --tag openclaw

# More results
python3 skills/supermemory-free/search.py "your query" --limit 10

# Higher precision (less noise)
python3 skills/supermemory-free/search.py "your query" --threshold 0.7

# Search across ALL tags
python3 skills/supermemory-free/search.py "your query" --no-tag
```

**When to use:**
- Local memory (MEMORY.md, daily logs) doesn't have the answer
- User references something from "a long time ago"
- Cross-session knowledge lookup
- "Do you remember when..." queries

---

### Auto-Capture (Cron)
Scans recent session memory logs and automatically pushes high-value insights to Supermemory cloud.

```bash
# Run manually
python3 skills/supermemory-free/auto_capture.py

# Dry run (show what would be captured, no upload)
python3 skills/supermemory-...

# Supermemory Free Skill for OpenClaw

This skill acts as a cloud backup for knowledge using the Supermemory.ai free tier.

## Features
- **Cloud Storage:** Manually store specific knowledge strings to the cloud.
- **Cloud Search:** Retrieve knowledge when local memory is insufficient.
- **Auto-Capture:** Daily cron job that extracts high-value insights from OpenClaw session logs.

## Setup
1. Get a free API key from [Supermemory.ai](https://supermemory.ai).
2. Set the `SUPERMEMORY_OPENCLAW_API_KEY` in your `.env` file.
3. Run `bash install_cron.sh` to enable auto-capture.

## Tools
- `supermemory_cloud_store(content)`
- `supermemory_cloud_search(query)`