Knowledge Memory Router

Supported actions

Primary actions:

• note
• notes-today
• notes-fetch
• notes-extract

Full dispatcher actions are documented in references/action-reference.zh-CN.md.

Gotchas

• JSON is the only source of truth. Qdrant is recall only.
• 今日笔记 is a structured date query, not a semantic search query.
• Different OpenClaw sessions will appear isolated if the data root is not fixed to a shared workspace path.
• Raw text can be much larger than compact index content. Do not dump raw archives unless the user explicitly asks for them.
• If Docker is installed but the daemon is unavailable, the workflow must continue in JSON-only mode.
• The bundled OpenClaw plugin now ships four hard slash-command skills that dispatch to kmr_dispatch. This background skill remains the natural-language knowledge and workflow layer.

Validation

Always validate these points before finishing:

1. Data root resolves to a stable shared directory.
2. config/settings.json exists and is readable.
3. raw/ and index/ are writable.
4. notes-today and get-raw still work when Qdrant is disabled.
5. If rebuild-index is run, catalog.json is rebuilt from JSONL and Qdrant recall rebuild is best-effort only.

For local verification, use the test suite and package validator described in README.md and references/examples.zh-CN.md.

Output format

Use compact structured JSON for command outputs.

Default response patterns:

• Save action → { ok, action, record }
• List action → { ok, action, items }
• Fetch action → { ok, action, hits }
• Extract action → { ok, action, extraction }
• Health / rebuild → { ok, action, ... }

References

Read these files only when needed:

• Read references/action-reference.zh-CN.md when you need the full action list, argument forms, or slash-command mapping.
• Read references/architecture.zh-CN.md when you need storage design, path resolution, recovery, or Qdrant fallback behavior.
• Read references/examples.zh-CN.md when you need concrete Chinese usage examples, test commands, or install verification steps.