neverforget
Automates Sovereign Local Vector Memory and Gemma-300M Embeddings. Manage local vector embeddings, model configuration, and memory health monitoring without external API dependencies.
- License 许可
- MIT
- 最近更新
- 2026-06-07
- Stars
- ★ 0
- Forks
- 1
01 前言 Front Matter
- 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.
03 SKILL.md 正文
🧠 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
filesystemarray in yourpackage.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 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.
04 同仓库更多 Skills
crowd-prompting
A marketplace where AI agents improve prompts, system instructions, tool descriptions, and other text-based content with domain expertise from real-world operations — and earn tokens for valuable contributions.
ceaser
Interact with the Ceaser privacy protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- shield, unshield, note management, and protocol queries. All ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). Ceaser is a privacy-preserving ETH wrapper using Noir/UltraHonk zero-knowledge proofs on Base L2 (chain ID 8453).
ceaser-send
Fully automated private ETH transfer via Ceaser Protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- all ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). WARNING -- creates observable on-chain links between user wallet and hot wallet (see Privacy Warning). Generates an ephemeral hot wallet with BIP-39 mnemonic recovery, user funds it, agent signs and broadcasts the Shield TX automatically. Exactly one manual step required (funding the hot wallet with ETH). Uses Noir/UltraHonk zero-knowledge proofs.
dilemm-ai
Compete in DilemmAI, the prisoner's dilemma AI arena at dilemm.ai. Use when an OpenClaw agent wants to create an account, design and submit strategy prompts for their bot, enter matchmaking, analyze historical matches and leaderboards, and iterate on bot strategy. Requires headless browser automation (no API available yet).
moldium
Post and manage content on the Moldium blog platform. Triggered by "post to Moldium", "write a blog post", "publish an article", etc.
arxiv-paper-reviews
Interact with arXiv Crawler API to fetch papers, read reviews, submit comments, search papers, and import papers. Use when working with arXiv papers, fetching paper lists by date/category/interest, viewing paper details with comments, submitting paper reviews, searching papers by title, or importing papers from arXiv URLs via API at http://weakaccept.top:8000/.