Memory Skill

README

# openclaw-memory-skill 🧠

> OpenClaw Skill for daily maintenance and updates of the memory & context plugin stack.

## What is this?

This is an [OpenClaw](https://github.com/openclaw/openclaw) **skill** — a set of structured instructions that AI agents can use to autonomously maintain, update, troubleshoot, and monitor two critical OpenClaw plugins:

| Plugin | Version | Role |
|--------|---------|------|
| [**memory-lancedb-pro**](https://github.com/CortexReach/memory-lancedb-pro) | v1.1.0-beta.10 | Long-term memory with hybrid retrieval (Vector + BM25), cross-encoder reranking, multi-scope isolation |
| [**lossless-claw-enhanced**](https://github.com/win4r/lossless-claw-enhanced) | v0.5.2 | DAG-based lossless context compaction with CJK-aware token estimation |

## Features

- 🔍 **Health Monitoring** — Automated health checks for both plugins, LanceDB, and LCM databases
- 🔄 **Update Management** — Check for updates, apply upgrades with rollback capability
- 💾 **Backup & Restore** — Full backup/restore procedures including cross-host migration
- 🔧 **Troubleshooting** — Comprehensive issue diagnosis and resolution guides
- 📊 **Config Reference** — Complete field-by-field documentation for both plugins

## Installation

### As an OpenClaw Skill (recommended)

```bash
# Copy to OpenClaw skills directory
cp -r openclaw-memory-skill ~/.openclaw/skills/openclaw-memory

# Or symlink
ln -s $(pwd)/openclaw-memory-skill ~/.openclaw/skills/openclaw-memory
```

### As a Gemini Antigravity Skill

```bash
cp -r openclaw-memory-skill ~/.gemini/antigravity/skills/openclaw-memory
```

## Usage

Once installed, your AI agent will automatically use this skill when:

- You ask about memory plugin maintenance
- You want to check for plugin updates
- You encounter memory-related errors
- You need to backup/restore memory data
- You want to tune retrieval or compaction settings

### Manual Health Check

```bash
./scripts/health_check.sh
```

### Quick Commands

```bash
# Check versions
./scripts/health_check.sh --updates-only

# Full system health
./scripts/health_check.sh
```

## Project Structure

```
openclaw-memory-skill/
├── SKILL.md                           # Main skill instructions
├── README.md                          # This file
├── LICENSE                            # MIT License
├── scripts/
│   └── health_check.sh               # Automated health & update check
└── references/
    ├── update_guide.md                # Step-by-step update procedures
    ├── health_checks.md               # Health verification & diagnostics
    ├── backup_restore.md              # Backup, restore & migration
    ├── troubleshooting.md             # Common issues & fixes
    └── config_reference.md            # Full configuration reference
```

## Compatibility

| Component | Minimum Version | Recommended |
|-----------|----------------|-------------|
| OpenClaw | 2026.3.22 | 2026.4.9+ |
| memory-lancedb-pro | v1.0.32 | v1.1.0-beta.10 |
| lossless-claw-enhanced | v0.5.0 | v0.5.2 |
| Node.js | 20.x | 25.x |

## Related Projects

- [OpenClaw](https://github.com/openclaw/openclaw) — Self-hosted AI agent gateway
- [memory-lancedb-pro](https://github.com/CortexReach/memory-lancedb-pro) — Enhanced LanceDB memory plugin
- [lossless-claw-enhanced](https://github.com/win4r/lossless-claw-enhanced) — Lossless context compaction plugin
- [memory-lancedb-pro-skill](https://github.com/CortexReach/memory-lancedb-pro-skill) — Development skill for memory-lancedb-pro

## License

MIT