@remnic/plugin-openclaw 1.0.49 → 1.0.50

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.
Files changed (3) hide show
  1. package/README.md +49 -32
  2. package/openclaw.plugin.json +16 -25
  3. package/package.json +7 -7
package/README.md CHANGED
@@ -41,6 +41,20 @@ Then restart the gateway:
41
41
  launchctl kickstart -k gui/501/ai.openclaw.gateway
42
42
  ```
43
43
 
44
+ ## Compatibility Policy
45
+
46
+ Remnic supports OpenClaw releases from at least the previous 60 days. For the
47
+ May 31, 2026 compatibility sweep, that means OpenClaw `2026.4.1` and newer.
48
+ The package metadata therefore keeps the installer compatibility floor at the
49
+ single `>=2026.4.1` shape OpenClaw setup expects, while the peer and plugin-API
50
+ compatibility ranges explicitly include reviewed prerelease hosts in that
51
+ window. The adapter separately records `2026.5.31-alpha.1` as the latest
52
+ reviewed OpenClaw build target.
53
+
54
+ When adding newer OpenClaw manifest surfaces, keep older-compatible metadata in
55
+ place for hosts inside that 60-day window unless an upstream breaking change is
56
+ documented and unavoidable.
57
+
44
58
  ## Benchmarking The OpenClaw Chain
45
59
 
46
60
  The benchmark CLI can now exercise the real OpenClaw-backed answer path instead
@@ -164,7 +178,7 @@ CI jobs that provision OpenClaw should use
164
178
  `npm run check:openclaw-sdk-surface:required` or pass
165
179
  `-- --require --package-root <path>` so a missing SDK fails instead of skipping.
166
180
 
167
- Last compatibility sweep: May 19, 2026. The SDK surface check passed against
181
+ Last compatibility sweep: May 31, 2026. The SDK surface check passed against
168
182
  `openclaw@2026.5.3`, `openclaw@2026.5.3-1`, `openclaw@2026.5.4-beta.1`,
169
183
  `openclaw@2026.5.4-beta.2`, `openclaw@2026.5.4-beta.3`,
170
184
  `openclaw@2026.5.4`, `openclaw@2026.5.5`, `openclaw@2026.5.6`,
@@ -172,9 +186,10 @@ Last compatibility sweep: May 19, 2026. The SDK surface check passed against
172
186
  `openclaw@2026.5.16-beta.4`. The May 19 sweep also checked the source SDK
173
187
  surface for `openclaw@2026.5.19-beta.1`, which covers the intervening
174
188
  `2026.5.16-beta.6`, `2026.5.16-beta.7`, and `2026.5.18-beta.1` release line
175
- for the Remnic adapter surfaces.
176
- Keep the peer range broad unless an upstream release removes a runtime surface
177
- Remnic actively uses.
189
+ for the Remnic adapter surfaces. The May 31 sweep checked source tag
190
+ `v2026.5.31-alpha.1` and the issue window from #1203 through #1237; the
191
+ existing SDK snapshot still matched (`14 registrars, 22 hooks, 2 manifest
192
+ contracts`).
178
193
 
179
194
  OpenClaw 2026.5.16 package-entry discovery prefers explicit built runtime
180
195
  entries for installed packages. The published Remnic adapter declares
@@ -183,25 +198,30 @@ extension entry, and its package install metadata advertises
183
198
  `openclaw.install.clawhubSpec: "clawhub:@remnic/plugin-openclaw"`,
184
199
  `openclaw.install.npmSpec: "@remnic/plugin-openclaw"`, and
185
200
  `openclaw.install.defaultChoice: "clawhub"`. That keeps OpenClaw setup,
186
- repair, and update flows ClawHub-first while preserving npm as the fallback
187
- install surface and `>=2026.5.16-beta.1` as the minimum supported host range.
188
- The manifest also declares `activation.onStartup: false`, leaves provider
189
- ownership to the host, exposes the optional plugin-mode OpenAI key through
190
- `providerAuthChoices`, and keeps `providerAuthEnvVars.openai` as compatibility
191
- metadata for OpenClaw's pre-runtime env-var auth probes.
192
-
193
- OpenClaw 2026.5.16-beta.3 keeps those install and auth ownership contracts
194
- intact. The sweep confirmed that Remnic still relies on host-owned gateway
195
- restart/reload behavior after plugin install changes, uses `gateway_stop`
196
- instead of the deprecated `deactivate` cleanup alias, and should not claim
197
- OpenAI `setup.providers` ownership because gateway/provider configuration
198
- remains host-owned.
199
-
200
- OpenClaw 2026.5.16-beta.4 treats `setup.providers[].id` as provider ownership
201
- metadata with globally unique ids. Remnic does not own the `openai` provider,
202
- so the canonical manifest keeps OpenAI API-key metadata on `providerAuthChoices`
203
- and the compatibility `providerAuthEnvVars.openai` surface instead of declaring
204
- `setup.providers`.
201
+ repair, and update flows ClawHub-first while preserving npm as the fallback.
202
+ OpenClaw 2026.5.30-beta.1 may resolve bare package names npm-first during the
203
+ launch cutover, so operator docs should keep the explicit `clawhub:` prefix for
204
+ deterministic installs.
205
+
206
+ The manifest declares `activation.onStartup: false`, exposes the optional
207
+ plugin-mode OpenAI key through `providerAuthChoices`, and mirrors the
208
+ `OPENAI_API_KEY` env signal through `setup.providers[].envVars` for current
209
+ OpenClaw auth/status discovery. It keeps `providerAuthEnvVars.openai` mirrored
210
+ for older OpenClaw pre-runtime auth probes; current OpenClaw does not warn
211
+ because the env var is also present on `setup.providers[].envVars`.
212
+ Memory-slot selection is carried by `kind: "memory"` plus the normal
213
+ `plugins.slots.memory` config, and the legacy `supports` block remains for
214
+ OpenClaw 2026.4 / early 2026.5 slot and lifecycle routing. Privacy and
215
+ provider-data disclosures live in docs and package metadata instead of the
216
+ unsupported top-level `securityDisclosure` manifest field.
217
+
218
+ Earlier 2026.5.16 sweeps confirmed that Remnic still relies on host-owned
219
+ gateway restart/reload behavior after plugin install changes, uses
220
+ `gateway_stop` instead of the deprecated `deactivate` cleanup alias, and stays
221
+ on host-owned gateway/provider routing by default. Current OpenClaw setup/auth
222
+ surfaces read env-var status from `setup.providers[].envVars`, so Remnic mirrors
223
+ the optional plugin-mode OpenAI key there without adding top-level provider
224
+ ownership metadata.
205
225
 
206
226
  OpenClaw 2026.5.16-beta.6 added `defineToolPlugin` and the authoring CLI for
207
227
  simple typed tool-only plugins. Remnic intentionally stays on `definePluginEntry`
@@ -209,16 +229,13 @@ because the adapter owns mixed memory-slot hooks, lifecycle handlers, slash
209
229
  command metadata, public artifacts, and runtime tools rather than only static
210
230
  tools.
211
231
 
212
- OpenClaw 2026.5.16-beta.7 through 2026.5.19-beta.1 keep the Remnic-required
232
+ OpenClaw 2026.5.20-beta.2 through 2026.5.31-alpha.1 keep the Remnic-required
213
233
  plugin install, ClawHub fallback, manifest contract, hook, memory-slot, gateway
214
- LLM, and plugin security-scan surfaces compatible. Those newer OpenClaw hosts
215
- raise their runtime floor to Node.js `>=22.19.0`, but the Remnic adapter package
216
- keeps its broad host peer range so older advertised 2026.5.16 hosts do not
217
- select a package with an incompatible package-level engine gate. The manifest
218
- continues to avoid `setup.providers.openai`; OpenClaw still treats provider ids
219
- there as ownership metadata, while Remnic only advertises an optional
220
- plugin-mode OpenAI key through `providerAuthChoices` and the deprecated
221
- `providerAuthEnvVars.openai` compatibility probe.
234
+ LLM, and plugin security-scan surfaces compatible. The package metadata now
235
+ records `2026.5.31-alpha.1` as the reviewed OpenClaw build target and keeps
236
+ the stable `>=2026.4.1` installer floor plus reviewed prerelease peer/plugin-API
237
+ hosts eligible, covering the previous 60 days of compatible OpenClaw hosts
238
+ while still taking advantage of the newer setup descriptor metadata.
222
239
 
223
240
  Native memory registrars are tracked separately in
224
241
  [`docs/plugins/openclaw-native-memory-registrars.md`](../../docs/plugins/openclaw-native-memory-registrars.md).
package/openclaw.plugin.json CHANGED
@@ -1,15 +1,21 @@
1
1
  {
2
2
  "id": "openclaw-remnic",
3
3
  "name": "Remnic OpenClaw Plugin",
4
- "version": "1.0.49",
4
+ "version": "1.0.50",
5
5
  "kind": "memory",
6
6
  "description": "Local semantic memory for OpenClaw with bundled Remnic core runtime. Requires plugins.slots.memory set to this plugin id for hooks to fire.",
7
7
  "setup": {
8
- "requiresRuntime": false
9
- },
10
- "providerAuthEnvVars": {
11
- "openai": [
12
- "OPENAI_API_KEY"
8
+ "requiresRuntime": false,
9
+ "providers": [
10
+ {
11
+ "id": "openai",
12
+ "authMethods": [
13
+ "api-key"
14
+ ],
15
+ "envVars": [
16
+ "OPENAI_API_KEY"
17
+ ]
18
+ }
13
19
  ]
14
20
  },
15
21
  "providerAuthChoices": [
@@ -30,25 +36,10 @@
30
36
  ]
31
37
  }
32
38
  ],
33
- "securityDisclosure": {
34
- "conversationAccess": "As a memory-slot plugin, Remnic hooks can observe conversation turns, tool-use metadata, LLM output metadata, and local memory files so they can be indexed, summarized, recalled, and exposed through memory tools.",
35
- "modelProviderCredentials": {
36
- "recommendedMode": "Use modelSource=gateway to route LLM-backed memory work through OpenClaw gateway agents instead of a Remnic-owned API key.",
37
- "dynamicCredentialSources": [
38
- "OpenClaw runtime auth resolver for configured model providers",
39
- "~/.openclaw/agents/main/agent/models.json provider entries",
40
- "provider-specific environment variables such as <PROVIDER>_API_KEY and <PROVIDER>_TOKEN"
41
- ],
42
- "providerModeData": [
43
- "conversation excerpts",
44
- "memory excerpts",
45
- "summaries",
46
- "embedding inputs",
47
- "active-recall query inputs",
48
- "benchmark and evaluation inputs"
49
- ],
50
- "externalProviderGuidance": "Do not set openaiApiKey or provider environment variables for Remnic if all LLM-backed memory operations should stay on the OpenClaw gateway path. When plugin/provider mode is configured, selected conversation and memory excerpts may be sent to the configured provider for extraction, consolidation, summarization, embeddings, active recall, or benchmark judging."
51
- }
39
+ "providerAuthEnvVars": {
40
+ "openai": [
41
+ "OPENAI_API_KEY"
42
+ ]
52
43
  },
53
44
  "supports": {
54
45
  "memorySlot": true,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@remnic/plugin-openclaw",
3
- "version": "1.0.49",
3
+ "version": "1.0.50",
4
4
  "description": "OpenClaw adapter for Remnic memory with bundled @remnic/core runtime",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -28,17 +28,17 @@
28
28
  "./dist/index.js"
29
29
  ],
30
30
  "compat": {
31
- "pluginApi": ">=2026.5.16-beta.1"
31
+ "pluginApi": ">=2026.4.1 || 2026.4.7-1 || 2026.4.9-beta.1 || 2026.4.11-beta.1 || 2026.4.12-beta.1 || 2026.4.14-beta.1 || 2026.4.15-beta.1 || 2026.4.15-beta.2 || 2026.4.19-beta.1 || 2026.4.19-beta.2 || 2026.4.20-beta.1 || 2026.4.20-beta.2 || 2026.4.22-beta.1 || 2026.4.23-beta.1 || 2026.4.23-beta.2 || 2026.4.23-beta.3 || 2026.4.23-beta.4 || 2026.4.23-beta.5 || 2026.4.23-beta.6 || 2026.4.24-beta.1 || 2026.4.24-beta.2 || 2026.4.24-beta.3 || 2026.4.24-beta.4 || 2026.4.24-beta.5 || 2026.4.24-beta.6 || 2026.4.25-beta.1 || 2026.4.25-beta.2 || 2026.4.25-beta.3 || 2026.4.25-beta.4 || 2026.4.25-beta.5 || 2026.4.25-beta.6 || 2026.4.25-beta.7 || 2026.4.25-beta.8 || 2026.4.25-beta.9 || 2026.4.25-beta.10 || 2026.4.25-beta.11 || 2026.4.26-beta.1 || 2026.4.27-beta.1 || 2026.4.29-beta.1 || 2026.4.29-beta.2 || 2026.4.29-beta.3 || 2026.4.29-beta.4 || 2026.4.30-beta.1 || 2026.5.2-beta.1 || 2026.5.2-beta.2 || 2026.5.2-beta.3 || 2026.5.3-1 || 2026.5.3-beta.1 || 2026.5.3-beta.2 || 2026.5.3-beta.3 || 2026.5.3-beta.4 || 2026.5.4-beta.1 || 2026.5.4-beta.2 || 2026.5.4-beta.3 || 2026.5.5-beta.1 || 2026.5.5-beta.2 || 2026.5.6-beta.1 || 2026.5.7-beta.1 || 2026.5.9-beta.1 || 2026.5.10-beta.1 || 2026.5.10-beta.2 || 2026.5.10-beta.3 || 2026.5.10-beta.4 || 2026.5.10-beta.5 || 2026.5.10-beta.6 || 2026.5.12-beta.1 || 2026.5.12-beta.2 || 2026.5.12-beta.3 || 2026.5.12-beta.4 || 2026.5.12-beta.5 || 2026.5.12-beta.6 || 2026.5.12-beta.7 || 2026.5.12-beta.8 || 2026.5.14-beta.1 || 2026.5.14-beta.2 || 2026.5.16-beta.1 || 2026.5.16-beta.2 || 2026.5.16-beta.3 || 2026.5.16-beta.4 || 2026.5.16-beta.5 || 2026.5.16-beta.6 || 2026.5.16-beta.7 || 2026.5.18-beta.1 || 2026.5.19-alpha.1 || 2026.5.19-beta.1 || 2026.5.19-beta.2 || 2026.5.20-beta.1 || 2026.5.20-beta.2 || 2026.5.21-alpha.1 || 2026.5.21-beta.1 || 2026.5.22-beta.1 || 2026.5.23-alpha.1 || 2026.5.24-alpha.1 || 2026.5.24-beta.1 || 2026.5.24-beta.2 || 2026.5.25-alpha.1 || 2026.5.25-alpha.2 || 2026.5.25-beta.1 || 2026.5.26-beta.1 || 2026.5.26-beta.2 || 2026.5.27-alpha.1 || 2026.5.27-beta.1 || 2026.5.28-alpha.1 || 2026.5.28-beta.1 || 2026.5.28-beta.2 || 2026.5.28-beta.3 || 2026.5.28-beta.4 || 2026.5.29-alpha.1 || 2026.5.30-beta.1 || 2026.5.30-beta.2 || 2026.5.31-alpha.1"
32
32
  },
33
33
  "build": {
34
- "openclawVersion": "2026.5.19-beta.1",
35
- "pluginSdkVersion": "2026.5.19-beta.1"
34
+ "openclawVersion": "2026.5.31-alpha.1",
35
+ "pluginSdkVersion": "2026.5.31-alpha.1"
36
36
  },
37
37
  "install": {
38
38
  "clawhubSpec": "clawhub:@remnic/plugin-openclaw",
39
39
  "npmSpec": "@remnic/plugin-openclaw",
40
40
  "defaultChoice": "clawhub",
41
- "minHostVersion": ">=2026.5.16-beta.1"
41
+ "minHostVersion": ">=2026.4.1"
42
42
  },
43
43
  "environment": {
44
44
  "externalServices": [
@@ -71,10 +71,10 @@
71
71
  },
72
72
  "dependencies": {
73
73
  "openai": "^6.0.0",
74
- "@remnic/core": "^1.1.25"
74
+ "@remnic/core": "^1.1.26"
75
75
  },
76
76
  "peerDependencies": {
77
- "openclaw": ">=2026.5.16-beta.1"
77
+ "openclaw": ">=2026.4.1 || 2026.4.7-1 || 2026.4.9-beta.1 || 2026.4.11-beta.1 || 2026.4.12-beta.1 || 2026.4.14-beta.1 || 2026.4.15-beta.1 || 2026.4.15-beta.2 || 2026.4.19-beta.1 || 2026.4.19-beta.2 || 2026.4.20-beta.1 || 2026.4.20-beta.2 || 2026.4.22-beta.1 || 2026.4.23-beta.1 || 2026.4.23-beta.2 || 2026.4.23-beta.3 || 2026.4.23-beta.4 || 2026.4.23-beta.5 || 2026.4.23-beta.6 || 2026.4.24-beta.1 || 2026.4.24-beta.2 || 2026.4.24-beta.3 || 2026.4.24-beta.4 || 2026.4.24-beta.5 || 2026.4.24-beta.6 || 2026.4.25-beta.1 || 2026.4.25-beta.2 || 2026.4.25-beta.3 || 2026.4.25-beta.4 || 2026.4.25-beta.5 || 2026.4.25-beta.6 || 2026.4.25-beta.7 || 2026.4.25-beta.8 || 2026.4.25-beta.9 || 2026.4.25-beta.10 || 2026.4.25-beta.11 || 2026.4.26-beta.1 || 2026.4.27-beta.1 || 2026.4.29-beta.1 || 2026.4.29-beta.2 || 2026.4.29-beta.3 || 2026.4.29-beta.4 || 2026.4.30-beta.1 || 2026.5.2-beta.1 || 2026.5.2-beta.2 || 2026.5.2-beta.3 || 2026.5.3-1 || 2026.5.3-beta.1 || 2026.5.3-beta.2 || 2026.5.3-beta.3 || 2026.5.3-beta.4 || 2026.5.4-beta.1 || 2026.5.4-beta.2 || 2026.5.4-beta.3 || 2026.5.5-beta.1 || 2026.5.5-beta.2 || 2026.5.6-beta.1 || 2026.5.7-beta.1 || 2026.5.9-beta.1 || 2026.5.10-beta.1 || 2026.5.10-beta.2 || 2026.5.10-beta.3 || 2026.5.10-beta.4 || 2026.5.10-beta.5 || 2026.5.10-beta.6 || 2026.5.12-beta.1 || 2026.5.12-beta.2 || 2026.5.12-beta.3 || 2026.5.12-beta.4 || 2026.5.12-beta.5 || 2026.5.12-beta.6 || 2026.5.12-beta.7 || 2026.5.12-beta.8 || 2026.5.14-beta.1 || 2026.5.14-beta.2 || 2026.5.16-beta.1 || 2026.5.16-beta.2 || 2026.5.16-beta.3 || 2026.5.16-beta.4 || 2026.5.16-beta.5 || 2026.5.16-beta.6 || 2026.5.16-beta.7 || 2026.5.18-beta.1 || 2026.5.19-alpha.1 || 2026.5.19-beta.1 || 2026.5.19-beta.2 || 2026.5.20-beta.1 || 2026.5.20-beta.2 || 2026.5.21-alpha.1 || 2026.5.21-beta.1 || 2026.5.22-beta.1 || 2026.5.23-alpha.1 || 2026.5.24-alpha.1 || 2026.5.24-beta.1 || 2026.5.24-beta.2 || 2026.5.25-alpha.1 || 2026.5.25-alpha.2 || 2026.5.25-beta.1 || 2026.5.26-beta.1 || 2026.5.26-beta.2 || 2026.5.27-alpha.1 || 2026.5.27-beta.1 || 2026.5.28-alpha.1 || 2026.5.28-beta.1 || 2026.5.28-beta.2 || 2026.5.28-beta.3 || 2026.5.28-beta.4 || 2026.5.29-alpha.1 || 2026.5.30-beta.1 || 2026.5.30-beta.2 || 2026.5.31-alpha.1"
78
78
  },
79
79
  "devDependencies": {
80
80
  "@openclaw/plugin-inspector": "0.3.10",