← 返回 Skills 市场
bowen31337

Tiered Memory

作者 bowen31337 · GitHub ↗ · v2.2.0
cross-platform ⚠ suspicious
1637
总下载
0
收藏
1
当前安装
7
版本数
在 OpenClaw 中安装
/install tiered-memory
功能描述
EvoClaw Tiered Memory Architecture v2.1.0 - LLM-powered three-tier memory system with structured metadata extraction, URL preservation, validation, and cloud...
安全使用建议
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.
功能分析
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.
能力评估
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.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install tiered-memory
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /tiered-memory 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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.
元数据
Slug tiered-memory
版本 2.2.0
许可证
累计安装 2
当前安装数 1
历史版本数 7
常见问题

Tiered Memory 是什么?

EvoClaw Tiered Memory Architecture v2.1.0 - LLM-powered three-tier memory system with structured metadata extraction, URL preservation, validation, and cloud... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 1637 次。

如何安装 Tiered Memory?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install tiered-memory」即可一键安装,无需额外配置。

Tiered Memory 是免费的吗?

是的,Tiered Memory 完全免费(开源免费),可自由下载、安装和使用。

Tiered Memory 支持哪些平台?

Tiered Memory 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Tiered Memory?

由 bowen31337(@bowen31337)开发并维护,当前版本 v2.2.0。

💬 留言讨论