Local, cloud-free memory for OpenClaw agents.
Project description
.__ .__
___________ | | _____ |__|____
\____ \__ \ | | \__ \ | \__ \
| |_> > __ \| |__/ __ \| |/ __ \_
| __(____ /____(____ /__(____ /
|__| \/ \/ \/
The Knowledge System for AI Agent Teams
Your agents forget. palaia doesn't.
What palaia Does
AI agents are stateless by default. Every session starts from scratch — no memory of past decisions, no shared knowledge between agents, no context that survives a restart.
palaia gives your agents a persistent, searchable knowledge store. They save what they learn. They find it again by meaning, not keyword. They share it across tools and sessions — automatically.
What palaia Is Not
- Not a chatbot or prompt manager
- Not a cloud service (everything runs locally)
- Not a vector database you manage yourself (it manages itself)
- Not limited to one tool — works with OpenClaw, Claude Desktop, Cursor, and any MCP client
What You Get
| Capability | What it means |
|---|---|
| Agents remember across sessions | Knowledge survives restarts, tool switches, and team handoffs |
| Find anything by meaning | Hybrid BM25 + vector search across 6 embedding providers |
| Zero-config local setup | SQLite with native SIMD vector search — no separate database process |
| Works everywhere via MCP | One memory store for OpenClaw, Claude Desktop, Cursor, and more |
| Multi-agent ready | Private, team, and public scopes — agents see what they should |
| Agent isolation | --isolated mode for strict per-agent memory boundaries |
| Crash-safe by default | SQLite WAL mode survives power loss, kills, OOM |
| Fast | Embed server keeps model in RAM — CLI queries ~1.5s, MCP/Plugin <500ms |
| Scales when needed | Swap to PostgreSQL + pgvector for distributed teams, no code changes |
Comparison
| Feature | palaia | claude-mem | Mem0 | Stock Memory |
|---|---|---|---|---|
| Local-first | Yes | Yes | No (cloud) | Yes |
| Cross-tool (MCP) | Yes (any MCP client) | No (Claude Code only) | No | No |
| Native Vector Search | sqlite-vec / pgvector | ChromaDB (separate) | Cloud | No |
| Structured Types | memory/process/task | decisions/bugfixes | No | No |
| Multi-Agent Scopes | private/team/public | No | Per-user | No |
| Smart Tiering | HOT/WARM/COLD | No | No | No |
| Embedding Providers | 6 (configurable) | 1 (fixed) | Cloud | None |
| Open Source | MIT | AGPL-3.0 | Partial | N/A |
| Crash-safe (WAL) | Yes | Partial | N/A | No |
Install
Recommended: Tell your agent
Paste this into your OpenClaw agent (works for install AND update):
Install or update the palaia memory skill from ClawHub to the latest version (even if already present). Read the SKILL.md completely and follow it step by step. Run palaia init, then palaia doctor --fix and resolve all warnings — don't stop until the doctor report is clean. Set up completely.
The agent handles everything: ClawHub skill install, pip setup, plugin config, and verification.
Manual Setup
pip install "palaia[fastembed]"
palaia init
openclaw plugins install @byte5ai/palaia
palaia doctor --fix
Then activate the memory slot in your OpenClaw config:
// openclaw.json
{
plugins: {
slots: { memory: "palaia" }
}
}
Restart the gateway: openclaw gateway restart
Optional extras:
pip install "palaia[mcp]" # MCP server for Claude Desktop, Cursor
pip install "palaia[curate]" # Knowledge curation
pip install "palaia[postgres]" # PostgreSQL + pgvector backend
Note: palaia[fastembed] already includes sqlite-vec for native vector search and the embed-server auto-starts on first query. No manual optimization needed.
Upgrading? palaia upgrade — auto-detects install method, preserves extras, runs doctor.
MCP Setup (Claude Desktop, Cursor, Claude Code — no OpenClaw needed)
pip install "palaia[mcp,fastembed]"
palaia init
Add to your MCP config:
- Claude Desktop:
~/.config/claude/claude_desktop_config.json - Cursor:
.cursor/mcp.json - Claude Code:
~/.claude/settings.json
{
"mcpServers": {
"palaia": {
"command": "palaia-mcp"
}
}
}
Quick Start
palaia write "API rate limit is 100 req/min" \
--type memory --tags api,limits # Save knowledge
palaia query "what's the rate limit" # Find it by meaning
palaia status # Check health
Documentation
| Document | Description |
|---|---|
| Getting Started | Installation, first steps, quick tour |
| Storage & Search | SQLite, PostgreSQL, sqlite-vec, pgvector, embedding providers |
| MCP Server | Setup for Claude Desktop, Cursor, tool reference, read-only mode |
| Embed Server | Performance optimization, socket transport, daemon mode |
| Multi-Agent | Scopes, agent identity, team setup, aliases |
| Configuration | All config keys, embedding chain, tuning |
| CLI Reference | All commands with flags and examples |
| Migration Guide | Import from other systems, flat-file migration |
| Architecture | Module map, data flows, design decisions |
| SKILL.md | Agent-facing documentation (what agents read) |
| Contributing | Versioning, release process, development setup |
| Changelog | Release history |
Development
git clone https://github.com/byte5ai/palaia.git
cd palaia
pip install -e ".[dev]"
pytest
Links
- palaia.ai — Homepage
- PyPI — Package registry
- ClawHub — Install via agent skill
- OpenClaw — The agent platform palaia is built for
- CHANGELOG — Release history
MIT — (c) 2026 byte5 GmbH
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file palaia-2.7.tar.gz.
File metadata
- Download URL: palaia-2.7.tar.gz
- Upload date:
- Size: 322.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.15
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c42b6b4b65c17b3193e549ff8c8873f4334f080ba25f07fa7367b0d76d06ed50
|
|
| MD5 |
ad19c02230f4e228d44c092a28eb0fe3
|
|
| BLAKE2b-256 |
08954b28f6fe9f230e8b52e92d179681de0c5acffa5afac3ac50770db056dbe3
|
File details
Details for the file palaia-2.7-py3-none-any.whl.
File metadata
- Download URL: palaia-2.7-py3-none-any.whl
- Upload date:
- Size: 221.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.15
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
65ea8085975952ed2efd8ee3b3fc2fdec16f270ba0cdfc5a2e6d62f90c968399
|
|
| MD5 |
7c3520fd2e4c09539f9943a59e17a441
|
|
| BLAKE2b-256 |
4f6be8aed3777eab5fe4e27a4c8c5346ce1978b6504308b36d302f409b29123e
|