@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.
- package/README.md +29 -8
- 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
|
-
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
310
|
-
|
|
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.
|
|
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.
|
|
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.
|
|
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
|
},
|