BeastXA Memory Pro

Production-grade memory system for OpenClaw agents. Auto-organizes notes into topic files, prevents context loss during compaction, and runs daily/weekly mai...

Security Scan

The skill's files and runtime instructions are consistent with its stated purpose: local-only memory management that modifies the OpenClaw compaction config and installs scheduled maintenance crons; nothing in the package requests unrelated secrets or downloads external code.

Purpose & Capability

Name/description (memory management, splitting, cron maintenance) match the files and scripts. The installer, setup, splitter, and verifier all operate on local Markdown files and the OpenClaw config as advertised. Requesting no env vars and no external services is coherent with the stated purpose.

Instruction Scope

SKILL.md and scripts instruct the agent to modify ~/.openclaw/openclaw.json (backed up) to add compaction/memoryFlush settings, and to create scheduled crons via the openclaw CLI. This is within the claimed scope (enhancing compaction and scheduling maintenance), but it does change agent configuration and installs autonomous maintenance crons — a privileged but explained action. Review the compaction prompt text and cron prompts before installing to ensure they match your desired behavior.

Install Mechanism

No remote downloads or package installs. All code is local (install.sh, Python scripts). The installer runs local Python snippets and calls the openclaw CLI. This is lower-risk than fetching and executing arbitrary remote archives.

Credentials

The skill declares no required environment variables or credentials. The scripts read and write only the user's workspace files and the OpenClaw config (~/.openclaw/openclaw.json), which is justified by the goal of adding compaction behavior and creating local memory files.

Persistence & Privilege

The installer creates OpenClaw cron jobs that will periodically run maintenance tasks (daily and weekly). always:false (not forced) is set, but the cron jobs enable autonomous periodic agent actions. This is expected for an auto-maintenance memory skill, but it increases the skill's runtime presence and potential blast radius — inspect cron prompt text and cron behaviour if you host sensitive data in memory files.

Scan Findings in Context

[no_findings] expected: Static pre-scan reported no injection signals. The package contains local scripts that read/write workspace and OpenClaw config — these behaviors are expected for this skill's stated purpose.

Assessment

This skill appears internally consistent with its documentation: it creates local Markdown memory files, modifies your OpenClaw compaction settings (with a backup), and registers two maintenance cron jobs via the openclaw CLI. Before installing: 1) Inspect scripts/install.sh, scripts/split_memory.py and cron prompt texts to confirm the compaction prompt and cron prompts match your privacy and retention expectations. 2) If you keep sensitive secrets in your MEMORY or workspace files, consider installing in a test workspace first or moving sensitive items out of the memory directory, since cron tasks will read those files. 3) The installer writes to ~/.openclaw/openclaw.json (it makes a timestamped backup) — keep the backup if you want to revert. 4) If you prefer manual control, skip the installer and run the Python scripts and cron setup commands yourself. Overall the package is coherent and local-only, but review the cron prompts and config changes before running the installer.

Stop losing context. Start remembering everything.

What It Does

1. Structured Session Notes — auto-maintained session-notes.md captures your current work state
2. Smart Memory Split — breaks large MEMORY.md into topic files with an index
3. Auto Maintenance — daily cleanup + weekly deep organization via cron
4. Anti-Amnesia — enhanced compaction saves critical context before compression

Quick Start

# Install
clawhub install beastxa-memory-pro

# Run setup (interactive, takes ~30 seconds)
bash scripts/install.sh

That's it. Everything else is automatic.

What Gets Created

your-workspace/
├── memory/
│   ├── session-notes.md          # Live session state (auto-updated)
│   ├── MEMORY-INDEX.md           # Topic file directory
│   ├── YYYY-MM-DD.md             # Daily logs (auto-appended)
│   └── topics/                   # Organized by theme
│       ├── projects.md
│       ├── decisions.md
│       ├── lessons.md
│       └── ...                   # Auto-generated from your content

How It Works

Three-Layer Memory

Layer	File	Purpose	Update Frequency
Session	session-notes.md	Current work state	Every compaction
Daily	YYYY-MM-DD.md	Raw daily log	Every significant event
Topics	topics/*.md	Long-term organized memory	Daily cron

Anti-Amnesia System

Before each context compaction:

1. Saves current task, recent decisions, errors, and next steps
2. Writes to both session-notes.md and daily log
3. After compaction, agent reads session-notes and resumes seamlessly

Auto Maintenance Crons

• Daily (23:30) — extracts key decisions and lessons from today's log into topic files
• Weekly (Sunday 23:00) — deduplicates, merges, trims topic files; verifies index

Manual Commands

Split an existing MEMORY.md:

python3 scripts/split_memory.py --input MEMORY.md --output memory/topics/

• Reads your MEMORY.md, detects topic boundaries (## headers)
• Creates one file per topic in memory/topics/
• Generates memory/MEMORY-INDEX.md with pointers
• Original file untouched — zero risk

Verify installation:

bash scripts/verify.sh

Configuration

The install script adds compaction enhancement to your OpenClaw config:

{
  "agents": {
    "defaults": {
      "compaction": {
        "memoryFlush": {
          "enabled": true,
          "prompt": "Pre-compaction memory flush. Store durable memories in memory/YYYY-MM-DD.md..."
        },
        "instructions": "Preserve: user decisions, file paths, errors+fixes, current task, next step..."
      }
    }
  }
}

You can customize the compaction instructions to match your workflow.

FAQ

Will it overwrite my existing MEMORY.md? Never. The split script only reads it. Your original stays intact.

Does it send data anywhere? No. Everything is local Markdown files. No APIs, no cloud, no external services.

Can I use it with other memory skills? Yes. It only creates files and cron jobs — no core modifications.

What if I don't like the topic categories? Edit them freely. They're just Markdown files. The cron will respect your structure.

Requirements

• OpenClaw 2026.3.x or later
• Python 3.8+ (for split script)
• That's it