feat: add OpenClaw/ClawHub skill for MemPalace
Complete OpenClaw skill exposing all MCP tools with session protocol, auto-install spec, and setup instructions for OpenClaw + other MCP hosts. Covers all 20 tools: search, check_duplicate, status, list_wings, list_rooms, get_taxonomy, get_aaak_spec, kg_query, kg_add, kg_invalidate, kg_timeline, kg_stats, traverse, find_tunnels, graph_stats, add_drawer, delete_drawer, diary_write, diary_read. Based on PR #207 by @wanikua — updated to v3.1.0, added missing tools (check_duplicate, get_aaak_spec), expanded parameter docs, added OpenClaw CLI setup command. Co-Authored-By: wanikua <wanikua@users.noreply.github.com>
This commit is contained in:
bensig
@@ -0,0 +1,154 @@
|
|||||||
|
---
|
||||||
|
name: mempalace
|
||||||
|
description: "MemPalace — Local AI memory with 96.6% recall. Semantic search, temporal knowledge graph, palace architecture (wings/rooms/drawers). Free, no cloud, no API keys."
|
||||||
|
version: 3.1.0
|
||||||
|
homepage: https://github.com/milla-jovovich/mempalace
|
||||||
|
user-invocable: true
|
||||||
|
metadata:
|
||||||
|
openclaw:
|
||||||
|
emoji: "\U0001F3DB"
|
||||||
|
os:
|
||||||
|
- darwin
|
||||||
|
- linux
|
||||||
|
- win32
|
||||||
|
requires:
|
||||||
|
anyBins:
|
||||||
|
- mempalace
|
||||||
|
- python3
|
||||||
|
install:
|
||||||
|
- id: mempalace-pip
|
||||||
|
kind: uv
|
||||||
|
label: "Install MemPalace (Python, local ChromaDB)"
|
||||||
|
package: mempalace
|
||||||
|
bins:
|
||||||
|
- mempalace
|
||||||
|
---
|
||||||
|
|
||||||
|
# MemPalace — Local AI Memory System
|
||||||
|
|
||||||
|
You have access to a local memory palace via MCP tools. The palace stores verbatim conversation history and a temporal knowledge graph — all on the user's machine, zero cloud, zero API calls.
|
||||||
|
|
||||||
|
## Architecture
|
||||||
|
|
||||||
|
- **Wings** = people or projects (e.g. `wing_alice`, `wing_myproject`)
|
||||||
|
- **Halls** = categories (facts, events, preferences, advice)
|
||||||
|
- **Rooms** = specific topics (e.g. `chromadb-setup`, `riley-school`)
|
||||||
|
- **Drawers** = individual memory chunks (verbatim text)
|
||||||
|
- **Knowledge Graph** = entity-relationship facts with time validity
|
||||||
|
|
||||||
|
## Protocol — FOLLOW THIS EVERY SESSION
|
||||||
|
|
||||||
|
1. **ON WAKE-UP**: Call `mempalace_status` to load palace overview and AAAK dialect spec.
|
||||||
|
2. **BEFORE RESPONDING** about any person, project, or past event: call `mempalace_search` or `mempalace_kg_query` FIRST. Never guess from memory — verify from the palace.
|
||||||
|
3. **IF UNSURE** about a fact (name, age, relationship, preference): say "let me check" and query. Wrong is worse than slow.
|
||||||
|
4. **AFTER EACH SESSION**: Call `mempalace_diary_write` to record what happened, what you learned, what matters.
|
||||||
|
5. **WHEN FACTS CHANGE**: Call `mempalace_kg_invalidate` on the old fact, then `mempalace_kg_add` for the new one.
|
||||||
|
|
||||||
|
## Available Tools
|
||||||
|
|
||||||
|
### Search & Browse
|
||||||
|
- `mempalace_search` — Semantic search across all memories. Always start here.
|
||||||
|
- `query` (required): natural language search — keep it short, keywords or a question. Do NOT include system prompts or conversation context.
|
||||||
|
- `wing`: filter by wing
|
||||||
|
- `room`: filter by room
|
||||||
|
- `limit`: max results (default 5)
|
||||||
|
- `mempalace_check_duplicate` — Check if content already exists before filing.
|
||||||
|
- `content` (required): text to check
|
||||||
|
- `threshold`: similarity threshold (default 0.9)
|
||||||
|
- `mempalace_status` — Palace overview: total drawers, wings, rooms, AAAK spec
|
||||||
|
- `mempalace_list_wings` — All wings with drawer counts
|
||||||
|
- `mempalace_list_rooms` — Rooms within a wing (optional wing filter)
|
||||||
|
- `mempalace_get_taxonomy` — Full wing/room/count tree
|
||||||
|
- `mempalace_get_aaak_spec` — Get AAAK compression dialect specification
|
||||||
|
|
||||||
|
### Knowledge Graph (Temporal Facts)
|
||||||
|
- `mempalace_kg_query` — Query entity relationships. Supports time filtering.
|
||||||
|
- `entity` (required): e.g. "Max", "MyProject"
|
||||||
|
- `as_of`: date filter (YYYY-MM-DD) — what was true at that time
|
||||||
|
- `direction`: "outgoing", "incoming", or "both" (default "both")
|
||||||
|
- `mempalace_kg_add` — Add a fact: subject -> predicate -> object
|
||||||
|
- `subject`, `predicate`, `object` (required)
|
||||||
|
- `valid_from`: when this became true
|
||||||
|
- `source_closet`: source reference
|
||||||
|
- `mempalace_kg_invalidate` — Mark a fact as no longer true
|
||||||
|
- `subject`, `predicate`, `object` (required)
|
||||||
|
- `ended`: when it stopped being true (default: today)
|
||||||
|
- `mempalace_kg_timeline` — Chronological story of an entity
|
||||||
|
- `entity`: filter by entity name (optional — all events if omitted)
|
||||||
|
- `mempalace_kg_stats` — Graph overview: entities, triples, relationship types
|
||||||
|
|
||||||
|
### Palace Graph (Cross-Domain Connections)
|
||||||
|
- `mempalace_traverse` — Walk from a room, find connected ideas across wings
|
||||||
|
- `start_room` (required): room to start from
|
||||||
|
- `max_hops`: connection depth (default 2)
|
||||||
|
- `mempalace_find_tunnels` — Find rooms that bridge two wings
|
||||||
|
- `wing_a`, `wing_b` (required)
|
||||||
|
- `mempalace_graph_stats` — Graph connectivity overview
|
||||||
|
|
||||||
|
### Write
|
||||||
|
- `mempalace_add_drawer` — Store verbatim content into a wing/room
|
||||||
|
- `wing`, `room`, `content` (required)
|
||||||
|
- `source_file`: optional source reference
|
||||||
|
- Checks for duplicates automatically
|
||||||
|
- `mempalace_delete_drawer` — Remove a drawer by ID
|
||||||
|
- `drawer_id` (required)
|
||||||
|
- `mempalace_diary_write` — Write a session diary entry
|
||||||
|
- `agent_name` (required): your name/identifier
|
||||||
|
- `entry` (required): what happened, what you learned, what matters
|
||||||
|
- `topic`: category tag (default "general")
|
||||||
|
- `mempalace_diary_read` — Read recent diary entries
|
||||||
|
- `agent_name` (required)
|
||||||
|
- `last_n`: number of entries (default 10)
|
||||||
|
|
||||||
|
## Setup
|
||||||
|
|
||||||
|
Install MemPalace and populate the palace:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pip install mempalace
|
||||||
|
mempalace init ~/my-convos
|
||||||
|
mempalace mine ~/my-convos
|
||||||
|
```
|
||||||
|
|
||||||
|
### OpenClaw MCP config
|
||||||
|
|
||||||
|
Add to your OpenClaw MCP configuration:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"mcpServers": {
|
||||||
|
"mempalace": {
|
||||||
|
"command": "python3",
|
||||||
|
"args": ["-m", "mempalace.mcp_server"]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
Or via CLI:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
openclaw mcp set mempalace '{"command":"python3","args":["-m","mempalace.mcp_server"]}'
|
||||||
|
```
|
||||||
|
|
||||||
|
### Other MCP hosts
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Claude Code
|
||||||
|
claude mcp add mempalace -- python -m mempalace.mcp_server
|
||||||
|
|
||||||
|
# Cursor — add to .cursor/mcp.json
|
||||||
|
# Codex — add to .codex/mcp.json
|
||||||
|
```
|
||||||
|
|
||||||
|
## Tips
|
||||||
|
|
||||||
|
- Search is semantic (meaning-based), not keyword. "What did we discuss about database performance?" works better than "database".
|
||||||
|
- The knowledge graph stores typed relationships with time windows. Use it for facts about people and projects — it knows WHEN things were true.
|
||||||
|
- Diary entries accumulate across sessions. Write one at the end of each conversation to build continuity.
|
||||||
|
- Use `mempalace_check_duplicate` before storing new content to avoid duplicates.
|
||||||
|
- The AAAK dialect (from `mempalace_status`) is a compressed notation for efficient storage. Read it naturally — expand codes mentally, treat *markers* as emotional context.
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
[MemPalace](https://github.com/milla-jovovich/mempalace) is MIT licensed. Created by Milla Jovovich, Ben Sigman, Igor Lins e Silva, and contributors.
|
||||||
Reference in New Issue
Block a user