← Back to Skills Marketplace
strangeadvancedmarketing

Adam Framework

by strangeadvancedmarketing · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ⚠ suspicious
235
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install adam-framework
Description
5-layer persistent memory and coherence architecture for OpenClaw agents. Solves AI amnesia and within-session drift. Built and validated over 353 sessions o...
README (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

Usage Guidance
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).
Capability Analysis
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.
Capability Assessment
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).
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install adam-framework
  3. After installation, invoke the skill by name or use /adam-framework
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Slug adam-framework
Version 1.0.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is 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... It is an AI Agent Skill for Claude Code / OpenClaw, with 235 downloads so far.

How do I install Adam Framework?

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

Is Adam Framework free?

Yes, Adam Framework is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Adam Framework support?

Adam Framework is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Adam Framework?

It is built and maintained by strangeadvancedmarketing (@strangeadvancedmarketing); the current version is v1.0.1.

💬 Comments