Skip to main content

Local-first Store / Pack / Observe memory sidecar for cited, rollbackable OpenClaw context

Project description

openclaw-mem

Memory your agent can’t lie about — Store / Pack / Observe for local, cited, rollbackable context.

openclaw-mem turns agent work into a durable local memory trail, then builds bounded ContextPack bundles with citations, trust-policy receipts, and traceable include/exclude reasons. Start with a plain SQLite sidecar beside OpenClaw. Promote to the optional mem engine only after the local proof earns the extra surface.

Start here

  1. Run the synthetic proof: Trust-policy synthetic proof
  2. Pick an evaluation path: 5 minutes / 30 minutes / one afternoon
  3. Check Core vs Advanced Labs: Core vs Advanced Labs
  4. Choose sidecar vs engine: Install modes
  5. Check shipped vs partial status: Reality check & status
  6. Read in Traditional Chinese: Traditional Chinese edition

What is automatic today?

Surface Status Meaning
Sidecar observation capture Automatic when the plugin is enabled Captures denoised JSONL observations and backend/action annotations.
Harvest, triage, and graph capture Scheduled on configured hosts Converts captured records into searchable stores and receipts.
pack CLI core Produces bounded ContextPack output with citations and trace receipts.
Graph routing, optimize assist, continuity, GBrain Advanced Labs / opt-in lanes Available for mature operators, but not part of the first evaluation path.
Mem-engine Proactive Pack Optional promotion Bounded pre-reply recall orchestration after explicit engine adoption.

What you get

  • Local-first by default — JSONL + SQLite, no external database required.
  • Cheap recall loopsearch → timeline → get keeps routine lookups fast and inspectable.
  • Bounded packingpack emits a stable ContextPack contract for injection, citations, trust-policy receipts, and trace-backed debugging.
  • Fits real OpenClaw ops — capture tool outcomes, retain receipts, sanitize runtime artifacts, and keep rollback simple.
  • Upgradeable path — sidecar first, engine later; no forced migration on day one.
  • Advanced labs are opt-in — graph routing, GBrain, continuity, Dream Lite, and deeper optimization lanes stay out of the first evaluation path.

Why this exists

Long-running agents do not just forget. They also accumulate memory that quietly degrades:

  • old notes still match the query even when they are no longer useful
  • untrusted or hostile content can retrieve well and slip into context
  • prompts bloat into giant memory dumps instead of a small, inspectable bundle
  • when something goes wrong, it is hard to explain why a memory was included

openclaw-mem tackles that by building compact memory packs with citations, trace receipts, and trust-policy controls.

Try it in 5 minutes

You can prove the core behavior locally without touching OpenClaw config.

git clone https://github.com/phenomenoner/openclaw-mem.git
cd openclaw-mem
uv sync --locked

uv run --python 3.13 --frozen -- \
  python benchmarks/trust_policy_synthetic_proof.py --json

What this proof shows

  • vanilla packing selects a quarantined row from synthetic memory
  • trust-aware packing excludes that row with an explicit reason
  • selected rows keep citation coverage and traceable receipts

Full proof path:

Store + Pack + Observe

The product loop is simple and stable:

  1. Store: capture, ingest, and query observations with store/ingest/search.
  2. Pack: run pack to get a bounded bundle_text and context_pack (schema: openclaw-mem.context-pack.v1), with citations, trust policy, and trace receipts.
  3. Observe: use timeline, get, and artifact outputs for explainability and rollback.

When mem-engine is active, Proactive Pack extends the same Pack contract into live turns as a small, receipt-backed pre-reply bundle.

Advanced labs

The first-time evaluator path is Store / Pack / Observe. Everything below is opt-in after the core proof is clear.

Advanced lanes currently include:

  • Graph routing for topology-aware recall experiments.
  • GBrain sidecar for bounded read-only lookup and restricted helper-job experiments.
  • Governed continuity side-car for derived continuity inspection and public-safe summaries.
  • Dream Lite / deeper optimize loops for research-grade memory maintenance workflows.

These lanes are not required for the 5-minute proof, the sidecar install path, or the basic ContextPack contract. Treat them as labs until your use case needs them.

Read more:

OpenClaw 2026.4.15 and openclaw-mem

By OpenClaw 2026.4.15, the native memory and prompt-time integration experience had become noticeably stronger. We are genuinely happy to see that direction mature.

That is good for the ecosystem, good for operators, and good for openclaw-mem too. A stronger foundation makes it easier to keep our own work focused on what matters most: better packs, clearer evidence, and safer memory maintenance.

Our direction is not to shrink back into native features. It is to build a clearer, more opinionated product layer on top of a stronger foundation.

Read more:

Deeper operations live below the fold

openclaw-mem also has governed memory-hygiene and artifact-observation tools for mature operator stacks. They are useful after the core product is proven, but they are not required for the first evaluation path.

Start with:

More links

Core and adoption

License

Dual-licensed: MIT OR Apache-2.0. See LICENSE, LICENSE-MIT, and LICENSE-APACHE.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

openclaw_context_pack-1.9.5.tar.gz (985.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

openclaw_context_pack-1.9.5-py3-none-any.whl (271.5 kB view details)

Uploaded Python 3

File details

Details for the file openclaw_context_pack-1.9.5.tar.gz.

File metadata

  • Download URL: openclaw_context_pack-1.9.5.tar.gz
  • Upload date:
  • Size: 985.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.13

File hashes

Hashes for openclaw_context_pack-1.9.5.tar.gz
Algorithm Hash digest
SHA256 45ee26acd4c78fed88855cca9bc84e70dad146c05c4ea818a84868889e616307
MD5 2a5ad253dd93bd16316db69c958a278b
BLAKE2b-256 8da4824a4446520f3a36304680c107632355a09e1e16747bdd870997a8a1ad86

See more details on using hashes here.

File details

Details for the file openclaw_context_pack-1.9.5-py3-none-any.whl.

File metadata

File hashes

Hashes for openclaw_context_pack-1.9.5-py3-none-any.whl
Algorithm Hash digest
SHA256 83c5c06957bf05c4c7cb1b0953af20a929111f752c60eab9601a5ae4d02a4876
MD5 54be93071bece500db3240f08d3e7337
BLAKE2b-256 790ea6ec23cc4e8c369e09b0e351fdbaab9ec47d60d1a5393c57338edaf788ea

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page