Plugin
by @p-diogo
End-to-end encrypted memory for AI agents — portable, yours forever. XChaCha20-Poly1305 E2EE: server never sees plaintext.
Default configuration values:
| Key | Default | Description |
|-----|---------|-------------|
| serverUrl | https://api.totalreclaw.xyz | TotalReclaw server URL (do not change unless self-hosting) |
| autoExtractEveryTurns | 3 | Turns between automatic extractions |
| minImportanceForAutoStore | 6 | Minimum importance to auto-store |
| maxMemoriesInContext | 8 | Maximum memories to inject into context |
| forgetThreshold | 0.3 | Decay score threshold for eviction |
| decayHalfLifeDays | 30 | Memory decay half-life in days |
Memory Consolidation Configuration
Store-time near-duplicate detection is always on — the TOTALRECLAW_STORE_DEDUP
user-facing toggle was removed in v1. Advanced thresholds can still be tuned
via env var for self-hosted deployments:
| Env Var | Default | Description |
|---------|---------|-------------|
| TOTALRECLAW_STORE_DEDUP_THRESHOLD | 0.85 | Cosine similarity threshold for store-time dedup (0-1) |
| TOTALRECLAW_CONSOLIDATION_THRESHOLD | 0.88 | Cosine similarity threshold for bulk consolidation (0-1) |
Managed-service tenants receive the tuning values from the relay billing
response — these env vars act as fallbacks only. See
docs/guides/env-vars-reference.md.
1. Atomic Facts Only: Each memory should be a single, atomic piece of information. - Good: "User prefers dark mode in all editors" - Bad: "User likes dark mode, uses VS Code, and works at Google"
2. Importance Scoring: - 1-3: Trivial, unlikely to matter (small talk, pleasantries) - 4-6: Useful context (tool preferences, working style) - 7-8: Important (key decisions with reasoning, project context, major preferences) - 9-10: Critical (core values, non-negotiables, safety info)
3. Search Before Storing: Always recall similar memories before storing new ones to avoid duplicates.
4. Respect User Privacy: Never store sensitive information (passwords, API keys, personal secrets) even if requested.
5. Prefer NOOP: When in doubt about whether to store something, prefer not storing it. Memory pollution is worse than missing a minor fact.
clawhub install totalreclaw-retired-2026-04