TotalReclaw v1.0.0 — Memory Taxonomy v1

TotalReclaw v1.0.0 — Memory Taxonomy v1 + Retrieval v2 Tier 1

End-to-end encrypted memory for AI agents. Portable, yours forever.

Highlights

• Memory Taxonomy v1 — six speech-act-grounded memory types (claim, preference, directive, commitment, episode, summary) and three orthogonal axes (source, scope, volatility), plus pin_status. A memory written by one client is legible to every other.
• Retrieval v2 — Tier 1 source-weighted reranker — user-stated claims beat assistant-drift by construction. Weights: user 1.0, user-inferred 0.9, derived/external 0.7, assistant 0.55, legacy 0.85.
• Cross-client portability validated — same 12-word recovery phrase, same Smart Account (CREATE2) across Python, MCP, plugin, and Rust. Write from MCP in the morning, recall from Python at lunch, redact via the OpenClaw plugin in the afternoon — one shared, E2E-encrypted vault.
• Three new MCP tools — totalreclaw_pin, totalreclaw_retype, and totalreclaw_set_scope. Natural-language overrides: "pin that" / "that was a rule, not a preference" / "tag this under work".
• First crates.io release — totalreclaw-memory v2.0.0 (native ZeroClaw backend: Memory trait + ERC-4337 batching + Tier 1 rerank) and totalreclaw-core v2.0.0 (shared Rust crypto/KG core).

Packages shipped

Package	Version	Registry	Install
@totalreclaw/core	2.0.0	npm	npm i @totalreclaw/core
totalreclaw-core	2.0.0	PyPI	pip install totalreclaw-core
totalreclaw-core	2.0.0	crates.io	cargo add totalreclaw-core
@totalreclaw/mcp-server	3.0.1	npm	npm i @totalreclaw/mcp-server
@totalreclaw/skill-nanoclaw	3.0.0	npm	npm i @totalreclaw/skill-nanoclaw
@totalreclaw/totalreclaw	3.0.2	ClawHub	openclaw plugins install @totalreclaw/totalreclaw
totalreclaw	2.0.1	PyPI	pip install totalreclaw
totalreclaw-memory	2.0.0	crates.io	cargo add totalreclaw-memory

Post-QA fixes already published:

• @totalreclaw/mcp-server 3.0.1 — protobuf wrapper version=4 to match v1 contract
• @totalreclaw/totalreclaw 3.0.2 — lockfile regenerated to unbreak ClawHub install
• totalreclaw 2.0.1 (PyPI) — wallet_address property no longer returns a stale EOA placeholder

Migration from v0.x

• Protobuf v4 outer wrapper change is server-side and backward compatible. Existing vaults keep working — the subgraph schema is unchanged; v1 bumps only the inner envelope. No user action required to keep reading v0 memories. All new writes are v1.
• v0 write paths are gone. Every client now writes v1 by default with no env-var toggles. Legacy v0 categories (fact, decision, rule, etc.) are still readable and are coerced to v1 on recall (e.g. v0 fact → v1 claim, v0 decision → v1 claim with reasoning).
• Full migration & interop notes in docs/specs/totalreclaw/memory-taxonomy-v1.md and docs/specs/totalreclaw/client-consistency.md.

Specs

• docs/specs/totalreclaw/memory-taxonomy-v1.md — authoritative Memory Taxonomy v1 spec
• docs/specs/totalreclaw/retrieval-v2.md — Retrieval v2 design (Tier 1 shipped, Tier 2-4 designed)
• docs/specs/totalreclaw/client-consistency.md — canonical reference for all 5 clients
• QA reports — VPS re-QA (GO), Python diagnostic (no data loss), initial VPS QA — live in totalreclaw-internal/docs/notes/QA-V1-*

Blog post

• Blog post: drafts in private internal repo; public announcement pending.

Known gaps

Carried forward from the feature matrix — non-blocking for v1.0.0.

• Bulk consolidation not available on managed service — batch-delete has no on-chain equivalent. Store-time supersession via tombstones still works; the totalreclaw_consolidate tool is self-hosted only.
• ZeroClaw has no import/migrate adapters yet — native Rust crate ships Memory trait + status + export + upgrade + executeBatch, but import and testnet-to-mainnet migration aren't wired in.
• Hermes (Python client) no chain-ID auto-detect — defaults to Base Sepolia (84532); Pro users on Gnosis must set chain_id=100 manually until billing-driven auto-switch lands.
• OpenClaw security scanner still requires --dangerously-force-unsafe-install on first install of @totalreclaw/totalreclaw@3.0.2 (QA Bug #3). Non-blocking; plugin itself installs and runs clean.
• MCP / NanoClaw lack Phase 2 contradiction detection + pin semantics — both have core-backed store-time dedup but no auto-extraction pipeline to wire contradiction orchestration into. OpenClaw, Hermes, and ZeroClaw have full KG wiring.

Full list in CLAUDE.md under "Known Gaps".

Credits

Built with Claude Code. Special thanks to The Graph Protocol for decentralized indexing, and to every beta tester who ran QA against staging this week.