🧠 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:

"permissions": {
  "filesystem": [
    "~/",
    "~/openclaw",
    "~/.openclaw",
    "~/.openclaw/workspace",
    "~/.openclaw/openclaw.json",
    "~/.openclaw/skills/neverforget"
  ]
}

🛠 Procedures & Manual Setup

Step 1: Install the Local Engine

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...