mcpField
M
memory-hygiene

memory-hygiene

github.com/aaaaqwqAgent workflows111374 installsUpdated 1w ago
Repository

About memory-hygiene

Memory Hygiene is a skill for maintaining Clawdbot's vector memory. It guides agents through auditing, clearing and selectively reseeding stored facts, and disabling automatic capture to reduce irrelevant memories.

Key features

  1. 01Audit stored memories
  2. 02Clear the LanceDB memory store
  3. 03Reseed selected facts from MEMORY.md
  4. 04Disable automatic memory capture
  5. 05Set monthly maintenance tasks

Use cases

  1. 01Remove transient or noisy memories
  2. 02Retain selected preferences and decisions after a wipe
  3. 03Reduce automatic storage of irrelevant content
  4. 04Schedule recurring memory cleanup

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/aaaaqwq/agi-super-team --skill memory-hygiene

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

Bundled files_meta.json.clawhub/origin.json

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