{"skill":{"slug":"memoria-system","displayName":"Memoria Memory System","summary":"Manages AI assistant long-term memory with layered storage for facts, events, skills, context, and fast indexing, including backup and integrity tools.","description":"# Memoria System\n\n## Overview\n\nMemoria System is a comprehensive long-term memory management system designed for AI assistants. It implements a human-like cognitive memory architecture with distinct layers for different types of information.\n\n## Memory Architecture\n\nThe system organizes memory into five distinct types, mirroring human cognitive structures:\n\n### 1. Semantic Memory (`semantic/`)\nStores factual knowledge, concepts, and general information.\n- **facts.md** - Personal facts and key information\n- **concepts.md** - Learned concepts and knowledge\n- **knowledge/** - Detailed knowledge entries\n\n### 2. Episodic Memory (`episodic/`)\nRecords events, experiences, and conversations with timestamps.\n- **YYYY-MM-DD.md** - Daily memory logs\n- **events/** - Specific event documentation\n\n### 3. Procedural Memory (`procedural/`)\nContains skills, workflows, and learned procedures.\n- **skills.md** - Acquired skills and capabilities\n- **workflows.md** - Common procedures and workflows\n- **scripts/** - Automation and utility scripts\n\n### 4. Working Memory (`working/`)\nHolds current session context and active tasks.\n- **current.md** - Active context and pending items\n- **session/** - Session-specific data\n\n### 5. Index (`index/`)\nProvides fast lookup and search capabilities.\n- **tags.json** - Tag-based indexing\n- **timeline.json** - Chronological event index\n- **search/** - Search indexes\n\n## Tools\n\n### memory-backup.sh\nCreates incremental backups of the memory system.\n\n**Usage:**\n```bash\n./memory-backup.sh [options]\n```\n\n**Options:**\n- `--dry-run` - Show what would be backed up without doing it\n- `--verbose` - Show detailed output\n- `--path PATH` - Override memory path\n- `--output PATH` - Override backup destination\n\n### memory-migrate.sh\nInitializes new memory structures or migrates existing ones.\n\n**Usage:**\n```bash\n./memory-migrate.sh {init|daily [DATE]|migrate [VERSION]}\n```\n\n**Commands:**\n- `init` - Initialize memory structure\n- `daily [DATE]` - Create daily memory file (default: today)\n- `migrate [VERSION]` - Migrate from specified version\n\n### memory-rollback.sh\nRestores memory from a previous backup.\n\n**Usage:**\n```bash\n./memory-rollback.sh {list|rollback BACKUP_NAME [--force]}\n```\n\n**Commands:**\n- `list` - List available backups\n- `rollback BACKUP_NAME` - Restore to specified backup\n\n**Options:**\n- `--force` - Skip confirmation prompt\n\n### memory-health-check.sh\nValidates memory integrity and optionally repairs issues.\n\n**Usage:**\n```bash\n./memory-health-check.sh [options]\n```\n\n**Options:**\n- `--fix` - Automatically fix detected issues\n- `--path PATH` - Override memory path\n\n## Configuration\n\nEdit `config.json` to customize behavior:\n\n```json\n{\n  \"memory\": {\n    \"base_path\": \"./memory\",\n    \"structure\": { ... }\n  },\n  \"backup\": {\n    \"enabled\": true,\n    \"retention_days\": 30,\n    \"schedule\": \"0 2 * * *\"\n  },\n  \"health_check\": {\n    \"auto_fix\": false,\n    \"check_interval_hours\": 24\n  }\n}\n```\n\n## Cron Setup\n\nAdd to crontab for automated maintenance:\n\n```bash\n# Daily backup at 2 AM\n0 2 * * * cd /path/to/memoria-system && ./memory-backup.sh\n\n# Weekly health check on Sundays at 3 AM\n0 3 * * 0 cd /path/to/memoria-system && ./memory-health-check.sh --fix\n```\n\n## Installation\n\n```bash\nopenclaw skill install memoria-system\n```\n\n## Requirements\n\n- Bash 4.0+\n- jq (for JSON processing)\n- tar (for backup compression)\n\n## License\n\nMIT\n","tags":{"ai-assistant":"1.0.0","backup":"1.0.0","cognitive":"1.0.0","knowledge-management":"1.0.0","latest":"1.0.0","long-term-memory":"1.0.0","memory":"1.0.0"},"stats":{"comments":0,"downloads":846,"installsAllTime":0,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1772098195658,"updatedAt":1778993380404},"latestVersion":{"version":"1.0.0","createdAt":1772098195658,"changelog":"Memoria记忆系统 - 基于认知科学的多层长期记忆管理方案\n为AI助手设计的完整记忆管理系统，模拟人类认知架构：\n• 语义记忆 - 存储事实、概念、用户画像\n• 情景记忆 - 记录对话历史、事件、决策\n• 程序记忆 - 保存工作流、技能、最佳实践\n• 工作记忆 - 管理当前任务、待办事项\n• 索引系统 - 支持快速检索和关联\n包含完整的备份、迁移、回滚脚本，支持定时任务自动化。\n\nMemoria System - Cognitive-inspired multi-layer long-term memory management\nA comprehensive memory management system for AI assistants, implementing human-like cognitive architecture:\n• Semantic Memory - Facts, concepts, user profiles\n• Episodic Memory - Conversation history, events, decisions  \n• Procedural Memory - Workflows, skills, best practices\n• Working Memory - Current tasks, todo items\n• Index System - Fast retrieval and association\nIncludes complete backup, migration, rollback scripts with cron automation support.\n\nfrom AI\n- Initial release of Memoria System, a long-term memory management system for AI assistants.\n- Implements human-like cognitive memory architecture with five memory types: semantic, episodic, procedural, working, and index.\n- Provides shell tools for memory backup, migration, rollback, and health checks.\n- Flexible configuration via config.json for paths, backup, and health check scheduling.\n- Includes cron examples for automated backup and maintenance.\n- Requires Bash 4.0+, jq, and tar.","license":null},"metadata":null,"owner":{"handle":"cuilinshen","userId":"s17evwh97d6trrba8hgx517x2s885zcw","displayName":"Cedric","image":"https://avatars.githubusercontent.com/u/8773134?v=4"},"moderation":null}