openclaw-cortex-memory 0.1.0-Alpha.30 → 0.1.0-Alpha.32

package/schema/graph.schema.yaml

@@ -66,21 +66,41 @@
     "Assumption",
     "Concept",
     "Resource",
-    "Document"
+    "Document",
+    "ConfigFile",
+    "Preference",
+    "Case",
+    "Pattern",
+    "Date"
   ],
   "entityAliases": {
     "OpenClaw": ["openclaw", "插件", "该项目", "本项目"],
     "FamilyMember": ["家人", "家庭成员", "亲人"],
     "Friend": ["朋友", "好友"],
+    "Team": ["团队", "小组", "组", "班组"],
     "Location": ["地点", "位置", "住址", "地址"],
     "Event": ["活动", "事情", "事项"],
     "Schedule": ["日程", "安排", "计划表"],
     "Habit": ["习惯", "作息"],
     "HealthItem": ["健康", "体检", "药物", "锻炼"],
     "FinanceItem": ["账单", "支出", "收入", "预算"],
-    "Person": ["我", "自己", "本人", "同事", "客户", "用户"],
-    "Project": ["项目", "工程"],
-    "Task": ["任务", "待办", "todo"],
+    "Plan": ["计划", "方案", "路线图"],
+    "Preference": ["偏好", "习惯选择"],
+    "Document": ["文档", "说明文档", "手册", "wiki", "README", "PRD", "方案文档"],
+    "Resource": ["资源", "物品", "物件", "设备", "工具", "素材", "资产"],
+    "ConfigFile": ["配置文件", "config", "配置"],
+    "Decision": ["决策", "决定", "拍板"],
+    "Action": ["动作", "操作", "执行"],
+    "Risk": ["风险", "隐患"],
+    "Blocker": ["阻塞", "卡点", "障碍"],
+    "Assumption": ["假设", "前提"],
+    "Concept": ["概念", "术语"],
+    "Case": ["案例", "case"],
+    "Pattern": ["模式", "pattern"],
+    "Date": ["日期", "时间", "时间点"],
+    "Person": ["我", "自己", "本人", "同事", "客户", "用户", "姓名", "名字", "人名", "成员", "联系人"],
+    "Project": ["项目", "工程", "项目线"],
+    "Task": ["任务", "待办", "todo", "工单", "事项"],
     "Milestone": ["里程碑", "节点"],
     "Issue": ["问题", "故障", "报错"],
     "Fix": ["修复", "解决方案"]
@@ -88,88 +108,223 @@
   "relationTypes": [
     "depends_on",
     "blocks",
-    "related_to",
+    "unblocks",
     "causes",
+    "impacts",
     "resolves",
+    "encountered_bug",
+    "solved_with",
+    "uses_tech",
+    "integrates_with",
+    "migrates_to",
+    "replaced_by",
+    "has_subtask",
+    "belongs_to",
+    "owned_by",
+    "implements",
+    "requires",
     "plans_to",
+    "planned_for",
     "scheduled_for",
+    "references",
+    "documents",
+    "defined_in",
+    "configured_in",
+    "supports",
+    "conflicts_with",
+    "duplicates",
+    "supersedes",
+    "assigned_to",
+    "reviewed_by",
+    "approved_by",
+    "rejected_by",
+    "reported_by",
     "lives_in",
     "cares_for",
     "pays_for",
-    "supports",
-    "conflicts_with",
-    "belongs_to",
-    "owned_by",
-    "references",
     "prefers",
-    "implements",
-    "requires"
+    "has_spouse",
+    "has_child",
+    "birthday_on",
+    "anniversary_on"
   ],
   "relationTypeAliases": {
     "dependency": "depends_on",
     "blocked_by": "blocks",
-    "linked_to": "related_to",
+    "unblock": "unblocks",
+    "impact": "impacts",
     "plan_to": "plans_to",
+    "plan_for": "planned_for",
     "schedule_for": "scheduled_for",
     "located_in": "lives_in",
     "care_for": "cares_for",
     "pay_for": "pays_for",
     "support": "supports",
     "conflict_with": "conflicts_with",
+    "use_tech": "uses_tech",
+    "tech_stack": "uses_tech",
+    "integrate_with": "integrates_with",
+    "migrate_to": "migrates_to",
+    "replace_by": "replaced_by",
+    "replace_with": "replaced_by",
+    "bug": "encountered_bug",
+    "bug_on": "encountered_bug",
+    "fix_with": "solved_with",
+    "solve_with": "solved_with",
+    "solved_by": "solved_with",
+    "subtask_of": "has_subtask",
+    "child_task": "has_subtask",
+    "documented_by": "documents",
+    "defined_by": "defined_in",
+    "config_in": "configured_in",
+    "duplicate_of": "duplicates",
+    "superseded_by": "supersedes",
+    "assign_to": "assigned_to",
+    "review_by": "reviewed_by",
+    "approve_by": "approved_by",
+    "reject_by": "rejected_by",
+    "report_by": "reported_by",
     "依赖于": "depends_on",
     "依赖": "depends_on",
     "取决于": "depends_on",
     "阻塞": "blocks",
     "卡住": "blocks",
+    "解除阻塞": "unblocks",
     "导致": "causes",
     "引起": "causes",
+    "影响": "impacts",
     "解决": "resolves",
     "修复": "resolves",
+    "遇到报错": "encountered_bug",
+    "通过": "solved_with",
+    "使用技术": "uses_tech",
+    "集成": "integrates_with",
+    "迁移到": "migrates_to",
+    "被替代": "replaced_by",
+    "子任务": "has_subtask",
     "属于": "belongs_to",
     "归属": "belongs_to",
     "负责": "owned_by",
     "由": "owned_by",
-    "参考": "references",
-    "引用": "references",
-    "偏好": "prefers",
-    "更喜欢": "prefers",
     "实现": "implements",
     "需要": "requires",
     "计划做": "plans_to",
     "打算": "plans_to",
+    "计划于": "planned_for",
     "安排在": "scheduled_for",
     "约在": "scheduled_for",
+    "参考": "references",
+    "引用": "references",
+    "记录": "documents",
+    "定义于": "defined_in",
+    "配置于": "configured_in",
+    "支持": "supports",
+    "冲突": "conflicts_with",
+    "矛盾": "conflicts_with",
+    "重复": "duplicates",
+    "取代": "supersedes",
+    "分配给": "assigned_to",
+    "评审": "reviewed_by",
+    "批准": "approved_by",
+    "拒绝": "rejected_by",
+    "报告": "reported_by",
     "住在": "lives_in",
     "居住在": "lives_in",
     "照顾": "cares_for",
     "看护": "cares_for",
     "支付": "pays_for",
     "付款": "pays_for",
-    "支持": "supports",
-    "冲突": "conflicts_with",
-    "矛盾": "conflicts_with",
-    "相关": "related_to",
-    "有关": "related_to",
+    "偏好": "prefers",
+    "更喜欢": "prefers",
+    "配偶": "has_spouse",
+    "孩子": "has_child",
+    "生日": "birthday_on",
+    "纪念日": "anniversary_on",
     "belongs": "belongs_to",
     "owner_of": "owned_by",
     "refer_to": "references",
     "preference_for": "prefers",
     "implement": "implements",
-    "need": "requires"
+    "need": "requires",
+    "technology": "uses_tech",
+    "encountered_issue": "encountered_bug",
+    "spouse": "has_spouse",
+    "wife_of": "has_spouse",
+    "husband_of": "has_spouse",
+    "child_of": "has_child",
+    "parent_of": "has_child",
+    "birthday": "birthday_on",
+    "born_on": "birthday_on",
+    "anniversary": "anniversary_on",
+    "married_on": "anniversary_on"
   },
   "relationRules": [
-    { "type": "depends_on", "fromTypes": ["Task", "Plan", "Milestone"], "toTypes": ["Task", "Plan", "Milestone"], "allowSelfLoop": false },
-    { "type": "blocks", "fromTypes": ["Issue", "Task", "Risk"], "toTypes": ["Task", "Plan"], "allowSelfLoop": false },
-    { "type": "causes", "fromTypes": ["Issue", "Risk", "Assumption"], "toTypes": ["Issue", "Risk"], "allowSelfLoop": false },
-    { "type": "resolves", "fromTypes": ["Fix", "Decision", "Action"], "toTypes": ["Issue", "Blocker"], "allowSelfLoop": false },
-    { "type": "belongs_to", "fromTypes": ["Task", "Issue", "Fix", "Decision"], "toTypes": ["Project", "Plan", "Milestone"], "allowSelfLoop": false },
-    { "type": "owned_by", "fromTypes": ["Task", "Plan", "Project", "Issue"], "toTypes": ["Person", "Team"], "allowSelfLoop": false }
+    { "type": "depends_on", "fromTypes": ["Task", "Plan", "Milestone", "Issue"], "toTypes": ["Task", "Plan", "Milestone", "Issue", "Resource"], "allowSelfLoop": false },
+    { "type": "blocks", "fromTypes": ["Issue", "Task", "Risk", "Blocker"], "toTypes": ["Task", "Plan", "Milestone"], "allowSelfLoop": false },
+    { "type": "unblocks", "fromTypes": ["Fix", "Action", "Decision"], "toTypes": ["Task", "Issue", "Blocker"], "allowSelfLoop": false },
+    { "type": "causes", "fromTypes": ["Issue", "Risk", "Assumption"], "toTypes": ["Issue", "Risk", "Blocker"], "allowSelfLoop": false },
+    { "type": "impacts", "fromTypes": ["Issue", "Risk", "Task", "Project", "Event"], "toTypes": ["Task", "Project", "Issue", "Milestone", "Event"], "allowSelfLoop": false },
+    { "type": "resolves", "fromTypes": ["Fix", "Decision", "Action"], "toTypes": ["Issue", "Blocker", "Risk"], "allowSelfLoop": false },
+    { "type": "encountered_bug", "fromTypes": ["Project", "Task", "Action"], "toTypes": ["Issue", "Blocker"], "allowSelfLoop": false },
+    { "type": "solved_with", "fromTypes": ["Issue", "Blocker", "Task"], "toTypes": ["Fix", "Action", "Decision", "Resource", "Document"], "allowSelfLoop": false },
+    { "type": "uses_tech", "fromTypes": ["Project", "Task", "Fix", "Action"], "toTypes": ["Resource", "Document", "ConfigFile", "Project"], "allowSelfLoop": false },
+    { "type": "integrates_with", "fromTypes": ["Project", "Task", "Resource"], "toTypes": ["Project", "Resource"], "allowSelfLoop": false },
+    { "type": "migrates_to", "fromTypes": ["Project", "Task", "Resource", "ConfigFile"], "toTypes": ["Project", "Resource", "ConfigFile"], "allowSelfLoop": false },
+    { "type": "replaced_by", "fromTypes": ["Project", "Task", "Resource", "Fix"], "toTypes": ["Project", "Task", "Resource", "Fix"], "allowSelfLoop": false },
+    { "type": "has_subtask", "fromTypes": ["Project", "Plan", "Milestone", "Task"], "toTypes": ["Task"], "allowSelfLoop": false },
+    { "type": "belongs_to", "fromTypes": ["Task", "Issue", "Fix", "Decision", "Document"], "toTypes": ["Project", "Plan", "Milestone", "Event"], "allowSelfLoop": false },
+    { "type": "owned_by", "fromTypes": ["Task", "Plan", "Project", "Issue", "Resource"], "toTypes": ["Person", "Team"], "allowSelfLoop": false },
+    { "type": "implements", "fromTypes": ["Task", "Fix", "Project", "Document"], "toTypes": ["Plan", "Milestone", "Concept"], "allowSelfLoop": false },
+    { "type": "requires", "fromTypes": ["Task", "Fix", "Project", "Issue", "Plan"], "toTypes": ["Task", "Resource", "Document", "ConfigFile", "Date"], "allowSelfLoop": false },
+    { "type": "planned_for", "fromTypes": ["Task", "Plan", "Milestone"], "toTypes": ["Date", "Schedule", "Milestone"], "allowSelfLoop": false },
+    { "type": "scheduled_for", "fromTypes": ["Task", "Event", "Plan"], "toTypes": ["Date", "Schedule"], "allowSelfLoop": false },
+    { "type": "references", "fromTypes": ["Task", "Issue", "Fix", "Document", "Project"], "toTypes": ["Document", "Resource", "ConfigFile"], "allowSelfLoop": false },
+    { "type": "documents", "fromTypes": ["Document", "Project", "Task"], "toTypes": ["Issue", "Fix", "Decision", "Event", "Case", "Pattern"], "allowSelfLoop": false },
+    { "type": "defined_in", "fromTypes": ["Task", "Issue", "Fix", "Pattern", "Case"], "toTypes": ["Document", "ConfigFile"], "allowSelfLoop": false },
+    { "type": "configured_in", "fromTypes": ["Task", "Fix", "Resource", "Project"], "toTypes": ["ConfigFile", "Document"], "allowSelfLoop": false },
+    { "type": "supports", "fromTypes": ["Resource", "Project", "Task", "Fix"], "toTypes": ["Task", "Project", "Issue", "Fix"], "allowSelfLoop": false },
+    { "type": "conflicts_with", "fromTypes": ["Task", "Plan", "Resource", "ConfigFile", "Issue"], "toTypes": ["Task", "Plan", "Resource", "ConfigFile", "Issue"], "allowSelfLoop": false },
+    { "type": "duplicates", "fromTypes": ["Issue", "Task", "Fix", "Document"], "toTypes": ["Issue", "Task", "Fix", "Document"], "allowSelfLoop": false },
+    { "type": "supersedes", "fromTypes": ["Fix", "Decision", "Document", "Plan", "Task"], "toTypes": ["Fix", "Decision", "Document", "Plan", "Task"], "allowSelfLoop": false },
+    { "type": "assigned_to", "fromTypes": ["Task", "Issue", "Fix", "Action"], "toTypes": ["Person", "Team"], "allowSelfLoop": false },
+    { "type": "reviewed_by", "fromTypes": ["Fix", "Task", "Document", "Decision"], "toTypes": ["Person", "Team"], "allowSelfLoop": false },
+    { "type": "approved_by", "fromTypes": ["Fix", "Task", "Document", "Decision"], "toTypes": ["Person", "Team"], "allowSelfLoop": false },
+    { "type": "rejected_by", "fromTypes": ["Fix", "Task", "Document", "Decision"], "toTypes": ["Person", "Team"], "allowSelfLoop": false },
+    { "type": "reported_by", "fromTypes": ["Issue", "Risk", "Blocker"], "toTypes": ["Person", "Team"], "allowSelfLoop": false },
+    { "type": "lives_in", "fromTypes": ["Person", "FamilyMember"], "toTypes": ["Location"], "allowSelfLoop": false },
+    { "type": "cares_for", "fromTypes": ["Person", "FamilyMember"], "toTypes": ["Person", "FamilyMember"], "allowSelfLoop": false },
+    { "type": "pays_for", "fromTypes": ["Person", "FamilyMember"], "toTypes": ["Person", "FamilyMember", "FinanceItem"], "allowSelfLoop": false },
+    { "type": "prefers", "fromTypes": ["Person", "Team"], "toTypes": ["Preference", "Resource", "Project", "Location", "Pattern"], "allowSelfLoop": false },
+    { "type": "has_spouse", "fromTypes": ["Person"], "toTypes": ["Person", "FamilyMember"], "allowSelfLoop": false },
+    { "type": "has_child", "fromTypes": ["Person", "FamilyMember"], "toTypes": ["Person", "FamilyMember"], "allowSelfLoop": false },
+    { "type": "birthday_on", "fromTypes": ["Person", "FamilyMember"], "toTypes": ["Date"], "allowSelfLoop": false },
+    { "type": "anniversary_on", "fromTypes": ["Person", "FamilyMember"], "toTypes": ["Date"], "allowSelfLoop": false }
+  ],
+  "highValueRelationTypes": [
+    "depends_on",
+    "blocks",
+    "unblocks",
+    "causes",
+    "impacts",
+    "resolves",
+    "encountered_bug",
+    "solved_with",
+    "uses_tech",
+    "integrates_with",
+    "migrates_to",
+    "replaced_by",
+    "has_subtask",
+    "belongs_to",
+    "owned_by",
+    "implements",
+    "requires",
+    "planned_for",
+    "scheduled_for"
   ],
-  "highValueRelationTypes": ["depends_on", "blocks", "resolves", "owned_by"],
-  "relatedToMaxRatio": 0.35,
-  "relatedToMaxAbsolute": 2,
+  "relatedToMaxRatio": 0,
+  "relatedToMaxAbsolute": 0,
   "minRelationConfidence": 0.35,
   "evidenceSpanRequired": true,
   "endpointMentionRequired": true,
   "defaultEntityType": "Concept"
-}
+}

