openclaw-mem-sync

name	openclaw-mem-sync
description	Govern embedding refresh, episodic evidence synchronization, metadata writeback, and engine dataset snapshots. Use before or after bounded sync, reindex, migration, or writeback operations.
metadata	{"ring":1,"surface":["cli","plugin"],"version":"2.0.0","requires":["openclaw-mem-memory"]}

Sync Governance

Boundaries

• Keep episodic evidence distinct from durable facts.
• Refresh only the requested scope, field, model, and bounded limit.
• Snapshot engine datasets before mass writeback, reindex, migration, or checkout.
• Require receipts and explicit confirmation for destructive or active-dataset actions.
• Treat model/dimension and orphan-vector warnings as integrity issues to investigate.

Operate

openclaw-mem episodes embed --scope <scope> --limit 500 --json
openclaw-mem episodes search <query> --scope <scope> --mode hybrid --trace --json
openclaw-mem embed --field both --limit 500 --json
openclaw-mem db info --json
openclaw-mem engine snapshot create --tag <tag> --reason <reason> --json
openclaw-mem writeback-lancedb --lancedb <path> --table <table> --dry-run --json

Use OPENCLAW_MEM_EMBED_PROVIDER=local only with the embed extra installed. Local and OpenAI model rows may coexist; query the same stored model deliberately.

Verify

openclaw-mem db info --json
openclaw-mem doctor --json
python -m pytest tests/test_embedding_providers.py tests/test_embedding_integrity.py -q