Neverforget

SKILL.md

---
name: neverforget
version: 1.0.4
description: Automates Sovereign Local Vector Memory and Gemma-300M Embeddings. Manage local vector embeddings, model configuration, and memory health monitoring without external API dependencies.
---

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