mcpField
M
memory-hygiene

memory-hygiene

github.com/sundial-orgAgent workflows67393 installsUpdated 34w ago
Repository

About memory-hygiene

memory-hygiene is a maintenance skill for Clawdbot vector memory, aimed at reducing clutter and token waste. It provides steps for auditing, clearing, reseeding, and periodically maintaining memory.

Key features

  1. 01Audit existing memories
  2. 02Clear LanceDB vector memory
  3. 03Reseed key facts from MEMORY.md
  4. 04Disable automatic capture
  5. 05Schedule monthly maintenance

Use cases

  1. 01Inspect clutter in vector memory
  2. 02Refresh memory with key facts
  3. 03Reduce junk from automatic capture
  4. 04Set up recurring memory maintenance

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/sundial-org/awesome-openclaw-skills --skill memory-hygiene

After installing, type/memory-hygienein Claude Code to confirm it loaded.

Details

From the project README

Memory Hygiene

Keep vector memory lean. Prevent token waste from junk memories.

Quick Commands

Audit: Check what's in memory

memory_recall query="*" limit=50

Wipe: Clear all vector memory

rm -rf ~/.clawdbot/memory/lancedb/

Then restart gateway: clawdbot gateway restart

Reseed: After wipe, store key facts from MEMORY.md

memory_store text="<fact>" category="preference|fact|decision" importance=0.9

Config: Disable Auto-Capture

The main source of junk is autoCapture: true. Disable it:

{
  "plugins": {
    "entries": {
      "memory-lancedb": {
        "config": {
          "autoCapture": false,
          "autoRecall": true
        }
      }
    }
  }
}

Use gateway action=config.patch to apply.

What to Store (Intentionally)

✅ Store:

  • User preferences (tools, workflows, communication style)
  • Key decisions (project choices, architecture)
  • Important facts (accounts, credentials locations, contacts)
  • Lessons learned

❌ Never store:

  • Heartbeat status ("HEARTBEAT_OK", "No new messages")
  • Transient info (current time, temp states)
  • Raw message logs (already in files)
  • OAuth URLs or tokens

Monthly Maintenance Cron

Set up a monthly wipe + reseed:

cron action=add job={
  "name": "memory-maintenance",
  "schedule": "0 4 1 * *",
  "text": "Monthly memory maintenance: 1) Wipe ~/.clawdbot/memory/lancedb/ 2) Parse MEMORY.md 3) Store key facts to fresh LanceDB 4) Report completion"
}

Storage Guidelines

When using memory_store:

  • Keep text concise (<100 words)
  • Use appropriate category
  • Set importance 0.7-1.0 for valuable info
  • One concept per memory entry

Comments

Markdown supported