package/skills/cortex-memory/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: cortex-memory
+description: Independent skill for Cortex Memory operations in OpenClaw. Use when users ask for cross-session memory continuity, prior decisions, preferences, relationship tracing, or memory maintenance. If the memory plugin is not installed, guide users to install and enable openclaw-cortex-memory first, then continue with normal memory workflows.
+homepage: https://github.com/deki18/openclaw-cortex-memory
+metadata: { "openclaw": { "os": ["darwin", "linux", "win32"], "primaryEnv": "EMBEDDING_API_KEY" } }
+---
+
+# Cortex Memory
+
+This is an independent skill, not a plugin-embedded skill.
+
+Use this runtime flow:
+
+1. Check whether plugin `openclaw-cortex-memory` is available.
+2. If missing or disabled, run the install bootstrap guide in `{baseDir}/references/agent-manual.md` with README-consistent install order.
+3. After plugin is enabled, run memory retrieval or write operations.
+
+After plugin is ready, use this default workflow:
+
+1. Retrieve candidate memory with `search_memory`.
+2. If the user asks about entity links or dependency paths, use `query_graph`.
+3. If `query_graph` returns `conflict_hint`, use `list_graph_conflicts` and ask user confirmation before `resolve_graph_conflict`.
+4. For graph status snapshots or projection consistency checks, use `export_graph_view` and `lint_memory_wiki`.
+5. Answer with retrieved evidence first, then add reasoning.
+6. If the turn introduces durable new information, persist it with `store_event`.
+7. For maintenance windows or session wrap-up, run `sync_memory` and optionally `reflect_memory`.
+
+If tool calls fail:
+
+1. Run `diagnostics`.
+2. Tell the user the plugin is unavailable or misconfigured.
+3. Continue with a normal answer without fabricating memory hits.
+
+Do not use this skill for:
+
+- Real-time web facts (weather, stock, breaking news).
+- One-off temporary context that should not be persisted.
+
+Use these local references when needed:
+
+- Install and bootstrap playbook: `{baseDir}/references/agent-manual.md`
+- System prompt template: `{baseDir}/references/system-prompt-template.md`
+- Tool details: `{baseDir}/references/tools.md`
+- Config and dependency setup: `{baseDir}/references/configuration.md`
+- Publish and validation checklist: `{baseDir}/references/publish-checklist.md`
+
+Use this script for a quick environment preflight:
+
+- `{baseDir}/scripts/smoke-check.ps1 -Json`

