✓ Verified
💻 Development
✓ Enhanced Data
Sq Memory
**Give your OpenClaw agents permanent memory.**.
- Rating
- 4.4 (126 reviews)
- Downloads
- 31,657 downloads
- Version
- 1.0.0
Overview
**Give your OpenClaw agents permanent memory.**.
Complete Documentation
View Source →SQ Memory - OpenClaw Skill
Give your OpenClaw agents permanent memory.Open Source & MIT Licensed
SQ is open-source software you can run yourself or use our hosted version.- Source Code: https://github.com/wbic16/SQ
- License: MIT (free forever, modify/sell/distribute)
- Self-Host: Free (5 minute setup)
- Hosted Option: Paid convenience service at mirrorborn.us
What This Skill Does
OpenClaw agents lose all memory between sessions. Every restart = amnesia. This skill connects your agent to SQ—persistent 11D text storage. Your agent can:- Remember user preferences across sessions
- Store conversation history beyond context limits
- Share memory with other agents
- Never hallucinate forgotten details again
Installation
``bash
npx clawhub install sq-memory
`
Or manually:
`bash
git clone https://github.com/wbic16/openclaw-sq-skill.git ~/.openclaw/skills/sq-memory
`
Configuration
Add to your agent's .openclaw/config.yaml:
`yaml
skills:
sq-memory:
enabled: true
endpoint: http://localhost:1337
username: your-username
password: your-api-key
namespace: agent-name # Isolates this agent's memory
`
Usage
Your agent automatically gets new memory tools:
remember(key, value)
Store something for later:
`javascript
remember("user/name", "Alice")
remember("user/preferences/theme", "dark")
remember("conversation/2026-02-11/summary", "Discussed phext storage...")
`
recall(key)
Retrieve stored memory:
`javascript
const name = recall("user/name") // "Alice"
const theme = recall("user/preferences/theme") // "dark"
`
forget(key)
Delete memory:
`javascript
forget("conversation/2026-02-11/summary")
`
list_memories(prefix)
List all memories under a coordinate:
`javascript
const prefs = list_memories("user/preferences/")
// Returns: ["user/preferences/theme", "user/preferences/language", ...]
`
Coordinate Structure
Memories are stored at 11D coordinates. The skill uses this convention:
`
namespace.1.1 / category.subcategory.item / 1.1.1
`
Example:
- Agent namespace:
my-assistant
- User preference for theme:
my-assistant.1.1/user.preferences.theme/1.1.1
This means:
- Each agent has isolated memory (namespace collision impossible)
- Memories are hierarchically organized
- You can share coordinates between agents if needed
Example: User Preference Agent
`javascript
// In your agent's system prompt or skill code:
async function getUserTheme() {
const theme = recall("user/preferences/theme")
return theme || "light" // Default to light if not set
}
async function setUserTheme(newTheme) {
remember("user/preferences/theme", newTheme)
return Theme set to ${newTheme}
}
// Agent conversation:
User: "I prefer dark mode"
Agent: calls setUserTheme("dark")
Agent: "Got it! I've set your theme to dark mode."
// Next session (days later):
User: "What's my preferred theme?"
Agent: calls getUserTheme()
Agent: "You prefer dark mode."
`
Example: Conversation History
`javascript
// Store conversation summaries beyond context window:
async function summarizeAndStore(conversationId, summary) {
const date = new Date().toISOString().split('T')[0]
const key = conversations/${date}/${conversationId}/summary
remember(key, summary)
}
async function recallConversation(conversationId) {
const memories = list_memories(conversations/)
return memories
.filter(m => m.includes(conversationId))
.map(key => recall(key))
}
// Usage:
summarizeAndStore("conv-123", "User asked about phext storage, explained 11D coordinates")
// Later:
const history = recallConversation("conv-123")
// Agent can recall what was discussed even after context window cleared
`
Advanced: Multi-Agent Coordination
Multiple agents can share memory at agreed coordinates:
Agent A (writes):
`javascript
remember("shared/tasks/pending/task-42", "Review pull request #123")
`
Agent B (reads):
`javascript
const task = recall("shared/tasks/pending/task-42")
// Sees: "Review pull request #123"
`
This enables true multi-agent workflows.
API Reference
All functions are available in the sq namespace:
sq.remember(coordinate, text)
- coordinate: String in format
a.b.c/d.e.f/g.h.i or shorthand category/item
- text: String to store (max 1MB per coordinate)
- Returns:
{success: true, coordinate: "full.coordinate.path"}
sq.recall(coordinate)
- coordinate: String (exact match)
- Returns: String (stored text) or
null if not found
sq.forget(coordinate)
- coordinate: String (exact match)
- Returns:
{success: true} or {success: false, error: "..."}
sq.list_memories(prefix)
- prefix: String (e.g.,
"user/" matches all user memories)
- Returns: Array of coordinate strings
sq.update(coordinate, text)
- Alias for
remember() (overwrites existing)
Rate Limits
- Free tier: 1,000 API calls/day, 100MB storage
- SQ Cloud ($50/mo): 10,000 API calls/day, 1TB storage
- Enterprise: Custom limits
Troubleshooting
"Connection refused" error:
- Check your
endpoint in config (should be https://sq.mirrorborn.us)
- Verify credentials are correct
"Quota exceeded" error:
- You've hit rate limits
- Upgrade to SQ Cloud or wait for daily reset
Memory not persisting:
- Check namespace isolation (each agent needs unique namespace)
- Verify coordinate format is valid
Why SQ?
Open source & MIT licensed:
- Run it yourself for free
- Modify it to fit your needs
- No vendor lock-in
- Transparent codebase
Not a vector database:
- Agents can read stored text (not just search embeddings)
- Structured by coordinates (not similarity)
- Deterministic retrieval (no relevance ranking guesses)
Not Redis:
- Persistent (survives restarts)
- 11D addressing (not flat key-value)
- Immutable history (WAL for time-travel)
Built for agents:
- Coordinate system matches agent thinking (hierarchical)
- No schema overhead
- Scales from KB to TB
Get SQ
Self-Host (Free):
- Clone:
git clone https://github.com/wbic16/SQ.git
- Build:
cd SQ && cargo build --release
- Run:
./target/release/sq 1337
- Configure SQ Memory to
http://localhost:1337
Hosted (Convenience):
- Sign up: https://mirrorborn.us
- Get API key
- Configure SQ Memory to
https://sq.mirrorborn.us`
- Pay $50/mo (or use free tier)
Support
- Discord: https://discord.gg/kGCMM5yQ
- Docs: https://mirrorborn.us/help.html
- GitHub: https://github.com/wbic16/SQ
Built by Mirrorborn 🦋 for the OpenClaw ecosystem
Installation
Terminal bash
openclaw install sq-memory
Copied!
Tags
#coding_agents-and-ides
Quick Info
Category Development
Model Claude 3.5
Complexity Multi-Agent
Author wbic16
Last Updated 3/10/2026
🚀
Optimized for
Claude 3.5
Ready to Install?
Get started with this skill in seconds
openclaw install sq-memory
Related Skills
✓ Verified
💻 Development
4claw
4claw — a moderated imageboard for AI agents.
🧠 Claude-Ready
)}
★ 4.4 (118)
↓ 4,990
v1.0.0
✓ Verified
💻 Development
Aap Passport
Agent Attestation Protocol - The Reverse Turing Test.
🧠 Claude-Ready
)}
★ 4.3 (89)
↓ 4,621
v1.0.0
✓ Verified
💻 Development
Acestep Lyrics Transcription
Transcribe audio to timestamped lyrics using OpenAI Whisper or ElevenLabs Scribe API.
⚡ GPT-Optimized
)}
★ 3.8 (274)
↓ 17,648
v1.0.0
✓ Verified
💻 Development
Adaptive Suite
A continuously adaptive skill suite that empowers Clawdbot.
🧠 Claude-Ready
)}
★ 4.7 (88)
↓ 1,625
v1.0.0