Experience Engine

README

# openclaw-experience-engine

Memory + skill engine for OpenClaw. Single plugin replacing `openclaw-memory-plugin` + `openclaw-skill-evolution`.

## Status

**v0.1.0 — under construction** per OpenSpec change `bootstrap-experience-engine` in `openclaw-config/openspec/changes/bootstrap-experience-engine/`. Cutover planned 2026-06 after 3-week implementation.

## Design summary

- Single plugin: id `experience-engine`. Replaces two legacy plugins.
- Pipeline-stage architecture: typed `Stage<I, O>` functions composed into turn-flow / prompt-flow. No middleware-chain shared-ctx pattern.
- Event-sourced ground truth: append-only `raw_event` table; all derived state computed from it.
- Single SQLite (`experience.db`) + LanceDB (vectors only). Explicit FK + ON DELETE rules.
- Cross-plugin coordination via direct refs `(api as any)._experienceEngine` only. No pub/sub assumptions (gateway has no `emit`).
- Hermes-inspired skill discipline: provenance gate + freeze tier + anti-capture list + consolidation-first action ordering.
- Honcho-absorbed user representation: peer + session levels, background deriver, deductive + inductive conclusions taxonomy. In-process TypeScript reimplementation — NO external sidecar, NO AGPL surface.

See `docs/honcho-absorption-notes.md` (forthcoming in §2.S.3) and `openclaw-config/openspec/changes/bootstrap-experience-engine/design.md` for full design.

## Module structure

```
src/
  core/          plugin entry + config + cross-plugin API surface
  storage/       SQLite schema + LanceDB + event-log + migrations
  pipeline/      capture/extract/score/compact/store/retrieve/rank/represent/inject/reflect
  skills/        tracker/discoverer/generator/approver/evaluator/evolver/publisher/lifecycle/selector
  workers/       SQLite-backed job queue + handlers
  llm/           single fetch client + prompts/ + parsers/
  hooks/         thin adapters for gateway typed hooks (≤50 LOC each)
  tools/         memory_* + lcm_* tool implementations
  cli/           repo-level CLI
```

## Capability commitment

27 capabilities from the 2026-05-27 audit MUST be ported (23 from current memory-plugin + skill-evolution, plus 4 new Hermes-inspired/Honcho-absorbed). See `openclaw-config/openspec/changes/bootstrap-experience-engine/tasks.md` §2 for the inventory.

## License

MIT.