openclaw-cortex-memory 0.1.0-Alpha.24 → 0.1.0-Alpha.25
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +26 -0
- package/SKILL.md +6 -0
- package/dist/openclaw.plugin.json +22 -1
- package/openclaw.plugin.json +22 -1
- package/package.json +23 -1
package/README.md
CHANGED
|
@@ -138,6 +138,32 @@ openclaw gateway restart
|
|
|
138
138
|
}
|
|
139
139
|
```
|
|
140
140
|
|
|
141
|
+
## 外部端点与凭证声明（审查说明）
|
|
142
|
+
|
|
143
|
+
本插件是本地长期记忆系统，但以下能力依赖用户自配置的外部模型端点：
|
|
144
|
+
|
|
145
|
+
- `embedding`：向量化（`/embeddings`）
|
|
146
|
+
- `llm`：写入门控、规则反思、读融合（`/chat/completions`）
|
|
147
|
+
- `reranker`：候选重排序（`/rerank`）
|
|
148
|
+
|
|
149
|
+
对应凭证要求：
|
|
150
|
+
|
|
151
|
+
- 环境变量（可选）：`EMBEDDING_API_KEY`、`LLM_API_KEY`、`RERANKER_API_KEY`
|
|
152
|
+
- 插件配置（常用）：`embedding.apiKey`、`llm.apiKey`、`reranker.apiKey`
|
|
153
|
+
- 端点配置：`embedding.baseURL`、`llm.baseURL`、`reranker.baseURL`
|
|
154
|
+
|
|
155
|
+
### 网络发送的数据边界
|
|
156
|
+
|
|
157
|
+
- 会发送：用于模型推理的文本片段（如 query、候选摘要、转写片段、待向量化文本）
|
|
158
|
+
- 不会主动发送：本地配置文件原文、系统环境变量全集、插件状态文件全集
|
|
159
|
+
- 凭证使用方式：仅作为 `Authorization: Bearer` 请求头调用你配置的端点
|
|
160
|
+
|
|
161
|
+
### 风险与建议
|
|
162
|
+
|
|
163
|
+
- 你应只配置可信模型网关，密钥权限最小化（建议专用 key）
|
|
164
|
+
- 生产环境建议启用网关审计与请求日志脱敏
|
|
165
|
+
- 如不希望联网推理，不要配置外部端点/密钥（相关能力将降级或跳过）
|
|
166
|
+
|
|
141
167
|
<details>
|
|
142
168
|
<summary>高级配置（默认已内置，不懂可以不改）</summary>
|
|
143
169
|
|
package/SKILL.md
CHANGED
|
@@ -65,6 +65,12 @@ metadata:
|
|
|
65
65
|
先用最小配置跑通：`embedding`、`llm`、`reranker` + `autoSync`。
|
|
66
66
|
高级项（`readFusion`、`memoryDecay`、`vectorChunking`、`writePolicy`、`readTuning`）都有默认值，不需要一开始就调整。
|
|
67
67
|
|
|
68
|
+
## 安全与端点声明
|
|
69
|
+
|
|
70
|
+
- 本插件需要外部端点：`/embeddings`、`/chat/completions`、`/rerank`
|
|
71
|
+
- 凭证来源：环境变量或插件配置中的 `*.apiKey`
|
|
72
|
+
- 仅发送推理所需文本片段，不主动上传本地配置文件全集或环境变量全集
|
|
73
|
+
|
|
68
74
|
## 关键事实
|
|
69
75
|
|
|
70
76
|
- `backfill_embeddings` 已实现且已注册。
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"id": "openclaw-cortex-memory",
|
|
3
3
|
"name": "Cortex Memory",
|
|
4
|
-
"version": "0.1.0-Alpha.
|
|
4
|
+
"version": "0.1.0-Alpha.25",
|
|
5
5
|
"description": "Long-term memory system with semantic, episodic, and procedural memory for AI Agents",
|
|
6
6
|
"main": "dist/index.js",
|
|
7
7
|
"author": "deki18",
|
|
@@ -18,6 +18,27 @@
|
|
|
18
18
|
"channels": false,
|
|
19
19
|
"memory": true
|
|
20
20
|
},
|
|
21
|
+
"runtimeRequirements": {
|
|
22
|
+
"requiresCredentials": true,
|
|
23
|
+
"requiresNetwork": true,
|
|
24
|
+
"credentialSources": {
|
|
25
|
+
"env": [
|
|
26
|
+
"EMBEDDING_API_KEY",
|
|
27
|
+
"LLM_API_KEY",
|
|
28
|
+
"RERANKER_API_KEY"
|
|
29
|
+
],
|
|
30
|
+
"pluginConfig": [
|
|
31
|
+
"embedding.apiKey",
|
|
32
|
+
"llm.apiKey",
|
|
33
|
+
"reranker.apiKey"
|
|
34
|
+
]
|
|
35
|
+
},
|
|
36
|
+
"externalEndpoints": {
|
|
37
|
+
"embedding": "OpenAI-compatible /embeddings endpoint",
|
|
38
|
+
"llm": "OpenAI-compatible /chat/completions endpoint",
|
|
39
|
+
"reranker": "Reranker /rerank endpoint"
|
|
40
|
+
}
|
|
41
|
+
},
|
|
21
42
|
"hooks": [
|
|
22
43
|
"message_received",
|
|
23
44
|
"session_end"
|
package/openclaw.plugin.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"id": "openclaw-cortex-memory",
|
|
3
3
|
"name": "Cortex Memory",
|
|
4
|
-
"version": "0.1.0-Alpha.
|
|
4
|
+
"version": "0.1.0-Alpha.25",
|
|
5
5
|
"description": "Long-term memory system with semantic, episodic, and procedural memory for AI Agents",
|
|
6
6
|
"main": "dist/index.js",
|
|
7
7
|
"author": "deki18",
|
|
@@ -18,6 +18,27 @@
|
|
|
18
18
|
"channels": false,
|
|
19
19
|
"memory": true
|
|
20
20
|
},
|
|
21
|
+
"runtimeRequirements": {
|
|
22
|
+
"requiresCredentials": true,
|
|
23
|
+
"requiresNetwork": true,
|
|
24
|
+
"credentialSources": {
|
|
25
|
+
"env": [
|
|
26
|
+
"EMBEDDING_API_KEY",
|
|
27
|
+
"LLM_API_KEY",
|
|
28
|
+
"RERANKER_API_KEY"
|
|
29
|
+
],
|
|
30
|
+
"pluginConfig": [
|
|
31
|
+
"embedding.apiKey",
|
|
32
|
+
"llm.apiKey",
|
|
33
|
+
"reranker.apiKey"
|
|
34
|
+
]
|
|
35
|
+
},
|
|
36
|
+
"externalEndpoints": {
|
|
37
|
+
"embedding": "OpenAI-compatible /embeddings endpoint",
|
|
38
|
+
"llm": "OpenAI-compatible /chat/completions endpoint",
|
|
39
|
+
"reranker": "Reranker /rerank endpoint"
|
|
40
|
+
}
|
|
41
|
+
},
|
|
21
42
|
"hooks": [
|
|
22
43
|
"message_received",
|
|
23
44
|
"session_end"
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "openclaw-cortex-memory",
|
|
3
|
-
"version": "0.1.0-Alpha.
|
|
3
|
+
"version": "0.1.0-Alpha.25",
|
|
4
4
|
"description": "Long-term memory system for OpenClaw AI Agent",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"types": "dist/index.d.ts",
|
|
@@ -63,6 +63,28 @@
|
|
|
63
63
|
"message_received",
|
|
64
64
|
"session_end"
|
|
65
65
|
],
|
|
66
|
+
"requires": {
|
|
67
|
+
"credentials": true,
|
|
68
|
+
"network": true,
|
|
69
|
+
"env": [
|
|
70
|
+
"EMBEDDING_API_KEY",
|
|
71
|
+
"LLM_API_KEY",
|
|
72
|
+
"RERANKER_API_KEY"
|
|
73
|
+
],
|
|
74
|
+
"config": [
|
|
75
|
+
"embedding.apiKey",
|
|
76
|
+
"llm.apiKey",
|
|
77
|
+
"reranker.apiKey",
|
|
78
|
+
"embedding.baseURL",
|
|
79
|
+
"llm.baseURL",
|
|
80
|
+
"reranker.baseURL"
|
|
81
|
+
],
|
|
82
|
+
"externalEndpoints": [
|
|
83
|
+
"embedding API endpoint (OpenAI-compatible /embeddings)",
|
|
84
|
+
"LLM API endpoint (OpenAI-compatible /chat/completions)",
|
|
85
|
+
"reranker API endpoint (/rerank)"
|
|
86
|
+
]
|
|
87
|
+
},
|
|
66
88
|
"build": {
|
|
67
89
|
"openclawVersion": "2026.4.5",
|
|
68
90
|
"pluginSdkVersion": "2026.4.5"
|