Clever Compact

Your OpenClaw agent forgets everything between sessions — after /new, after compaction, after overnight. Clever Compact fixes all three: injects your last state on session start, flushes before every compact, and keeps memory stable across context resets. Native plugin. Zero per-turn overhead. Install in 4 steps, runs automatically.

Publisher: AxiomStream Group
Version: 2.2.5
Tier: Free
ClaWHub: https://clawhub.ai/jfulmines-star/clever-compact
Support: [e-mail]

---

What This Skill Does

Clever Compact fixes the three memory failure modes every serious OpenClaw user hits:

• /new amnesia — fresh session, agent acts like it's never met you
• Compaction loss — context fills up, compact fires, agent forgets what it was doing mid-task
• Overnight drift — decisions from three sessions ago quietly disappear

v2 is a native OpenClaw plugin with two parts:

Session restore (automatic): At the start of every session — including after /new and after compaction — Clever Compact checks for a recent compact-state file. If one exists (written within 72 hours), it injects the content as system context on the first turn only. Your agent wakes up oriented with zero per-turn token overhead.

State write (triggered by you): OpenClaw doesn't expose a pre-compaction lifecycle hook yet, so the write side is explicit — not automatic. Three ways to trigger it; pick one (see below).

---

Installation (4 steps)

1. Install:

openclaw skills add https://clawhub.ai/jfulmines-star/clever-compact

2. Enable in ~/.openclaw/openclaw.json:

{
  "plugins": {
    "entries": {
      "clever-compact": {
        "enabled": true
      }
    }
  }
}

3. Add to plugins.allow:

{
  "plugins": {
    "allow": ["clever-compact"]
  }
}

4. Restart gateway:

openclaw gateway restart

That's it. Session restore is now active automatically.

---

Writing State

Pick one trigger method:

Manual — Tell your agent:

"Run a Clever Compact flush"

Heartbeat — Add to your HEARTBEAT.md:

## Context Flush (at >75% context)
- Run a Clever Compact flush — write state to memory/compact-state-YYYY-MM-DD-HHmm.md

Cron — Schedule a pre-compact flush via Piston or system cron, 5 minutes before your nightly compact:

Payload: "Pre-compaction memory flush. Store durable memories now."

The plugin also exposes api.fn("clever-compact:write") for programmatic triggers from other tools.

---

Using with memory-core (IMPORTANT — OC 2026.5.2+)

If you're running both Clever Compact and memory-core, you have two great tools that do different things — and they work together perfectly when configured correctly.

What each owns:

• Clever Compact → cross-session state injection (compact-state files → session start restore)
• memory-core → within-session memory flush, memory_search/memory_get tools, dreaming

The conflict: On OC 2026.5.2+, both plugins can fire a session-start injection at the same time. The fix is one config line.

Recommended config (both enabled, no conflict):

"plugins": {
  "entries": {
    "clever-compact": {
      "enabled": true
    },
    "memory-core": {
      "enabled": true,
      "config": {
        "memoryFlush": {
          "enabled": false
        }
      }
    }
  }
}

With this setup: memory-core handles search tools and dreaming, Clever Compact handles session restore. No overlap, no conflict.

Advanced: If you want memory-core's flush AND CC's session restore, set both enabled but point memory-core's flush to a different target file. Most users don't need this — the config above covers 99% of setups.

---

Compatibility

Version	Status
OpenClaw 2026.4.10+	✅ Supported
OpenClaw 2026.5.2+	✅ Supported (use memory-core config above if both enabled)
OpenClaw < 2026.4.10	❌ Not supported

---

Changelog

• v2.2.4 — Fix: session flag now scoped per-registration (fixes blank-session bug on OC 2026.5.2 plugin loading changes). Added memory-core coexistence guidance.
• v2.2.3 — Stable release. Version sync across package files.
• v2.2.0 — Native plugin (no longer skill-only). Injects once per session only — eliminates per-turn token overhead.

---

Built by AxiomStream Group — axiomstreamgroup.com
We built this because we needed it. We run it on our own agents every day.

---

⭐ If Clever Compact saved your agent's memory, star it on ClaWHub — it helps other users find it and tells us the fix was worth shipping. Star on ClaWHub →

---

Security

Clever Compact is a memory plugin. It reads and writes local files in your OPENCLAW_WORKSPACE/memory/ directory only. No network requests, no shell execution, no credential access.

The ClawHub security scanner flags memory plugins because they use fs, process.env, before_prompt_build, and prependSystemContext — the same capabilities used by OpenClaw's own memory-core plugin. These are required for any memory plugin to function.

See SECURITY.md for the full capability-by-capability breakdown, or GitHub issue #1989 for the false-positive report.

VirusTotal: ✅ Benign | Static analysis: ✅ Benign | ClawScan: 🔄 Under review