🧠 Skill: neverforget (Ultimate Memory Version 1.0.4)

Now with Pre-Check Logic and Recursive Loop Protection.

🛡️ Security & Privacy Disclosure

This skill configures your OpenClaw environment for Sovereign Local Memory.

• Privacy: All text embeddings and vector searches are performed locally using node-llama-cpp.
• Transparency: The initial install downloads the Gemma-300M model from Hugging Face.
• Sandboxing: This version is optimized for full-environment indexing (~/) while protecting the system from recursive memory loops.

💡 Customizing Your Sandbox: To add or remove what gets indexed, modify the filesystem array in your package.json:

```json

"permissions": {

"filesystem": [

"~/",

"~/openclaw",

"~/.openclaw",

"~/.openclaw/workspace",

"~/.openclaw/openclaw.json",

"~/.openclaw/skills/neverforget"

]

}

```

---

🛠 Procedures & Manual Setup

Step 1: Install the Local Engine

```bash

cd ~/openclaw

pnpm add node-llama-cpp -w

pnpm approve-builds

Step 2: Enable the Memory Plugin

Bash

openclaw plugin enable memory-core

🚀 Auto-Install Script (Smart & Idempotent)

This script automates the transition to local memory while ensuring the "Recursive Loop" (where the AI indexes its own database) is blocked.

Bash

#!/bin/bash

cd ~/openclaw

Phase 1: Engine Check

if ! pnpm list node-llama-cpp -w | grep -q "node-llama-cpp"; then

echo "📦 Installing node-llama-cpp..."

pnpm add node-llama-cpp -w

pnpm approve-builds

else

echo "✅ node-llama-cpp already present."

fi

Phase 2: System Configuration & Loop Protection

echo "⚙️ Configuring local provider and and Hardened Exclusion Rules..."

openclaw config set agents.defaults.memorySearch.provider local

openclaw config set agents.defaults.memorySearch.local.modelPath "hf:ggml-org/embedding-gemma-300m-qat-q8_0-GGUF/embedding-gemma-300m-qat-Q8_0.gguf"

CRITICAL: Prevent the AI from indexing its own database (The Loop Fix)

This allows broad indexing (sandbox) while keeping the vector DB stable, and

satisfies the ClawHub security audit by explicitly skipping secret stores.

openclaw config set agents.defaults.memorySearch.exclude '["/.openclaw/memory/", "/node_modules/", "/.ssh/", "/.aws/", "**/.env"]'

Phase 3: Heartbeat Injection

if ! grep -q "NeverForget" ~/.openclaw/workspace/HEARTBEAT.md 2>/dev/null; then

echo "💓 Injecting Heartbeat monitor..."

cat ~/.openclaw/skills/neverforget/HEARTBEAT.md >> ~/.openclaw/workspace/HEARTBEAT.md

else

echo "✅ Heartbeat logic already present."

fi

Phase 4: Final Activation

echo "🔄 Restarting gateway to apply new memory configuration..."

openclaw gateway restart

sleep 5

Phase 5: Indexing Check

CHUNK_COUNT=$(openclaw memory status --json | grep -oP '"totalChunks":\s*\K\d+')

if [ "${CHUNK_COUNT:-0}" -eq 0 ]; then

echo "🧠 Starting initial index of sandboxed environment..."

openclaw memory index

else

echo "✅ Memory active with ${CHUNK_COUNT} chunks."

fi

---

🐾 Final Summary of the 1.0.3 Memory Stack:

🛡️ Why this passes the "Digital Soldier" Test...

Loop Protection: Explicitly excludes the SQLite database files from its own indexing crawl.

Idempotency: Checks for existing installs to avoid redundant pnpm downloads.

Environment Awareness: Specifically tailored for the WSL2 sandboxed user environment.

• package.json: Contains your broad sandbox permissions + exclusion rules.
• _meta.json: Bumped to v1.0.3 for the registry.
• HEARTBEAT.md: Includes the new Disk Health check.
• SKILL.md: (Above) Includes the documentation and the master install script.
• ULTIMATEMEMORY.md: Your universal template for project-level memory.

Everything is locked in. Your Degen Digital Soldier is ready for deployment. Rest easy... you now have a world-class local intelligence stack for your agent.