Mnemos Memory

---
name: mnemos-memory
description: "Use when users or OpenClaw/ClawHub agents need to install, configure, self-bootstrap, troubleshoot, or operate Mnemos for persistent scoped agent memory, or when they mention Mnemos, agent memory, scoped memory, memory MCP tools, or memory automation."
---

# Mnemos Memory

Mnemos is a local-first memory layer for coding agents. Use this skill to guide users or OpenClaw agents onto the supported install path, explain the operating loop, and keep compatibility claims accurate.

## Default path

- Prefer `pip install "mnemos-memory[mcp]"` and `mnemos ui`.
- For OpenClaw / ClawHub, teach the agent to self-install `mnemos-memory[mcp]`, run `mnemos ui`, then wire `mnemos-mcp` to the canonical `MNEMOS_CONFIG_PATH` before relying on memory.
- Recommend SQLite as the starter store unless the user already has a scale reason for Qdrant or Neo4j.
- Recommend a real embedding provider (`openclaw`, `openai`, `openrouter`, or `ollama`) for production retrieval quality.
- Validate setup with the control-plane smoke check or `mnemos-cli doctor`.

## Claim discipline

- Safe to claim: local-first scoped memory, MCP tools, SQLite starter profile, Claude Code plugin flow, documented Codex flow.
- Be explicit that deterministic auto-memory is shipped for Claude Code via hooks.
- For Codex, Cursor, OpenClaw, and generic MCP hosts, do not imply automatic capture unless the host has its own automation or the user adds one.
- Neo4jStore is experimental. Do not present it as graph-native spreading-activation persistence yet.

## Workflow

1. Identify the host: Claude Code, Cursor, Codex, OpenClaw, or generic MCP.
2. If the repo is available locally, read `README.md`, `docs/MCP_INTEGRATION.md`, and `docs/codex.md` before answering.
3. Give the default install path first. Only fall back to manual config snippets if the user cannot use the control plane.
4. Explain the operating loop:
   - `mnemos_retrieve` at task start
   - `mnemos_store` for durable facts only
   - `mnemos_consolidate` before finishing substantial work
   - `mnemos_inspect` when a stored fact looks wrong
5. Read `references/hosts.md` for host-specific config snippets and caveats, especially the OpenClaw / ClawHub self-install flow when the agent must bootstrap itself.
6. Read `references/operations.md` for automation, capture-mode, storage guidance, and troubleshooting.

## Avoid

- Do not tell users to manually type memories as the primary workflow.
- Do not recommend `SimpleEmbeddingProvider` for production retrieval quality.
- Do not upgrade users to Qdrant or Neo4j unless they actually need a non-SQLite profile.