@engramx/openclaw 0.16.0-rc.23 → 0.16.0-rc.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.
Files changed (2) hide show
  1. package/README.md +29 -8
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -104,17 +104,21 @@ the data, in whichever direction you ask for.
104
104
 
105
105
  ```bash
106
106
  # 1. Pair this machine's agent — generate the key for this engram, pair it, install and configure the plugin
107
- npx @engramx/client@0.16.0-rc.23 pair <INVITE_CODE> --engram <CANISTER_ID> --target openclaw
107
+ # ⟨CORRECTED 2026-11-08⟩ It configures the plugin and no longer installs it: it prints the command 1b runs
108
+ npx @engramx/client@0.16.0-rc.25 pair <INVITE_CODE> --engram <CANISTER_ID> --target openclaw
109
+
110
+ # 1b. ⟨2026-11-08⟩ Install the plugin — the line pair prints, at the version of the pair you ran
111
+ openclaw plugins install @engramx/openclaw@<version>
108
112
 
109
113
  # 2a. First machine — push existing local memory files up to the engram
110
- npx @engramx/client@0.16.0-rc.23 migrate --engram <CANISTER_ID>
114
+ npx @engramx/client@0.16.0-rc.25 migrate --engram <CANISTER_ID>
111
115
 
112
116
  # 2b. Replacement machine — restore database backups down from the engram instead
113
- npx @engramx/client@0.16.0-rc.23 migrate --engram <CANISTER_ID> --recover
117
+ npx @engramx/client@0.16.0-rc.25 migrate --engram <CANISTER_ID> --recover
114
118
  ```
115
119
 
116
120
  `--recover` belongs to `migrate`; passing it to `pair` is refused with a message saying so. A local
117
- checkpoint is saved before `migrate` changes anything — run `npx @engramx/client@0.16.0-rc.23 rollback` to undo.
121
+ checkpoint is saved before `migrate` changes anything — run `npx @engramx/client@0.16.0-rc.25 rollback` to undo.
118
122
  After `--recover`, memory files sync automatically on next OpenClaw startup.
119
123
 
120
124
  ⟨2026-10-13⟩ The two commands above are now what `pair` does: it moves no memory unless you add
@@ -130,6 +134,17 @@ plugin, said "Installed EngramX plugin for OpenClaw", and the older plugin's syn
130
134
  memory files `pair` had left in place. When `pair` installs nothing (OpenClaw's gateway is not
131
135
  running, or both installers fail) it now says so, why, and the command that installs the plugin.
132
136
 
137
+ ⟨2026-11-08⟩ `pair` no longer installs the plugin. It writes `openclaw.json` and prints one command,
138
+ `openclaw plugins install @engramx/openclaw@<version>` at the version of the `pair` you ran (step 1b
139
+ above), for you to run at a terminal: OpenClaw asks you to confirm a plugin from npm before it installs
140
+ it. When OpenClaw already holds this plugin at that version, `pair` says so and prints no command. The
141
+ refusal of a different version, above, is unchanged; the sentence before this note no longer applies,
142
+ since `pair` installs nothing. Through 0.16.0-rc.23 `pair` ran the install itself, without a terminal:
143
+ OpenClaw's installer refuses a package from npm that way unless told to trust it, and `pair`'s
144
+ fallback, an `npm install` into `extensions/memory-engramx`, put the plugin in a folder OpenClaw does
145
+ not load plugins from, yet `pair` printed "Installed". A copy in that folder is no longer reported as
146
+ installed.
147
+
133
148
  ### 4. Verify
134
149
 
135
150
  ```bash
@@ -234,10 +249,12 @@ icp canister call <ENGRAM_ID> createAgentInvite \
234
249
  -e local
235
250
 
236
251
  # Pair and configure OpenClaw in one step
237
- npx @engramx/client@0.16.0-rc.23 pair <INVITE_CODE> --engram <ENGRAM_ID> --target openclaw --host http://localhost:4943
252
+ npx @engramx/client@0.16.0-rc.25 pair <INVITE_CODE> --engram <ENGRAM_ID> --target openclaw --host http://localhost:4943
238
253
  ```
239
254
 
240
255
  `--target openclaw` installs the plugin config in `~/.openclaw/openclaw.json` automatically.
256
+ ⟨2026-11-08⟩ It also prints the command that installs the published plugin from npm. Skip it here:
257
+ step 4 set up your own copy of the plugin in OpenClaw.
241
258
 
242
259
  `canReadBackup = opt true` is deliberate here and differs from the default connect-an-agent grant,
243
260
  which leaves it unset. This plugin's 6-hourly backup runs a `listBackups` dedup probe; without the
@@ -306,15 +323,19 @@ If you lose your machine:
306
323
 
307
324
  ```bash
308
325
  # On a clean machine — create a new agent invite from the dashboard, then:
309
- npx @engramx/client@0.16.0-rc.23 pair <INVITE_CODE> --engram <CANISTER_ID> --target openclaw
310
- npx @engramx/client@0.16.0-rc.23 migrate --engram <CANISTER_ID> --recover
326
+ npx @engramx/client@0.16.0-rc.25 pair <INVITE_CODE> --engram <CANISTER_ID> --target openclaw
327
+ openclaw plugins install @engramx/openclaw@<version> # ⟨2026-11-08⟩ the line pair prints
328
+ npx @engramx/client@0.16.0-rc.25 migrate --engram <CANISTER_ID> --recover
311
329
  ```
312
330
 
313
331
  `pair` pairs the agent again with a new key and installs the plugin; `migrate --recover` restores the latest
314
332
  database backups (SQLite, QMD, LanceDB — whichever were detected) and saves a checkpoint. Memory
315
333
  files sync automatically on next OpenClaw startup.
334
+ ⟨CORRECTED 2026-11-08⟩ `pair` configures the plugin and prints the command that installs it (the
335
+ second line above); it no longer installs it. The sync at OpenClaw's next start needs the plugin
336
+ installed.
316
337
 
317
- A local checkpoint is saved before any changes. Run `npx @engramx/client@0.16.0-rc.23 rollback` to undo.
338
+ A local checkpoint is saved before any changes. Run `npx @engramx/client@0.16.0-rc.25 rollback` to undo.
318
339
 
319
340
  Restoring reads backups, so the new agent grant needs `canReadBackup` — see the invite note under
320
341
  Local Development. Without it the restore is refused with a message naming the permission.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@engramx/openclaw",
3
- "version": "0.16.0-rc.23",
3
+ "version": "0.16.0-rc.25",
4
4
  "description": "EngramX memory plugin for OpenClaw — persistent, decentralized agent memory",
5
5
  "license": "Apache-2.0",
6
6
  "author": "EngramX <developer@engramx.ai>",
@@ -27,7 +27,7 @@
27
27
  },
28
28
  "//openclaw": "openclaw (>=2026.1.26) is the HOST platform that loads this plugin at runtime — it is intentionally NOT declared as a dependency or peer. Declaring it (even as an optional peer) makes pnpm auto-install the entire OpenClaw AI-platform tree (Pi Agent, AWS Bedrock SDK, etc. — dozens of advisories + a postinstall script) into the dev install, which EngramX never ships. When developing this plugin against the host, install openclaw yourself.",
29
29
  "dependencies": {
30
- "@engramx/client": "^0.16.0-rc.23",
30
+ "@engramx/client": "^0.16.0-rc.25",
31
31
  "@icp-sdk/core": "^6.1.1",
32
32
  "@sinclair/typebox": "^0.34.52"
33
33
  },