Skip to main content

Local, cloud-free memory for OpenClaw agents.

Project description

             .__         .__
___________  |  | _____  |__|____
\____ \__  \ |  | \__  \ |  \__  \
|  |_> > __ \|  |__/ __ \|  |/ __ \_
|   __(____  /____(____  /__(____  /
|__|       \/          \/        \/

The Knowledge System for AI Agent Teams

Your agents forget. palaia doesn't.

CI PyPI Python 3.9+ License: MIT OpenClaw Plugin


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


MIT — (c) 2026 byte5 GmbH

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

palaia-2.7.tar.gz (322.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

palaia-2.7-py3-none-any.whl (221.7 kB view details)

Uploaded Python 3

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

Hashes for palaia-2.7.tar.gz
Algorithm Hash digest
SHA256 c42b6b4b65c17b3193e549ff8c8873f4334f080ba25f07fa7367b0d76d06ed50
MD5 ad19c02230f4e228d44c092a28eb0fe3
BLAKE2b-256 08954b28f6fe9f230e8b52e92d179681de0c5acffa5afac3ac50770db056dbe3

See more details on using hashes here.

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

Hashes for palaia-2.7-py3-none-any.whl
Algorithm Hash digest
SHA256 65ea8085975952ed2efd8ee3b3fc2fdec16f270ba0cdfc5a2e6d62f90c968399
MD5 7c3520fd2e4c09539f9943a59e17a441
BLAKE2b-256 4f6be8aed3777eab5fe4e27a4c8c5346ce1978b6504308b36d302f409b29123e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page