Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
OpenClaw plugin for personal memory: auto-capture with guardrails + local semantic-ish search with safe redaction.
OpenClaw plugin for personal memory: auto-capture with guardrails + local semantic-ish search with safe redaction.
This item's current download entry is known to bounce back to a listing or homepage instead of returning a package file.
Use the source page and any available docs to guide the install because the item currently does not return a direct package file.
I tried to install a skill package from Yavira, but the item currently does not return a direct package file. Inspect the source page and any extracted docs, then tell me what you can confirm and any manual steps still required. Then review README.md for any prerequisites, environment setup, or post-install checks.
I tried to upgrade a skill package from Yavira, but the item currently does not return a direct package file. Compare the source page and any extracted docs with my current installation, then summarize what changed and what manual follow-up I still need. Then review README.md for any prerequisites, environment setup, or post-install checks.
This is an OpenClaw Gateway plugin that behaves like a lightweight personal brain: It listens to inbound messages and captures likely-valuable notes when certain triggers or topics occur. It allows semantic-ish recall via a search tool and slash commands. Everything is stored locally (JSONL) with optional secret redaction. Oldest items are evicted when the configurable maxItems cap is reached.
Explicitly save a personal brain memory item. Auth required: No Arguments: The text to remember (required) /remember-brain TypeScript 5.5 requires explicit return types on exported functions Response: Saved brain memory. (or Saved brain memory. (secrets redacted) when secrets are detected and redacted).
Search brain memory items by semantic similarity. Auth required: No Arguments: Search query (required), optional trailing number for limit (default 5, max 20) /search-brain architecture decisions /search-brain deployment process 10 Response: Numbered list of results with similarity scores and text previews, or No brain memories found for: <query> when empty. A sole numeric argument is treated as the query, not a limit.
List the most recent brain memory items. Auth required: No Arguments: Optional limit number (default 10, max 50) /list-brain /list-brain 20 Response: Numbered list with dates and text previews, or No brain memories stored yet. when empty.
List all unique tags across all brain memory items, sorted alphabetically. Auth required: No Arguments: None /tags-brain Response: Tags (N): tag1, tag2, ... or No tags found.
Export brain memory items as JSON for backup or portability. Auth required: No Arguments: Optional --tags filter /export-brain /export-brain --tags arch,design Response: A JSON object with { version, exportedAt, count, items }. The items array contains full memory items. Use --tags to export only items matching specific tags.
Import brain memory items from a JSON export. Accepts either a bare JSON array of items or an envelope object (as produced by /export-brain). Auth required: Yes Arguments: JSON string (required) /import-brain [{"id":"...","kind":"note","text":"...","createdAt":"..."}] /import-brain {"version":1,"items":[...]} Response: Imported N items. X skipped (already exist). Y skipped (invalid format). Items with matching IDs are skipped (idempotent). Missing IDs get a new UUID. Invalid kind defaults to "note". Missing tags receive defaultTags.
Delete brain memory items older than the configured retention period. Auth required: Yes Arguments: Optional --dry-run flag /purge-brain /purge-brain --dry-run Response: Purged N item(s) older than X day(s). M item(s) remaining. or Retention policy is not configured. when retention.maxAgeDays is 0 or unset. Use --dry-run to preview without deleting. Expired items are also automatically purged on plugin startup.
Delete a brain memory item by its unique ID. Auth required: Yes Arguments: The memory item UUID (required) /forget-brain 550e8400-e29b-41d4-a716-446655440000 Response: Deleted brain memory: <id> or No memory found with id: <id>.
An AI-callable tool for searching personal brain memory items from the local JSONL store.
ParameterTypeRequiredDefaultDescriptionquerystringyes-The search textlimitnumberno5Max results to return (1-20)
{ "query": "Anthropic reset schedule", "limit": 5 }
{ "hits": [ { "score": 0.87, "id": "550e8400-e29b-41d4-a716-446655440000", "createdAt": "2026-02-27T10:30:00.000Z", "tags": ["brain"], "text": "Remember: Anthropic resets usage limits on the 1st of each month." } ] } Returns { "hits": [] } when no results match or the query is empty.
The plugin hooks into the message_received event for automatic memory capture.
A message is captured when all of these conditions are met: The message content is not empty Message length >= minChars (default 80) At least one of: Contains an explicit trigger phrase (e.g. "remember this", "keep this") requireExplicit is false AND the message contains an auto-topic keyword (e.g. "decision")
Case-insensitive substring matching (e.g. "merke dir" also matches "Merke dir:" naturally) Default explicit triggers: merke dir, remember this, notiere, keep this Default auto-topics: entscheidung, decision
Brain-memory should not silently store large amounts of chat. The recommended default is requireExplicit: true. If you want more aggressive capture, set requireExplicit: false in config (not recommended for OPSEC).
Full configuration reference via openclaw.plugin.json: { "plugins": { "entries": { "openclaw-memory-brain": { "enabled": true, "config": { "storePath": "~/.openclaw/workspace/memory/brain-memory.jsonl", "dims": 256, "redactSecrets": true, "maxItems": 5000, "capture": { "minChars": 80, "requireExplicit": true, "explicitTriggers": ["merke dir", "remember this", "notiere", "keep this"], "autoTopics": ["entscheidung", "decision"] }, "defaultTags": ["brain"], "retention": { "maxAgeDays": 90 } } } } } }
OptionTypeDefaultDescriptionenabledbooleantrueEnable or disable the plugin entirelystorePathstring~/.openclaw/workspace/memory/brain-memory.jsonlJSONL file path (must be inside home directory)dimsnumber256Embedding vector dimensions (32-2048)redactSecretsbooleantrueRedact detected secrets before storagemaxItemsnumber5000Maximum stored items before eviction (100-100000)defaultTagsstring[]["brain"]Default tags for all captured itemsretention.maxAgeDaysnumber0Delete items older than this many days. 0 = disabled.capture.minCharsnumber80Minimum message length for auto-capture (10+)capture.requireExplicitbooleantrueRequire explicit trigger phrases for capturecapture.explicitTriggersstring[]see config blockTrigger phrases for explicit capture (substring match, case-insensitive)capture.autoTopicsstring[]["entscheidung", "decision"]Topic keywords for auto-capture
Secrets (API keys, tokens, passwords, private keys, JWTs, DB connection strings) are redacted before storage. Only rule names and match counts are stored - never the matched secret text. Store path is validated to stay inside the user's home directory. Local storage only - no external data transmission.
clawhub install openclaw-memory-brain
openclaw plugins install -l ~/.openclaw/workspace/openclaw-memory-brain openclaw gateway restart
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.