openclaw-memory-brain

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.

Commands

/remember-brain <text>

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 <query> [limit]

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-brain [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.

/tags-brain

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 [--tags tag1,tag2]

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 <json>

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.

/purge-brain [--dry-run]

Delete brain memory items older than the configured retention period.

• Auth required: Yes
• Arguments: Optional --dry-run flag