package/skills/cortex-memory/references/agent-manual.md

@@ -0,0 +1,115 @@
+# Cortex Memory Agent Manual
+
+## Goal
+
+Use Cortex Memory as a long-term memory layer in OpenClaw. This manual is for agents operating from the independent `cortex-memory` skill folder.
+
+## Phase 1: Plugin Availability Check
+
+Run:
+
+```bash
+openclaw plugins list
+openclaw plugins inspect openclaw-cortex-memory
+```
+
+If plugin exists and is enabled, continue to Phase 3.
+
+If plugin is missing or disabled, go to Phase 2.
+
+## Phase 2: Install and Enable Plugin
+
+Preferred install path (README default):
+
+```bash
+openclaw plugins install clawhub:openclaw-cortex-memory
+openclaw plugins enable openclaw-cortex-memory
+```
+
+Fallback install path:
+
+```bash
+npm pack openclaw-cortex-memory@0.1.0-Alpha.30
+openclaw plugins install ./openclaw-cortex-memory-0.1.0-Alpha.30.tgz
+openclaw plugins enable openclaw-cortex-memory
+rm ./openclaw-cortex-memory-0.1.0-Alpha.30.tgz
+```
+
+Then verify:
+
+```bash
+openclaw plugins list
+openclaw plugins inspect openclaw-cortex-memory
+```
+
+If config is not ready, apply the baseline from `configuration.md`.
+
+If the user asks for "system prompt rules", use `{baseDir}/references/system-prompt-template.md`.
+
+## Phase 3: Runtime Workflow
+
+### Retrieval-first answers
+
+1. `search_memory` with the user query.
+2. `query_graph` when relationship/path reasoning is needed.
+3. If `query_graph` returns `conflict_hint`, run `list_graph_conflicts` and confirm with user before `resolve_graph_conflict`.
+4. Respond with evidence first, reasoning second.
+
+### Persistence
+
+Use `store_event` only for durable information:
+
+- stable preferences
+- project decisions
+- long-lived constraints
+
+Avoid persisting ephemeral chatter.
+
+### Maintenance
+
+- `sync_memory` for historical import
+- `reflect_memory` for rule extraction
+- `backfill_embeddings` for vector repair
+- `export_graph_view` for status-aware graph snapshots
+- `lint_memory_wiki` for projection consistency checks
+- `diagnostics` when anything looks inconsistent
+
+## Failure Handling
+
+If plugin tools are unavailable:
+
+1. Run `diagnostics`.
+2. Explain the issue clearly (plugin disabled, config incomplete, endpoint unavailable, or API key missing).
+3. Provide immediate next action with exact command.
+
+If install or enable flow reports a `memory-lancedb` config requirement, add this block under `plugins.entries` in `openclaw.json`:
+
+```json
+"memory-lancedb": {
+  "enabled": false,
+  "config": {
+    "embedding": {
+      "apiKey": "${MEMORY_LANCEDB_API_KEY}",
+      "model": "text-embedding-3-small"
+    },
+    "dbPath": "~/.openclaw/memory/lancedb",
+    "autoRecall": true,
+    "autoCapture": false,
+    "captureMaxChars": 500
+  }
+}
+```
+
+## Operator Commands Cheat Sheet
+
+```bash
+openclaw plugins install clawhub:openclaw-cortex-memory
+openclaw plugins enable openclaw-cortex-memory
+openclaw plugins inspect openclaw-cortex-memory
+npm pack openclaw-cortex-memory@0.1.0-Alpha.30
+openclaw plugins install ./openclaw-cortex-memory-0.1.0-Alpha.30.tgz
+openclaw plugins enable openclaw-cortex-memory
+rm ./openclaw-cortex-memory-0.1.0-Alpha.30.tgz
+openclaw skills info cortex-memory
+openclaw skills check
+```

