Agent Skills › matrixorigin/Memoria › thememoria

thememoria

GitHub

提供Memoria持久化记忆系统的使用指南，涵盖安装、存储、检索、修正及版本管理（快照/分支/回滚），指导Agent高效维护跨会话用户上下文。

plugins/clawhub/thememoria/SKILL.md matrixorigin/Memoria

Trigger Scenarios

remember this save to memory what do you remember continue from last time forget this correct memory take a snapshot rollback memory branch memory merge memory use long-term memory

Install

npx skills add matrixorigin/Memoria --skill thememoria -g -y

More Options

Non-standard path

npx skills add https://github.com/matrixorigin/Memoria/tree/main/plugins/clawhub/thememoria -g -y

Use without installing

npx skills use matrixorigin/Memoria@thememoria

指定 Agent (Claude Code)

npx skills add matrixorigin/Memoria --skill thememoria -a claude-code -g -y

安装 repo 全部 skill

npx skills add matrixorigin/Memoria --all -g -y

预览 repo 内 skill

npx skills add matrixorigin/Memoria --list

SKILL.md

Frontmatter

{
    "name": "thememoria",
    "version": "0.2.0",
    "metadata": {
        "openclaw": {
            "emoji": "🧠",
            "homepage": "https:\/\/github.com\/matrixorigin\/Memoria"
        }
    },
    "description": "Use Memoria as OpenClaw's durable memory slot.\nTriggers: \"remember this\", \"save to memory\", \"what do you remember\",\n\"continue from last time\", \"forget this\", \"correct memory\", \"take a snapshot\",\n\"rollback memory\", \"branch memory\", \"merge memory\", \"use long-term memory\".\n"
}

Memoria

Use this skill when OpenClaw should treat Memoria as the durable external memory system for the current user or project.

Routing

Pick the smallest reference that matches the task:

Install or verify the OpenClaw plugin: references/setup.md
Decide which memory tool to use: references/tool-surface.md
Daily store, recall, correct, forget behavior: references/operations.md
Session lifecycle, goals, recovery, branches, rollback: references/patterns.md

Core Rules

Prefer Memoria tools over MEMORY.md or memory/YYYY-MM-DD.md unless the user explicitly asks for file-based notes.
Do not auto-store every turn. Save durable facts, preferences, decisions, workflows, and meaningful progress.
On task resume or "what do you remember" prompts, retrieve relevant memory first.
Use the most specific tool available: memory_profile for stable preferences, memory_store for general durable memory, memory_correct or memory_forget for repairs.
Before bulk delete, purge, or large rewrites, create a snapshot first.
Use branches for risky or reversible memory experiments, then diff and merge or delete.
After important writes, repairs, rollback, or merges, verify with retrieval or list tools.
Do not claim only memory_search or memory_get exist when other memory_* tools are available.

Default Flow

At conversation start or task resume, use memory_retrieve or memory_search for relevant context.
During the conversation, store only the durable facts worth keeping.
If the user corrects or removes memory, repair it immediately with memory_correct, memory_forget, or memory_purge.
For risky memory maintenance, create a snapshot or branch before mutating state.
At the end of meaningful work, store the durable outcome and clean up obsolete working memory.

Important Notes

OpenClaw's built-in file memory (openclaw memory) is separate from Memoria (openclaw memoria).
The plugin defaults to explicit writes, not silent auto-capture.
memory_get is a compatibility helper; when in doubt, prefer memory_retrieve, memory_search, or memory_list.
Memoria's core strengths are semantic retrieval, durable cross-session memory, snapshots, rollback, branches, merge, and governance.

Quick Start

openclaw plugins install @matrixorigin/thememoria
openclaw memoria setup --mode cloud --api-url <MEMORIA_API_URL> --api-key <API_KEY>
openclaw memoria health