feat(examples): OpenClaw → OpenViking memory migration tool

[deepakdevp]

Closes #1011.

Summary

• Adds examples/openclaw-migration/migrate.py — a standalone script that imports OpenClaw workspace memory files directly into OpenViking's memory system
• Zero LLM calls: uses MemoryExtractor.create_memory() + SessionCompressor._index_memory() for direct write + embedding enqueue
• Adds examples/openclaw-migration/README.md with usage guide, category mapping table, and dry-run example
• Adds tests/unit/test_openclaw_migration.py — 25 unit tests, no OV server required

Category mapping

OpenClaw file	OV category	Reasoning
MEMORY.md, memory.md	entities	Curated durable knowledge
YYYY-MM-DD.md	events	Daily logs / time-stamped records
YYYY-MM-DD-slug.md	cases	Session summaries
Everything else	entities	Safe fallback

--category flag overrides all files to a single category.

Test plan

• PYTHONPATH=. .venv/bin/python -m pytest tests/unit/test_openclaw_migration.py -v --no-cov → 25 passed
• python examples/openclaw-migration/migrate.py --dry-run against a real OpenClaw workspace
• Real run with --ov-data-dir ./test-data --user-id testuser, verify memories appear under viking://user/testuser/memories/

🤖 Generated with Claude Code

[github-actions]

PR Reviewer Guide 🔍

Here are some key observations to aid the review process:

🎫 Ticket compliance analysis 🔶 1011 - Partially compliant Compliant requirements: Added migration script examples/openclaw-migration/migrate.py Reads OpenClaw workspace files Uses direct memory write/embedding enqueue Includes --dry-run, --openclaw-dir, --ov-data-dir, etc. flags Added unit tests and documentation Non-compliant requirements: No resume capability implemented "cases" category used which is not a valid OpenViking MemoryCategory Requires further human verification: Real run with actual OpenClaw workspace and OpenViking installation

⏱️ Estimated effort to review: 3 🔵🔵🔵⚪⚪

🏅 Score: 78

🧪 PR contains tests

🔒 No security concerns identified

✅ No TODO sections

🔀 No multiple PR themes

⚡ Recommended focus areas for review Invalid MemoryCategory The script uses "cases" as a memory category, which is not one of the 6 valid OpenViking MemoryCategory values (PREFERENCES, ENTITIES, PATTERNS, EVENTS, TOOLS, SKILLS). This will cause a ValueError when processing session summary files (YYYY-MM-DD-slug.md). return "cases" Invalid CLI Category Choice The --category flag accepts "cases" as an option, which is not a valid MemoryCategory. This will cause failures when users specify --category cases. choices=["entities", "events", "cases", "preferences"],

[github-actions]

PR Code Suggestions ✨

No code suggestions found for the PR.