memoria

What This Skill Does

Memoria is a structured, persistent memory system designed for OpenClaw AI agents. It acts as an external brain, allowing your agent to move beyond session-based limitations by storing, indexing, and retrieving critical user information across long durations. Whether you are managing complex project lifecycles, tracking personal preferences, or documenting architectural decisions, Memoria provides a robust framework to ensure that no vital context is ever lost. By supporting lifecycle commands like wake, checkpoint, and sleep, Memoria ensures that the agent's mental state is initialized and concluded with precision, including handoff summaries for future sessions. It bridges the gap between raw data and actionable intelligence by syncing with Notion, allowing for a hybrid local-cloud memory infrastructure.

Installation

To integrate Memoria into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/kitakitsune0x/memoria

Once installed, initialize your memory vault by setting the environment variable: export MEMORIA_VAULT=~/memory If you prefer to skip the environment variable, you must append the flag -v ~/memory to all Memoria commands.

Use Cases

• Project Management: Track ongoing development, decisions regarding tech stacks, and team commitments.
• Personalization: Automatically learn and store user preferences (e.g., coding styles, tone of voice, time zone) to improve agent rapport.
• Knowledge Retention: Capture "aha" moments, lessons learned from debugging, or complex research conclusions that the agent should recall for future tasks.
• Notion Integration: Maintain a synchronized knowledge base in Notion, allowing human collaborators to view or edit the memories the AI has collected.

Example Prompts

1. "I'm starting a new project called 'Sentinel.' We decided to use Python for the backend and PostgreSQL for the database because of the data integrity requirements."
2. "Search my memories for any commitments I made regarding the documentation update for the API release."
3. "I have a quick update: I prefer to work in the evenings and my time zone is JST. Also, I've decided to prioritize the security audit over the UI refactor."

Tips & Limitations

Memoria performs best when you are proactive. Do not wait for the agent to ask for information; if you identify a fact, preference, or goal, instruct the agent to use the remember command immediately. Remember that the system relies on structured types (fact, decision, preference, etc.) for optimal search retrieval; categorize your inputs correctly to ensure the agent can filter through vast amounts of data efficiently. Always run memoria sync --push after important updates to ensure your Notion database remains up-to-date with your local vault. Be mindful that sensitive information stored in the vault may be pushed to Notion; ensure your connected Notion workspace adheres to your security requirements.