@agenticmail/openclaw 0.5.40 → 0.5.42

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 CHANGED
@@ -364,6 +364,38 @@ The plugin registers three OpenClaw lifecycle hooks:
364
364
 
365
365
  ---
366
366
 
367
+ ## Troubleshooting
368
+
369
+ ### Plugin ID mismatch warning
370
+
371
+ ```
372
+ plugins.entries.agenticmail: plugin agenticmail: plugin id mismatch
373
+ (manifest uses "agenticmail", entry hints "openclaw")
374
+ ```
375
+
376
+ This is a harmless warning. OpenClaw infers the expected plugin ID from the npm package name (`@agenticmail/openclaw`) and sees "openclaw", but the plugin manifest declares its ID as `"agenticmail"`. The plugin loads and works correctly — you can safely ignore this warning.
377
+
378
+ ### Plugin path not found
379
+
380
+ ```
381
+ plugins.load.paths: plugin: plugin path not found: /Users/you/node_modules/@agenticmail/openclaw
382
+ ```
383
+
384
+ This means the `plugins.load.paths` entry in your `~/.openclaw/openclaw.json` points to a location where the plugin isn't installed. Find the actual path:
385
+
386
+ ```bash
387
+ # If installed globally
388
+ npm prefix -g
389
+ # Plugin will be at: <prefix>/lib/node_modules/@agenticmail/openclaw
390
+
391
+ # Or search for it
392
+ find / -name "openclaw.plugin.json" -path "*@agenticmail*" 2>/dev/null
393
+ ```
394
+
395
+ Then update the path in `~/.openclaw/openclaw.json` under `plugins.load.paths`.
396
+
397
+ ---
398
+
367
399
  ## License
368
400
 
369
401
  [MIT](./LICENSE) - Ope Olatunji ([@ope-olatunji](https://github.com/ope-olatunji))