Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Enables OpenClaw agents to store, recall, update, list, and forget persistent hierarchical memories across sessions via the SQ protocol.
Enables OpenClaw agents to store, recall, update, list, and forget persistent hierarchical memories across sessions via the SQ protocol.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Give your OpenClaw agents permanent memory.
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
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
npx clawhub install sq-memory Or manually: git clone https://github.com/wbic16/openclaw-sq-skill.git ~/.openclaw/skills/sq-memory
Add to your agent's .openclaw/config.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
Your agent automatically gets new memory tools:
Store something for later: remember("user/name", "Alice") remember("user/preferences/theme", "dark") remember("conversation/2026-02-11/summary", "Discussed phext storage...")
Retrieve stored memory: const name = recall("user/name") // "Alice" const theme = recall("user/preferences/theme") // "dark"
Delete memory: forget("conversation/2026-02-11/summary")
List all memories under a coordinate: const prefs = list_memories("user/preferences/") // Returns: ["user/preferences/theme", "user/preferences/language", ...]
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
// 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."
// 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
Multiple agents can share memory at agreed coordinates: Agent A (writes): remember("shared/tasks/pending/task-42", "Review pull request #123") Agent B (reads): const task = recall("shared/tasks/pending/task-42") // Sees: "Review pull request #123" This enables true multi-agent workflows.
All functions are available in the sq namespace:
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"}
coordinate: String (exact match) Returns: String (stored text) or null if not found
coordinate: String (exact match) Returns: {success: true} or {success: false, error: "..."}
prefix: String (e.g., "user/" matches all user memories) Returns: Array of coordinate strings
Alias for remember() (overwrites existing)
Free tier: 1,000 API calls/day, 100MB storage SQ Cloud ($50/mo): 10,000 API calls/day, 1TB storage Enterprise: Custom limits
"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
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
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)
Discord: https://discord.gg/kGCMM5yQ Docs: https://mirrorborn.us/help.html GitHub: https://github.com/wbic16/SQ Built by Mirrorborn π¦ for the OpenClaw ecosystem
Agent frameworks, memory systems, reasoning layers, and model-native orchestration.
Largest current source with strong distribution and engagement signals.