← 返回 Skills 市场
strangeadvancedmarketing

Adam Framework

作者 strangeadvancedmarketing · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ⚠ suspicious
235
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install adam-framework
功能描述
5-layer persistent memory and coherence architecture for OpenClaw agents. Solves AI amnesia and within-session drift. Built and validated over 353 sessions o...
使用说明 (SKILL.md)

Adam Framework

AI Amnesia — Solved. Within-Session Coherence Degradation — Solved.

The Adam Framework is a 5-layer persistent memory architecture for OpenClaw agents, developed over 8 months across 353 sessions on a live business by a non-coder running consumer hardware.

OpenClaw just got acquired by OpenAI. Your memory layer shouldn't be.

What It Solves

  • AI Amnesia — your agent wakes up blank every session, forcing you to re-explain context, projects, and goals that should already be known
  • Within-Session Drift — as a session accumulates context, the model's reasoning consistency quietly degrades before compaction triggers

The 5 Layers

Layer Component What It Does
1 Vault injection via SENTINEL Identity files loaded at every boot. Agent wakes up knowing who it is.
2 memory-core plugin Live memory search mid-session via memory_search / memory_get tools
3 Neural graph (nmem_context) Associative recall — 12,393 neurons, 40,532 synapses. Concepts link to concepts.
4 Nightly reconciliation Gemini merges daily logs into CORE_MEMORY.md while you sleep. Nothing lost.
5 Coherence monitor Scratchpad dropout detector — fires re-anchor before drift causes damage. 33 tests passing.

The Key Insight

The memory is in the files. The model is just the reader.

When the system was completely wiped and rebuilt from scratch, the agent came back online with full continuity — because the identity files survived. Swap the LLM, keep the Vault. Memory persists.

Setup

Two paths — pick one:

Path 1 — You do it yourself (30–60 min) Read SETUP_HUMAN.md. Plain English, no technical background assumed.

Path 2 — Let your agent handle it Paste SETUP_AI.md into your OpenClaw chat. It asks 8 questions and does the install itself.

Prerequisites

  • OpenClaw running with any model
  • Python 3.10+
  • npm install -g mcporter
  • NVIDIA Developer free tier API key (Kimi K2.5, 131K context, free)
  • Gemini API key (free) for nightly reconciliation

Links

