Thememoria

What it does

When your agent uses it

• Tasks that involve Agent memory

Example prompts

• “s durable memory slot. Triggers:”
• “save to memory”
• “what do you remember”
• “/thememoria”

Requirements

• A credential in API_KEY

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

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

What it can do on your machine

Read from SKILL.md and the folder at commit 81c5cc6. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names these keys or tokens, usually read from environment variables:

  • API_KEY

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Thememoria loads about 728 tokens when it runs, and up to ~2.5k if it reads all its reference files. Until then it costs about 70 tokens; SKILL.md has 308 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~70

When it runs · the whole SKILL.md, loaded when a task matches

~728

With references · SKILL.md plus every file in references/, read only if the agent opens them

~2.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from matrixorigin/memoria at commit 81c5cc6, republished under its Apache-2.0 licence (© matrixorigin). 308 words, ~728 tokens.

name

thememoria

description

Use Memoria as OpenClaw's durable memory slot. Triggers: "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".

version

0.2.0

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

© matrixorigin, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (references) in plugins/clawhub/thememoria of matrixorigin/memoria.

• SKILL.md
• references/operations.md
• references/patterns.md
• references/setup.md
• references/tool-surface.md

Open the folder on GitHubat commit 81c5cc6