v2.8.0 — OpenClaw 2026.5.7 Compatibility

Changed

• OpenClaw 2026.5.7 compatibility — Bumped peer dependency from >=2026.3.22 to >=2026.5.7.
• ContextEngineFactory — Factory now receives ContextEngineFactoryContext (workspaceDir, agentDir) from the OpenClaw runtime, enabling reliable workspace resolution without relying on api.workspace workarounds.
• registerMemoryCapability — Plugin now uses the v2026.5.7 registerMemoryCapability API for memory prompt guidance instead of the deprecated registerMemoryPromptSection. Fallback to the legacy API is preserved for hosts running older OpenClaw versions.
• assemble() — availableTools guard — Memory context injection is now skipped automatically on turns where no memory tools (memory_search, memory_get, memory_write) are available, avoiding wasted system prompt budget.
• assemble() — citationsMode — When OpenClaw's citations mode is active, palaia appends citation guidance to the injected memory context, prompting the agent to reference memory IDs in its reply.
• Plugin SDK types — types.ts updated to reflect the OpenClaw v2026.5.7 plugin SDK: new ContextEngineFactoryContext, TranscriptRewriteReplacement/Request/Result, ContextEngineMaintenanceResult, ContextEnginePromptCacheInfo, MemoryPluginCapability, additional hook names (before_agent_reply, model_call_started, model_call_ended), and extended optional fields on existing interfaces.

palaia v2.7.3 — Hotfix

Fixed

• ContextEngine: ownsCompaction: true — prevents OpenClaw's Pi auto-compaction from running in parallel with palaia gc, avoiding unpredictable context truncation
• Doctor phantom stale-tasks warning — _check_stale_unassigned_tasks now reads entries through Store instead of scanning files directly, eliminating false positives for entries invisible to palaia list
• Scope: empty/unknown scope no longer hides entries — can_access() treats empty or unrecognized scope values as team instead of silently hiding entries

Upgrade

pip install --upgrade palaia
# or via OpenClaw skill:
openclaw skills install palaia

palaia v2.7.2 — Claude Code onboarding

What's New

Claude Code onboarding

• palaia setup claude-code — One-command setup that configures Claude Code as a first-class palaia integration. Writes MCP server config to ~/.claude/settings.json and generates a CLAUDE.md with session-start routine and proactive storage guidance.
• Doctor check — palaia doctor now checks whether Claude Code is configured to use palaia.
• Dedicated docs — New docs/claude-code.md with paste-this prompt for fully autonomous install.
• Updated docs — README, getting-started.md, mcp.md, cli-reference.md all updated with Claude Code sections.

Paste-this prompt for Claude Code

Install palaia for persistent memory in this Claude Code environment.
Run: pip install "palaia[mcp,fastembed]" && palaia init && palaia setup claude-code --global
Then tell me to restart Claude Code so the MCP tools become active.
After restart, read the CLAUDE.md and follow its instructions.

Install

pip install palaia==2.7.2

Full changelog: https://github.com/byte5ai/palaia/blob/main/CHANGELOG.md

palaia v2.7.1 — documentation update

Documentation that was missing from v2.7:

• SKILL.md: palaia ui and palaia prune commands documented
• README.md: WebUI in feature table
• docs/cli-reference.md: palaia ui, palaia prune flags
• docs/multi-agent.md: Capture health check section, removed obsolete shared:<name> scope

No code changes. Upgrade with pip install --upgrade palaia.

palaia v2.7 — WebUI, codex audit fixes, doctor improvements

What's New

Features

• WebUI — local memory explorer (palaia ui) — Browser-based UI for browsing, searching, creating, and managing entries. Manual entries highlighted (gold border + badge) reflecting the 1.3x recall boost. Tasks are post-its (one-click done = delete). Active Tasks sidebar. Doctor health banner with actionable fix hints. Localhost only, no auth. Install with pip install 'palaia[ui]'.

Fixed

