XiaoShan Memory Engine ⛰️
Persistent memory for your AI — semantic vector search, knowledge graph, and analytics.
Install
npx clawhub@latest install xiaoshan-memory --force
Note: VirusTotal flags all memory-engine skills as "suspicious" due to keywords like "search" and "forget" in the description. This is a known false positive. The skill is safe — feel free to review the code before installing.
After installation, configure your AI provider:
# Option A: Set environment variable
export OPENAI_API_KEY=sk-your-key
# Option B: Edit config file
# ~/.xiaoshan/config.yaml
Core API
Server runs at 127.0.0.1:18790 by default.
| Endpoint | Method | Description |
|---|---|---|
| /save | POST | Save a new memory |
| /search | POST | Search memories semantically |
| /ask | POST | Ask question over memories |
| /stats | GET | Get memory statistics |
| /list | GET | List recent memories |
| /kg/stats | GET | Knowledge graph stats |
| /forget | POST | Delete a memory |
Provider Support
OpenAI · Zhipu AI · DeepSeek · Ollama (local, no key needed)
Decision Guide
| User says | Action |
|---|---|
| "Remember this / 记住" | POST /save |
| "What did I say about X" | POST /search |
| "How many memories" | GET /stats |
| "Delete that memory / 删除记忆" | POST /forget |
| "Knowledge graph / 知识图谱" | GET /kg/stats |