profbernardoj/memory-upgrade
memory-upgrade/SKILL.md
Diagnose and fix broken memory search in OpenClaw. Enables local embeddings, hybrid search (BM25+vector), session transcript indexing, MMR diversity, and temporal decay — all running locally with zero API keys. Use when: memory_search returns empty results, agent has poor cross-session recall, user wants to upgrade their memory system, or after a fresh OpenClaw install.
development
Updated Apr 23, 2026
$ install --global
skillsauthnpx skillsauth add profbernardoj/ethereumclaw.com memory-upgradeInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 30, 2026, 5:25 PM5.9s1 file scanned
SKILL.md
- name:
- memory-upgrade
- description:
- Diagnose and fix broken memory search in OpenClaw. Enables local embeddings, hybrid search (BM25+vector), session transcript indexing, MMR diversity, and temporal decay — all running locally with zero API keys. Use when: memory_search returns empty results, agent has poor cross-session recall, user wants to upgrade their memory system, or after a fresh OpenClaw install.
Memory Upgrade
Most OpenClaw installs have broken memory search — the memory_search tool returns empty results because no embedding provider is configured. OpenClaw auto-detects OpenAI → Google → Voyage keys; if none exist, embeddings stay disabled silently.
This skill fixes it with fully local inference. No API keys. No data leaves the machine.
Quick Start
# 1. Diagnose
bash scripts/diagnose.sh
# 2. Fix (patches openclaw.json, restart [REDACTED] after)
bash scripts/configure.sh
# 3. Restart [REDACTED]
openclaw [REDACTED] restart
# 4. Verify (waits for indexing, runs test query)
bash scripts/verify.sh
Optional Enhancements
# Organize memory files into clean directory structure
bash scripts/organize.sh
# Add YAML frontmatter tags to untagged files
bash scripts/tag.sh
What Gets Enabled
| Feature | Details | |---------|---------| | Local embeddings | embeddinggemma-300m (~328MB GGUF, auto-downloads) | | Hybrid search | BM25 keyword + vector semantic (70/30 weight) | | Session transcripts | Past conversations become searchable | | MMR diversity | Reduces duplicate/overlapping results (λ=0.7) | | Temporal decay | Recent memories rank higher (30-day half-life) | | Embedding cache | 50k entries, avoids re-embedding unchanged text | | File watcher | Auto-reindexes when memory files change |
How It Works
- Patches
agents.defaults.memorySearchinopenclaw.json - Uses
node-llama-cpp(ships with OpenClaw) for local embeddings - Vector search via
sqlite-vec(ships with OpenClaw) - No external dependencies required
Notes
- First search after restart may be slow (model loads into memory)
- Initial indexing takes 30-120s depending on file count
- Embedding model runs on CPU (ARM/x86), ~768-dim vectors
- Compatible with existing memory files — no migration needed
Related Skills
profbernardoj/three-shifts
tools
VerifiedTrustedCommunity
Cyclic shift execution engine. Plans tasks 3x daily (6 AM, 2 PM, 10 PM), decomposes them into granular steps, then executes via 15-minute cron cycles. Each cycle reads state files, picks the next step, executes it, writes results back. Errors are logged and skipped — never fatal. Planning uses Claude 4.6; execution uses GLM-5.
SKILL.mdUpdated May 16, 2026
profbernardoj/xmtp-comms-guard
tools
VerifiedTrustedCommunity
Security middleware for all XMTP communications in EverClaw. Enforces guarded client usage with validation, integrity checks, and fail-closed security policies. Integrates approval flows for sensitive operations. Use when integrating XMTP messaging, configuring communication security, or auditing guarded client enforcement.
SKILL.mdUpdated May 12, 2026
profbernardoj/three-shifts
data-ai
VerifiedTrustedCommunity
Daily standup engine. Plans tasks 3x daily (6 AM, 2 PM, 10 PM) and delivers them for approval. Execution happens in the main session via direct conversation. Night shifts auto-approve carryover from earlier in the day.
SKILL.mdUpdated May 12, 2026
profbernardoj/super-helper
tools
VerifiedTrustedCommunity
A helpful utility skill for agents
SKILL.mdUpdated May 12, 2026