• Search timeout actually works now — ThreadPoolExecutor was blocking on shutdown; switched to persistent executor with abandoned workers (codex P1)
• DELETE returns 404 for missing entries — was silently returning 200 (codex P2)
• WebUI localhost-only — removed --host CLI flag to prevent accidental LAN exposure of unauth UI (codex P1 run #2)
• Doctor fix hints expanded — plugin slot fallback instruction added (codex P2 run #2)
• Legacy memory files — doctor excludes OpenClaw system files (agents/, systems/, CONTEXT.md) and downgrades to info (#166)
• postUpdate plugin install — error suppression removed, slot registration visible (#167, #170)

Migration

pip install --upgrade palaia && palaia doctor --fix

Full changelog: https://github.com/byte5ai/palaia/blob/main/CHANGELOG.md

palaia v2.6 — usage-data optimization, capture diagnostics, process safety

What's New

Features

• Usage-Data-Driven Optimization — Shared scope removed (normalized to team), task-as-post-it model (auto-capture never creates tasks), manual entry boost (1.3x for intentionally stored knowledge)
• Capture Health Check — palaia doctor warns when autoCapture=true but zero entries captured
• CLI/Plugin Version Mismatch Detection — New doctor check detects diverging versions
• Process Safety in Curate — Full content preserved for process entries, --force required for destructive operations

Fixed

• Auto-capture workspace bug for sub-agents (#157)
• memory_search timeout on parallel queries (#144)
• Auto-capture diagnostic logging (silent failures now visible)
• Doctor severity bumps: captureModel + legacy files promoted to warn (#99, #101)

Migration

pip install --upgrade palaia && palaia doctor --fix

No manual steps required. Existing shared:X entries treated as team automatically.

Full changelog: https://github.com/byte5ai/palaia/blob/main/CHANGELOG.md

palaia v2.5.1 — Hotfix

Fixed

• Doctor report alignment — Long check labels no longer overlap with values
• SKILL.md postUpdateMessage — Updated from v2.4 to v2.5 feature summary

pip install palaia==2.5.1

Full changelog: v2.5...v2.5.1

palaia v2.5 — Agent Isolation, Modern CLI, Backup-Restore

What's New

Agent Isolation Mode

• New --isolated flag for scope-based memory filtering between agents
• Agents can now operate with isolated memory scopes

Modern CLI Design System

• Borderless column-aligned tables (replaces box-drawing)
• ANSI colors with TTY detection, respects NO_COLOR / FORCE_COLOR
• Unicode symbols: ✓ ✗ ⚠ ℹ → ▸
• Zero new dependencies

Backup-Restore Fix

• Auto-detect orphaned entries on disk (e.g. after backup restore)
• palaia doctor --fix rebuilds metadata index from flat files
• Migration auto-triggers on Store() init when entries are orphaned

Infrastructure

• CI stabilization: flaky concurrent write tests marked xfail
• Matrix fail-fast: false for complete test coverage reporting
• AGENTS.md and pre-push hook for branch protection

Install / Upgrade

pip install palaia==2.5

Full changelog: v2.4...v2.5

palaia v2.4 — Session Continuity

What's New

Session Continuity v3

• Auto-briefing: Last session summary + open tasks loaded on session start
• Auto-summaries: Saved on session end/reset (LLM-based with rule-based fallback)
• Tool observations: Tracked via after_tool_call hooks
• Model switch detection: Re-briefing on LLM changes

OpenClaw v2026.3.28 Compatibility

• api.pluginConfig (replaces removed getConfig())
• ServiceContext parameter for service start/stop
• Updated PluginLogger, registerTool types

Quality & Safety

• Privacy markers: <private> blocks excluded from all capture paths
• Recency boost: Fresh memories ranked higher (exponential decay)
• Progressive disclosure: Compact mode for large result sets
• SearchEngine cache: Keyed by corpus params to prevent cross-agent leakage
• Embed-server: Temporal query forwarding (before/after)

CLI

• query --tags for tag-filtered search
• list --limit for result limiting
• palaia skill strips install section (saves context window)

Housekeeping

• GitHub org: iret77/palaia → byte5ai/palaia
• Branch policy documented
• Claude Code MCP setup in docs

Install / Upgrade

pip install palaia==2.4
palaia doctor --fix

Tests

205 TypeScript + 1114 Python tests passing.

---

🤖 Generated with Claude Code

palaia v2.3.6 — No direct model loading anywhere

Fixes

Systematic elimination of all direct fastembed loading:

1. store.write/edit: No longer loads fastembed (~3s) for incremental indexing. Uses embed-server if running, skips otherwise. Entries indexed on next warmup.

2. Daemon startup race condition: Atomic lock file prevents two CLI processes from spawning duplicate daemons.

3. palaia doctor: No longer instantiates embedding providers just to check config. Reads config directly.

Upgrade

palaia upgrade