package/skills/cortex-memory/references/configuration.md

@@ -0,0 +1,92 @@
+# Configuration Reference
+
+## Minimum OpenClaw Config
+
+Use this as the baseline in `openclaw.json`.
+
+```json
+{
+  "plugins": {
+    "allow": ["openclaw-cortex-memory"],
+    "slots": {
+      "memory": "none"
+    },
+    "entries": {
+      "openclaw-cortex-memory": {
+        "enabled": true,
+        "config": {
+          "autoSync": true,
+          "autoReflect": false,
+          "graphQualityMode": "warn",
+          "wikiProjection": {
+            "enabled": true,
+            "mode": "incremental",
+            "maxBatch": 100
+          },
+          "embedding": {
+            "provider": "api",
+            "model": "text-embedding-3-large",
+            "apiKey": "${EMBEDDING_API_KEY}",
+            "baseURL": "https://your-embedding-endpoint/v1",
+            "dimensions": 3072
+          },
+          "llm": {
+            "provider": "api",
+            "model": "gpt-4",
+            "apiKey": "${LLM_API_KEY}",
+            "baseURL": "https://your-llm-endpoint/v1"
+          },
+          "reranker": {
+            "provider": "api",
+            "model": "BAAI/bge-reranker-v2-m3",
+            "apiKey": "${RERANKER_API_KEY}",
+            "baseURL": "https://your-reranker-endpoint/v1/rerank"
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+## Required Environment Variables
+
+- `EMBEDDING_API_KEY`
+- `LLM_API_KEY`
+- `RERANKER_API_KEY`
+
+## Required Endpoints
+
+- Embedding: OpenAI-compatible `/embeddings`
+- LLM: OpenAI-compatible `/chat/completions`
+- Reranker: `/rerank`
+
+## Troubleshooting: memory-lancedb Requirement
+
+If `openclaw plugins install/enable` reports a `memory-lancedb` config requirement, add this entry under `plugins.entries`:
+
+```json
+"memory-lancedb": {
+  "enabled": false,
+  "config": {
+    "embedding": {
+      "apiKey": "${MEMORY_LANCEDB_API_KEY}",
+      "model": "text-embedding-3-small"
+    },
+    "dbPath": "~/.openclaw/memory/lancedb",
+    "autoRecall": true,
+    "autoCapture": false,
+    "captureMaxChars": 500
+  }
+}
+```
+
+## Recommended Validation Commands
+
+```bash
+openclaw plugins list
+openclaw plugins inspect openclaw-cortex-memory
+openclaw skills list
+openclaw skills info cortex-memory
+openclaw skills check
+```

package/skills/cortex-memory/references/publish-checklist.md

@@ -0,0 +1,46 @@
+# ClawHub Publish Checklist
+
+## Preflight
+
+1. Confirm skill root contains `SKILL.md`.
+2. Confirm frontmatter includes:
+   - `name`
+   - `description`
+3. Confirm no secret values are hardcoded in skill files.
+
+## Local Validation
+
+```bash
+openclaw skills list
+openclaw skills info cortex-memory
+openclaw skills check
+```
+
+Optional plugin validation:
+
+```bash
+openclaw plugins list
+openclaw plugins inspect openclaw-cortex-memory
+```
+
+## Publish
+
+```bash
+clawhub login
+clawhub whoami
+clawhub skill publish ./skills/cortex-memory --slug cortex-memory --name "Cortex Memory" --version 0.1.0 --changelog "Initial ClawHub release" --tags latest
+```
+
+## Install Test (Clean Workspace)
+
+```bash
+openclaw skills install cortex-memory
+openclaw skills info cortex-memory
+```
+
+## Post Publish
+
+1. Start a new session.
+2. Trigger retrieval workflow with a memory-related prompt.
+3. Verify skill appears and is eligible in `openclaw skills list --eligible`.
+

package/skills/cortex-memory/references/system-prompt-template.md

@@ -0,0 +1,27 @@
+# Cortex Memory 系统提示词模板
+
+可直接粘贴到 Agent 系统提示词中：
+
+## Cortex Memory 记忆插件使用规则（核心规则，不允许删除）
+
+你已接入 Cortex Memory。必须遵循以下规则：
+
+1. 禁止臆造历史事实；凡涉及历史对话、用户偏好、项目既有决策，先检索再回答。  
+2. 单个任务内避免重复写入：`store_event` / `reflect_memory` 仅在关键节点或收尾触发一次。  
+3. 用户询问历史信息、偏好、项目上下文时：先调用 `search_memory`，再回答。  
+4. 需要当前会话热上下文时：调用 `get_hot_context`。  
+5. 需要自动召回相关记忆时：调用 `get_auto_context`。  
+6. 需要实体关系、依赖链路或路径关系时：调用 `query_graph`。  
+7. 仅在“重要事项已结束且结论明确”后调用 `store_event` 记录结果（过程进行中不频繁记录）。  
+8. 当任务经历“失败 -> 调整 -> 成功”时：先用 `store_event` 记录失败原因与成功方案，再调用 `reflect_memory` 沉淀可复用规则。  
+9. 需要导入历史会话时：调用 `sync_memory`。  
+10. 当 `diagnostics` 显示 active/archive 有未向量化记录，或迁移后需重建向量层时：调用 `backfill_embeddings`（按需选择 `incremental` / `vector_only` / `full`）。  
+11. 出现配置校验失败、记忆读写异常、检索结果异常或数据目录问题时：优先调用 `diagnostics`。  
+12. 仅在用户明确要求删除记忆，且已确认 `memory_id` 时，才调用 `delete_memory`；禁止在未确认情况下自动删除。  
+13. 任一工具调用失败时，先重试一次；仍失败则明确告知用户，并基于当前可得上下文继续完成任务。  
+14. 调用任意 Cortex Memory 工具前，先确认当前运行环境可见该工具；若工具不可见，必须立即报告“当前 lane 不可用”，不得虚构执行结果。  
+15. `sync_memory` 属于关键路径任务：执行前后应避免并发重复触发；若已有同任务进行中，复用当前结果或等待完成。  
+16. 当用户明确请求 Cortex Memory 任务（如 `sync_memory` / `search_memory` / `store_event`）时，禁止切换到无关流程（如心跳巡检、日报、闲聊任务）；若被系统任务打断，先完成用户请求再处理后台任务。  
+17. 当 `query_graph` 返回 `conflict_hint` 时，不得静默覆盖冲突事实；先调用 `list_graph_conflicts` 并与用户确认，再调用 `resolve_graph_conflict`。  
+18. 需要说明图谱状态分布、冲突生命周期或可视化快照时，调用 `export_graph_view`。  
+19. 需要排查图谱与 Wiki 投影一致性时，调用 `lint_memory_wiki` 并按 `next_action` 执行修复。