Memory Alpha Openclaw

Name: Memory Alpha Openclaw
Rating: 3.5 (1 reviews)
Author: ApeironOne

By ApeironOne 👁 26 views ▲ 0 votes

Markdown-first Memory Alpha plugin for OpenClaw

GitHub

Install

npm install
npm

Configuration Example

{
  "rootPath": "~/MemoryAlpha",
  "sqlitePath": "~/.openclaw/memory-alpha/memory-alpha.sqlite",
  "router": {
    "enabled": true,
    "nativeFallbackEnabled": true
  },
  "capture": {
    "enabled": false
  },
  "autoRecall": {
    "enabled": false,
    "searchMode": "sqlite"
  }
}

README

# Memory Alpha for OpenClaw

Memory Alpha is an OpenClaw plugin for a Markdown-first memory library. It indexes a folder of Markdown files into SQLite, exposes search/get/save tools to agents, and can optionally add hybrid semantic search with Qdrant and Ollama.

The default install is intentionally local and simple:

- Markdown source of truth: `~/MemoryAlpha`
- SQLite catalog: `~/.openclaw/memory-alpha/memory-alpha.sqlite`
- Optional vector search: Qdrant + Ollama

## Install

From a checked-out copy:

```sh
npm install
npm run check:syntax
npm pack
openclaw plugins install ./apeiron-memory-alpha-0.1.0.tgz --force
openclaw gateway restart
```

Then add or adapt this plugin config in OpenClaw:

```json
{
  "rootPath": "~/MemoryAlpha",
  "sqlitePath": "~/.openclaw/memory-alpha/memory-alpha.sqlite",
  "router": {
    "enabled": true,
    "nativeFallbackEnabled": true
  },
  "capture": {
    "enabled": false
  },
  "autoRecall": {
    "enabled": false,
    "searchMode": "sqlite"
  }
}
```

Create the library and build the catalog:

```sh
mkdir -p ~/MemoryAlpha/guides ~/MemoryAlpha/journal
npm run ingest:sqlite -- --root ~/MemoryAlpha --sqlite ~/.openclaw/memory-alpha/memory-alpha.sqlite
```

## Tools

The plugin registers:

- `memory_alpha_status`
- `memory_alpha_search`
- `memory_alpha_get`
- `memory_alpha_save`

## Hybrid Search

SQLite mode works without extra services. For semantic search, run Qdrant and Ollama, pull an embedding model, then drain the embedding queue:

```sh
docker compose -f deploy/docker-compose.yml up -d
ollama pull snowflake-arctic-embed2
npm run embed:drain -- \
  --sqlite ~/.openclaw/memory-alpha/memory-alpha.sqlite \
  --qdrant-url http://127.0.0.1:6333 \
  --ollama-url http://127.0.0.1:11434
```

See `docs/INSTALL.md`, `docs/INGESTION.md`, and `docs/HYBRID-SEARCH.md` for more detail.

tools