安全使用建议
Things to consider before installing or letting the agent 'auto-install': - Metadata vs reality: The registry lists no required env vars or binaries, but the SKILL.md and docs require an LLM API key (or specific NVIDIA Developer key), a Gemini API key, npm tooling, and will copy/run Python scripts — treat the registry omission as a red flag and expect to provide secrets. - Secrets exposure: You will be asked for at least one LLM API key and (per the docs) a Gemini API key. Only provide keys you control, and consider creating scoped/limited keys or ephemeral credentials where possible. Do not reuse high-privilege or long-lived master keys. - Review code first: The package contains scripts that read session JSONL logs and write to BOOT_CONTEXT.md and other Vault files; review SENTINEL templates, coherence_monitor.py, and reconcile_memory.py before running them. Prefer manual execution in a sandbox/VM first. - Avoid automatic 'paste-to-agent' installs: The 'Path 2 — Let your agent handle it' flow would let an agent modify your filesystem and install software. If you lack strong trusts or auditing, use the manual Path 1 and follow SETUP_HUMAN.md step-by-step instead. - Backup your Vault and configs: Before running any install, back up your Vault (CORE_MEMORY.md, SOUL.md, workspace/*) and openclaw config. If SENTINEL or reconcile runs write unexpected content, you can recover. - Limit network access where feasible: The design is 'local-first' but uses external reconciliation (Gemini). If you want strictly local operation, audit and disable reconcile steps that call external APIs. - Prefer least privilege: For Telegram/OpenClaw gateway tokens create dedicated tokens with narrow scopes and restrict network exposure. Monitor created files (reanchor_pending.json, BOOT_CONTEXT.md) for unexpected content. - What would reduce my concern: registry metadata that accurately lists required env vars and binaries, a published homepage or verified source, an install spec (package or signed release) instead of manual copy steps, and explicit notes about what network calls the nightly reconcile makes (endpoints, data sent).
功能分析
Type: OpenClaw Skill Name: adam-framework Version: 1.0.1 The Adam Framework is a complex memory persistence system that requires and configures extremely high-privilege access to the host environment. Key indicators include the configuration of the 'desktop-commander' MCP server (engine/mcporter.template.json), which grants the AI agent full terminal and filesystem access, and the 'SENTINEL' watchdog scripts (engine/SENTINEL.template.sh) that manage local processes and system-level persistence via scheduled tasks or cron jobs. Additionally, the bundle includes a script (tools/update_live_stats.py) that performs automated 'git push' operations, posing a risk of accidental credential or data exposure. While these capabilities are aligned with the stated goal of creating a 'persistent memory architecture,' the combination of broad system access and instructions for the AI to perform its own high-privilege setup (SETUP_AI.md) creates a significant security risk without clear evidence of intentional malice.
能力评估
Purpose & Capability
The skill claims a local-first memory/coherence framework, which plausibly needs local scripts and an LLM key, but SKILL.md explicitly asks for multiple external API keys (NVIDIA Developer model key and a Gemini API key) and npm tooling. The registry metadata lists no required env vars or binaries — that's a clear mismatch. The presence of many utility scripts and a server component (mcp-server, SENTINEL templates, reconciliation scripts) is coherent with the described purpose, but the omission of declared requirements in the metadata is inconsistent and unexpected.
Instruction Scope
Runtime instructions (SKILL.md, AGENTS.md, docs) direct reading and writing of user vault files (BOOT_CONTEXT.md, CORE_MEMORY.md, session JSONL), running a periodic coherence_monitor, and performing a nightly reconciliation that calls out to Gemini. Those actions are within the framework's stated purpose, but they touch sensitive local state (session logs, vault files, gateway config) and the instructions provide an automated 'Path 2' install via pasting SETUP_AI.md into the agent — which would allow the agent to modify local files and install components autonomously. AGENTS.md simultaneously warns agents 'Never touch live vault files', which is contradictory with other parts that instruct copying scripts into the live Vault and running them.
Install Mechanism
The registry lists no install spec, but the bundle includes many executable scripts, Python tools, requirements.txt, and SENTINEL templates that are intended to be copied into the user's Vault and run. There is no packaged, vetted install delivery in the registry metadata — setup is driven by README/SETUP docs and agent-driven installation instructions. That increases risk because arbitrary repo files would be copied and run on the operator's machine without an auditable package/install step described in the registry.
Credentials
SKILL.md and docs request multiple credentials and tokens (LLM provider API key, NVIDIA Developer key, Gemini API key, OpenClaw gateway token, optional Telegram token, Firecrawl, etc.), yet the registry metadata declares no required env vars or primary credential. Requesting both a runtime LLM key and a separate 'Gemini' key for offline reconciliation is plausible for the design (using one model for runtime and another for nightly consolidation), but it's a material increase in secret exposure — and the metadata mismatch prevents the platform/user from seeing upfront what secrets are needed.
Persistence & Privilege
The skill does not set always:true and does not itself modify other skills in the metadata. However, its recommended setup deploys SENTINEL watchdog scripts that run periodically, copies tools into a user's Vault, and configures a sleep/reconcile cycle — giving it ongoing disk presence and recurring execution on the host. That persistence is consistent with its purpose but raises the usual operational-risk considerations (scripts that run regularly and write to BOOT_CONTEXT.md/session files).
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install adam-framework
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /adam-framework 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.1
Version 1.0.1 (adam-framework) - No file changes detected in this release. - No new features, fixes, or documentation updates.
v1.0.0
adam-framework 1.0.0 – Initial Release - Introduces a 5-layer persistent memory and coherence architecture for OpenClaw agents. - Solves AI amnesia and session drift, enabling agents to maintain identity and project continuity across sessions. - Requires no coding background; setup can be manual or agent-driven. - Built and validated over 353 real business sessions. - Open source with comprehensive documentation and live evidence provided.
元数据
Slug adam-framework
版本 1.0.1
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 2
常见问题

Adam Framework 是什么?

5-layer persistent memory and coherence architecture for OpenClaw agents. Solves AI amnesia and within-session drift. Built and validated over 353 sessions o... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 235 次。

如何安装 Adam Framework?

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

Adam Framework 是免费的吗?

是的,Adam Framework 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Adam Framework 支持哪些平台?

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

谁开发了 Adam Framework?

由 strangeadvancedmarketing(@strangeadvancedmarketing)开发并维护,当前版本 v1.0.1。

💬 留言讨论