← Back to Skills Marketplace
bowen31337

Tiered Memory

by bowen31337 · GitHub ↗ · v2.2.0
cross-platform ⚠ suspicious
1637
Downloads
0
Stars
1
Active Installs
7
Versions
Install in OpenClaw
/install tiered-memory
Description
EvoClaw Tiered Memory Architecture v2.1.0 - LLM-powered three-tier memory system with structured metadata extraction, URL preservation, validation, and cloud...
Usage Guidance
This skill appears to implement the memory system it promises, but there are important privacy and configuration issues you should consider before installing: - Credentials and endpoints: The README and CLI indicate you must provide a Turso DB URL/token and may supply LLM endpoints (HTTP). The registry metadata did not declare these required environment variables — verify and be prepared to provide secrets if you enable cloud sync or LLM features. - Data that may be uploaded: Hot memory explicitly contains owner identity/profile, family names, events, tasks and other personal context. The 'sync-critical' operation and cold storage (Turso) will transmit that data to the cloud. If you enable LLM distillation/search with external endpoints, portions of conversation text (and extracted metadata like URLs, commands, file paths) will be sent to that endpoint. - Principle of least privilege: If you decide to use this skill, prefer local-only operation first: avoid configuring an external Turso DB or remote LLM endpoint until you audit the code and are confident in the destination. Use localhost or a controlled internal LLM endpoint instead of public endpoints. - Audit the code paths: The code calls urllib.request.urlopen to user-supplied endpoints and subprocess to run memory_cli.py from metrics_tracker. Review/limit what files are passed into distillation/metadata extraction and where the workspace path points (WORKSPACE env var) to avoid accidental exposure of unrelated files. - Test safely: Run the scripts in a sandboxed environment with test data (no real PII) and without setting Turso/remote LLM configs. If you intend to enable cloud sync, inspect and, if necessary, redact sensitive fields before upload or add encryption/ACL protections on the destination DB. - If you need help deciding: ask the author (if known) for explicit declaration of required env vars and a clear privacy statement explaining exactly which fields get synced and how they are protected in transit and at rest. Given the declared functionality, these issues may be benign design choices, but the lack of declared credentials and the potential to send sensitive local context to external services are reasons to proceed cautiously.
Capability Analysis
Type: OpenClaw Skill Name: tiered-memory Version: 2.2.0 The skill implements a tiered memory system for AI agents, involving local file storage, interaction with LLM endpoints, and cloud synchronization with Turso DB. While its core functionality aligns with the stated purpose, it is classified as 'suspicious' due to the inherent risks associated with its design patterns. Specifically, the extensive use of `subprocess.run` for inter-script communication and external tool calls, although currently implemented with apparent care (e.g., `sanitize_agent_id` for path traversal), represents a powerful primitive that could be vulnerable to shell injection if input sanitization were to fail or be bypassed. Furthermore, the LLM integration, particularly in `_llm_distill_chunk` and `tree_search.py`, constructs prompts using user-provided text (e.g., daily notes, queries). This introduces a significant risk of prompt injection against the integrated LLM, which could lead to unintended or manipulated LLM behavior during distillation or retrieval. There is no evidence of intentional malicious behavior such as unauthorized data exfiltration or persistence mechanisms.
Capability Assessment
Purpose & Capability
Name/description, README, SKILL.md and included scripts align: this is a three‑tier memory system with distillation, tree search, and optional Turso cold storage. Expectation of LLM endpoints and a cloud DB (Turso) is consistent with the stated cloud‑first design. Minor incoherence: the package uses cloud credentials (TURSO_URL/TURSO_TOKEN) and LLM endpoint URLs in its docs and CLI, but the registry metadata declares no required environment variables or primary credential — this mismatch reduces transparency.
Instruction Scope
Runtime instructions and code explicitly read local agent files (memory/YYYY‑MM‑DD.md, memory tree, metrics JSONL) and provide commands to auto‑ingest daily notes, consolidate, and 'sync-critical' hot+tree after conversations. The distiller and tree search can call external LLM endpoints; the sync writes data to cloud cold storage (Turso). These actions match the skill purpose but have broad scope: sensitive owner_profile and hot memory (names, family, events, tasks) may be uploaded or sent to LLMs. The SKILL.md and scripts also extract shell commands and file paths from text — useful for metadata but also capable of harvesting sensitive local paths/commands if invoked on arbitrary content.
Install Mechanism
No install spec (instruction-only) and pure Python scripts with no external package dependencies — low install risk. Nothing is downloaded from unknown URLs during install.
Credentials
The code expects external services (LLM endpoints, a Turso DB) and the README shows setting TURSO_URL/TURSO_TOKEN and LLM endpoints, but the skill metadata lists zero required env vars or credentials. This is a transparency gap: the skill will functionally require secrets/config to perform cloud sync and LLM calls, yet the registry did not declare them. Also metrics_tracker uses a WORKSPACE env var (with a fallback to a parent path) which may cause the tool to read or write outside expected directories if the environment is nonstandard.
Persistence & Privilege
always:false (normal) and user-invocable:true. The skill can be invoked autonomously (disable-model-invocation:false) which is normal for skills. Combine that with its documented behavior to 'sync critical' data to the cloud after every conversation and to call external LLMs: autonomous invocation plus network/cloud sync increases blast radius for data exfiltration if misconfigured. The skill does not declare that it will modify other skills or global config.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install tiered-memory
  3. After installation, invoke the skill by name or use /tiered-memory
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.2.0
v2.2.0: Auto-ingest daily notes during consolidation, fix argparse conflict in store command, fix tree prune crash
v2.1.0
v2.1.0: Structured metadata extraction (URLs, commands, paths), memory validation, enhanced URL preservation during distillation
v2.0.0
Full EvoClaw architecture: LLM tree search, distillation engine, critical sync, multi-agent, metrics
v1.3.0
Age-based cold archival (2-day threshold), hot tier trimming, README added
v1.2.0
Cloud-first architecture: dual-write store to warm+cold, hot-state critical sync to Turso, hot_state table for disaster recovery, cold_restore_hot_state for device replacement. All tiers now cloud-backed.
v1.1.0
Fix cold tier: convert libsql:// to https:// for Turso HTTP API. Fix consolidation: archive evicted warm facts to cold before deletion. Reduce hot tier limit from 5KB to 4KB for headroom.
v1.0.0
Initial release: three-tier memory system (hot/warm/cold) for OpenClaw agents. Fixed-size 5KB hot memory (MEMORY.md), 50KB scored warm tier with decay, unlimited Turso cold archive. Tree index for O(log n) retrieval. Python CLI, zero OpenClaw modifications required.
Metadata
Slug tiered-memory
Version 2.2.0
License
All-time Installs 2
Active Installs 1
Total Versions 7
Frequently Asked Questions

What is Tiered Memory?

EvoClaw Tiered Memory Architecture v2.1.0 - LLM-powered three-tier memory system with structured metadata extraction, URL preservation, validation, and cloud... It is an AI Agent Skill for Claude Code / OpenClaw, with 1637 downloads so far.

How do I install Tiered Memory?

Run "/install tiered-memory" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Tiered Memory free?

Yes, Tiered Memory is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Tiered Memory support?

Tiered Memory is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Tiered Memory?

It is built and maintained by bowen31337 (@bowen31337); the current version is v2.2.0.

💬 Comments