← 返回 Skills 市场
1041
总下载
2
收藏
11
当前安装
4
版本数
在 OpenClaw 中安装
/install total-recall
功能描述
The only memory skill that watches on its own. No database. No vectors. No manual saves. Just an LLM observer that compresses your conversations into priorit...
安全使用建议
Key things to check before installing:
- Verify declared requirements: the registry metadata did not list required env vars but SKILL.md and scripts require an LLM API key (OPENROUTER_API_KEY / LLM_API_KEY). Confirm which keys are actually needed and where they will be used.
- Audit the scripts (setup.sh, observer-*.sh, reflector-*.sh, dream-cycle.sh, session-recovery.sh) before running setup.sh. setup.sh will create memory/ and logs/, install cron jobs and (on Linux) a systemd watcher — review and optionally run the commands manually rather than blindly executing setup.sh.
- Start in safe mode: run Dream Cycle in READ_ONLY_MODE=true and run observer scripts manually to see outputs before enabling automatic writes. The prompts default to writing (READ_ONLY_MODE=false) if you don't explicitly set this.
- Consider using a local LLM endpoint first (LLM_BASE_URL pointing to localhost) or a dummy API key during evaluation to avoid sending your session data to a remote provider until you are comfortable. If you must use a hosted provider, be aware that session transcripts and derived observations will be transmitted to that provider.
- Check cron/systemd entries that will be created and remove or restrict them if you prefer manual invocation. Back up your current workspace and existing memory/observations.md before enabling automatic schedules.
- Be cautious about the memoryFlush config: it instructs an agent turn to run the observer and to write a session summary automatically. If you keep that hook, that summary will be generated and persisted at compaction time.
If you want, I can: (1) list the exact files/lines in setup.sh that create services/crontab entries, (2) summarize which scripts call network endpoints and where, or (3) produce a safe checklist to run the skill in read-only/evaluation mode.
功能分析
Type: OpenClaw Skill
Name: total-recall
Version: 1.5.1
The skill is classified as suspicious due to its extensive use of high-risk capabilities, including direct shell command execution (`exec: bash`, `Run bash`) via agent instructions in `config/memory-flush.json`, `templates/AGENTS-snippet.md`, and `config/cron-job.json`. It also installs a systemd service (`scripts/setup.sh`) and performs `git reset --hard` (`scripts/dream-cycle.sh`). While these actions are integral to the skill's stated purpose of autonomous memory management and include explicit defenses against prompt injection (e.g., path traversal protection in `scripts/dream-cycle.sh` and `scripts/staging-review.sh`, and instructions to the agent not to write to sensitive files in `prompts/dream-cycle-prompt.md`), the inherent power of these operations and the potential for a sophisticated prompt injection or a compromised LLM to bypass defenses elevate the risk beyond benign. There is no evidence of intentional malicious behavior such as data exfiltration to unauthorized endpoints or stealthy backdoors.
能力评估
Purpose & Capability
The skill's stated purpose (autonomous, file-backed memory watcher) aligns with the included scripts that read session JSONL and write observations.md. However the registry metadata claims 'Required env vars: none' while SKILL.md and scripts require an LLM API key (OPENROUTER_API_KEY / LLM_API_KEY) and other provider config; changelog mentions ANTHROPIC_API_KEY for a backfill script. That mismatch between declared registry requirements and the actual SKILL.md/scripts is an incoherence that matters: the skill will expect credentials not advertised by the registry.
Instruction Scope
The runtime instructions and bundled prompts direct agents to read session transcript files (SESSIONS_DIR), run scripts that append/modify memory files, and hook into OpenClaw compaction (memoryFlush). The skill includes several system-agent prompts (observer, reflector, dream-cycle) that assume the agent will run sub-agents and may perform writes. The Dream Cycle prompt defaults to READ_ONLY_MODE=false (i.e., write-enabled) if not explicitly set, and memoryFlush instructs an immediate --flush capture and then asks the agent to 'write a brief summary of THIS session' and 'Reply with NO_REPLY' — this is effectively a behavior override that will cause the agent to persist session content. These instructions stay within the stated purpose (capturing conversation), but they also grant broad rights to read session data and autonomously write/modify files and archives — and include directives that look like system-prompt overrides. That elevated autonomy and the default-to-write behavior are risky without explicit user opt-in.
Install Mechanism
There is no automated install spec (no remote download/extract), but the package includes many shell scripts and a setup.sh that will create directories, install a systemd watcher service (on Linux), and print cron instructions. No third-party binary downloads were detected in the manifest, which reduces remote-code-fetch risk, but running setup.sh will grant the skill persistent cron/systemd presence and create files under your workspace — review setup.sh and any systemd unit templates before running.
Credentials
A memory skill legitimately needs an LLM key to compress transcripts, so requesting OPENROUTER_API_KEY / LLM_API_KEY is proportionate. The problem is inconsistency: registry metadata lists no required env vars but SKILL.md marks OPENROUTER_API_KEY required and other scripts reference ANTHROPIC_API_KEY (backfill). The skill also documents various configurable URLs/keys and encourages setting LLM_BASE_URL/OBSERVER_API_URL, and some code paths will accept a dummy OPENROUTER_API_KEY for local models (odd fallback). Before installing, confirm which keys are actually required, and be aware: any remote provider key you supply will result in session data being sent off-host to that provider unless you configure a local LLM endpoint.
Persistence & Privilege
The skill asks to persistently run via cron and an optional systemd watcher and writes memory/ and logs/ files. 'always' is false (good), but the skill's default prompts (Dream Cycle default READ_ONLY_MODE=false) and cron/systemd setup mean it will autonomously modify observations.md and archive files if you follow the setup instructions. That combination (autonomous writes + system services + default write mode) increases blast radius compared with a purely manual tool. It does not auto-enable itself at platform level, but setup.sh will create persistent system-level jobs that run unattended.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install total-recall - 安装完成后,直接呼叫该 Skill 的名称或使用
/total-recall触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.5.1
Documentation cleanup: removed internal development phases and work package references, made all docs user-facing
v1.5.0
Phase 2 Complete: The Wisdom Builder. WP2 importance decay + WP4 pattern promotion pipeline. All 6 work packages live and validated. Zero false archives across all runs.
v1.0.1
• Version: 1.0.1
• CHANGELOG:
`Security hardening — .env loading now only reads OPENROUTER_API_KEY instead of all environment variables.
No functional changes.`
v1.0.0
Total Recall 1.0.0 — Autonomous, database-free memory skill
- Adds a fully automated memory system that compresses conversations into prioritized notes with no databases or manual saves required.
- Includes five layers: Observer (cron task), Reflector (auto consolidation), Session Recovery, Reactive Watcher (Linux/inotify), and Pre-compaction hook for robust redundancy.
- Works cross-platform (portable Bash); full event-driven support on Linux, cron-only on macOS.
- Extremely low maintenance and low monthly cost (~$0.10), no vectors or user intervention needed.
- Easy setup via script; environment configuration and customization through prompts supported.
- Designed for cross-session recall and context-injection into agent prompts.
元数据
常见问题
Total Recall 是什么?
The only memory skill that watches on its own. No database. No vectors. No manual saves. Just an LLM observer that compresses your conversations into priorit... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 1041 次。
如何安装 Total Recall?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install total-recall」即可一键安装,无需额外配置。
Total Recall 是免费的吗?
是的,Total Recall 完全免费(开源免费),可自由下载、安装和使用。
Total Recall 支持哪些平台?
Total Recall 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Total Recall?
由 gavdalf(@gavdalf)开发并维护,当前版本 v1.5.1。
推荐 Skills