← Back to Skills Marketplace
191
Downloads
0
Stars
1
Active Installs
8
Versions
Install in OpenClaw
/install tiered-recall
Description
分层回忆系统,解决上下文长度限制,保持项目延续性。默认自动加载最近7天记忆,支持手动全量回忆、自定义天数、项目回忆和主题回忆。当前版本采用 slim index,只保留文件名、行号和标题,不存摘要,避免 token 膨胀。
Usage Guidance
What to check before installing:
- Review and fix scripts/check_index.py: it uses a hardcoded absolute path (C:/Windows/System32/UsersAdministrator.openclawworkspace/...) which is likely a mistake and could try to read unexpected system paths. Remove or parameterize that path.
- Confirm activation behavior: clawhub.json sets auto activation on session start. If you prefer explicit control, ask the author to disable automatic triggering or require confirmation before running.
- Inspect projectPatterns and config (project paths and keyFiles). The loader will attempt to read files under those paths — ensure no sensitive files (credentials, private keys, tokens, secrets) are present in the workspace directories matched by these patterns.
- Check .tiered-recall output files (index.json, projects.json, state.json) to ensure they don't accidentally include full text summaries you don't want stored; scripts claim a slim index but check_index.py references a summary field ('s') — verify the actual index content.
- Run the scripts in an isolated test workspace first (copy a small set of safe .md files) to observe behavior, outputs, and any unexpected file reads/writes.
- If you need stronger guarantees, request the maintainer to: (1) remove/test-only hardcoded paths, (2) document and limit auto-activation, and (3) add explicit checks to avoid reading files outside the intended workspace path.
Confidence: medium — the skill appears coherent with its stated purpose but the hardcoded path, manifest activation mismatch, and minor implementation inconsistencies warrant caution and pre-install review.
Capability Analysis
Type: OpenClaw Skill
Name: tiered-recall
Version: 1.2.2
The 'tiered-recall' skill is a memory management system designed to help AI agents maintain context across sessions by indexing and retrieving local Markdown logs. Analysis of the Python scripts (build-index.py, load.py) and configuration files shows no evidence of data exfiltration, malicious execution, or unauthorized access. The skill operates entirely within the local workspace as defined in clawhub.json. A hardcoded Windows path in scripts/check_index.py appears to be a developer debugging artifact and does not pose a security risk.
Capability Assessment
Purpose & Capability
技能名称、说明、SKILL.md 与 scripts/*.py 的行为基本一致:扫描 workspace 的 memory/*.md、生成 slim index(只保留文件名/行号/标题)、并按层级加载记忆用于会话恢复。要求的读/写 workspace 文件与记忆系统的目的相符。但 clawhub.json 中声明 activation.auto=true(在 session:start 自动触发)与上游给出的 flags(always: false)之间存在不一致,应确认实际平台激活行为。
Instruction Scope
运行时会读取 workspace 下的 MEMORY.md、memory/*.md、.tiered-recall/index.json、projects.json,并会尝试读取项目 keyFiles(例如项目路径下的 index.html 等)。这和记忆/项目回忆的目的相关,但 scripts/check_index.py 包含一个硬编码的绝对路径(C:/Windows/System32/...)并读取该位置的 index.json,这明显不在技能说明的范围内,可能是测试遗留或误配置;此外 check_index.py 输出中展示了摘要字段(s),与“slim index 不存摘要”的宣称不一致。请在安装前修正或移除该脚本或确认其路径。
Install Mechanism
这是一个 instruction-only 技能(没有 install spec),主逻辑以 Python 脚本实现并包含在包内;没有下载/外部执行器,安装风险低。
Credentials
技能不请求环境变量或外部凭据。clawhub.json 列出的权限(read:files, write:files, read:memory, write:memory)与记忆系统用途相匹配且未要求未说明的凭据或外部访问。
Persistence & Privilege
包内 clawhub.json 指示 activation.auto=true、triggers: ["session:start"](即可能自动在新会话触发并读取工作区记忆)。虽然技能顶层 flags 显示 always:false,这里的 manifest 自动激活能力需要澄清:若技能确实在每次 session:start 自动运行,它会在没有额外确认下读取工作区文件,扩大数据暴露面。
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install tiered-recall - After installation, invoke the skill by name or use
/tiered-recall - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.2
自动7天 + 手动全量/自定义天数 + slim index,作为 jarvis-core 的稳定依赖版本同步发布。
v1.2.1
Republish bugfix build: slim L3 index (no summaries) to prevent token bloat.
v1.2.0
改为自动7天 + 手动全量/自定义天数
v1.1.0
v1.1.0 brings better navigation for recall:
- Memory index now adds a 10-character ultra-short summary to make it easier to distinguish items with the same name.
- Scripts updated to generate/store these summaries in the index.
- Documentation updated to describe the new summary field and its benefits.
- No breaking changes to configuration or workflow.
v1.0.3
- 索引结构增加标题字段,提升导航能力且几乎不增加token消耗。
- 新增 scripts/check_index.py 脚本用于校验索引一致性。
- 优化 build-index.py 与 load.py 实现,支持新索引格式。
- 文档与 changelog 更新,反映索引结构与主要变更。
v1.0.2
- 修复了 scripts/load.py 的兼容性问题
- 移除了 TECHNICAL_EVALUATION.md 和 scripts/evaluate.py
- 更新并简化文档与索引说明
v1.0.1
v1.0.1: 索引精简优化,token消耗降低62%。
- 优化索引生成逻辑,移除冗余内容,大幅减少 index.json 体积
- 降低 L3 层记忆索引的默认 token 占用,提升整体加载效率
- 新增 TECHNICAL_EVALUATION.md,便于评估与未来改进
- 增加 scripts/evaluate.py,支持自动化效果分析
v1.0.0
Tiered Recall v1.0.0 – 初始发布
- 支持分层自动加载(核心记忆、近期日志、活跃项目、记忆索引),显著提升多项目与跨天任务上下文延续性
- 提供手动深度回忆功能,按项目、天数、关键词灵活检索历史记忆
- 内置token预算控制与动态加载机制,确保记忆提取高效且资源可控
- 附带脚本工具实现记忆索引和活跃项目自动检测及管理
Metadata
Frequently Asked Questions
What is 🧠 Tiered Recall - 分层回忆系统?
分层回忆系统,解决上下文长度限制,保持项目延续性。默认自动加载最近7天记忆,支持手动全量回忆、自定义天数、项目回忆和主题回忆。当前版本采用 slim index,只保留文件名、行号和标题,不存摘要,避免 token 膨胀。 It is an AI Agent Skill for Claude Code / OpenClaw, with 191 downloads so far.
How do I install 🧠 Tiered Recall - 分层回忆系统?
Run "/install tiered-recall" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is 🧠 Tiered Recall - 分层回忆系统 free?
Yes, 🧠 Tiered Recall - 分层回忆系统 is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does 🧠 Tiered Recall - 分层回忆系统 support?
🧠 Tiered Recall - 分层回忆系统 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created 🧠 Tiered Recall - 分层回忆系统?
It is built and maintained by davidme6 (@davidme6); the current version is v1.2.2.
More Skills