Correlation Memory Search

OpenClaw 插件，在检索某一主题的记忆时，依据用户定义的关联规则自动召回相关上下文，支持词边界关键词匹配、置信度评分、auto/strict/lenient 匹配模式、结果数量限制、规则缓存与规则生命周期状态，并提供规则匹配调试工具。运行时无外部依赖，只读本地文件，不发起网络请求。

ether-btc

热度 40.66

最近更新 2026-05-11 17:41:28

分类：知识依赖：读写文件应用场景：笔记整理 / 研究 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add correlation-memory

Metadata

name: correlation-memory
description: Correlation-aware memory search plugin for OpenClaw — automatically retrieves related decision contexts when you query memory. Zero external dependencies. Install as an OpenClaw plugin.
location: ~/.openclaw/extensions/correlation-memory

Correlation Memory Plugin

Correlation-aware memory search for OpenClaw — automatically retrieves related contexts when you query memory.

What It Does

When you search memory for topic X, this plugin also fetches related contexts Y and Z that consistently matter together — based on correlation rules you define.

Example: search for "backup error" → plugin also retrieves "last backup time", "recovery procedures", and "similar errors" — because those contexts are correlated by rule.

Key Features

Decision-context retrieval — surfacing related information before you ask for it
Word-boundary keyword matching — no false positives from partial matches
Confidence scoring — filter/sort by how reliable a correlation is
Multiple matching modes — auto, strict, lenient
Result limiting — max_results parameter prevents output bloat
mtime cache — rules reloaded only when correlation-rules.json changes
LRU regex cache — bounded at 500 entries, no memory leaks
Debug tool — understand why a given context triggered specific correlations
Lifecycle states — rules can be promoted/archived/disabled without deletion

Security

Zero external runtime dependencies (index.ts only imports openclaw/plugin-sdk)
Read-only local file operations (no network, no writes)
No credential or environment variable access
Workspace path resolved via OpenClaw SDK only
npm install fetches only openclaw (peerDep) + vitest (devDep, not bundled) — no postinstall scripts

Correlation Rules

Rules live in memory/correlation-rules.json in your workspace. Example:

{
  "id": "cr-config-001",
  "trigger_context": "config-change",
  "trigger_keywords": ["config", "setting", "openclaw.json", "modify"],
  "must_also_fetch": ["backup-location", "rollback-instructions"],
  "relationship_type": "constrains",
  "confidence": 0.95,
  "lifecycle": { "state": "promoted" }
}

Active states: promoted, active, testing, validated, proposal

Tools Provided

Tool	Description
`memory_search_with_correlation`	Enhanced memory search — automatically fetches correlated contexts from correlation rules
`correlation_check`	Debug tool — shows which rules matched and why without performing searches

Installation

cd ~/.openclaw/extensions
git clone https://github.com/ether-btc/openclaw-correlation-plugin.git correlation-memory
cd correlation-memory && npm install

# Add to openclaw.json
openclaw plugins install correlation-memory
openclaw gateway restart

Requires OpenClaw >= 2026.1.26.

Note: npm install pulls the OpenClaw peer dependency and vitest (dev/test only). The runtime plugin makes no network calls and has zero external dependencies.