diff --git a/docs/integrations/openclaw.md b/docs/integrations/openclaw.md
index a25482c..bb154ec 100644
--- a/docs/integrations/openclaw.md
+++ b/docs/integrations/openclaw.md
@@ -60,14 +60,20 @@ Capture the printed plaintext token — it is shown exactly once.
 
 ### 3. Configure
 
-Edit `~/.openclaw/openclaw.json`:
+Edit `~/.openclaw/openclaw.json` — register the plugin in both `plugins.allow` and `plugins.entries` (the modern OpenClaw schema; older revisions of this doc only listed `plugins.olp`, which is not picked up):
 
 ```json
 {
   "plugins": {
-    "olp": {
-      "proxyUrl": "http://127.0.0.1:4567",
-      "apiKey": "olp_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
+    "allow": ["...", "olp"],
+    "entries": {
+      "olp": {
+        "enabled": true,
+        "config": {
+          "proxyUrl": "http://127.0.0.1:4567",
+          "apiKey": "olp_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
+        }
+      }
     }
   }
 }
@@ -87,6 +93,8 @@ The plugin is now active. Try `/olp help` in your bot's chat.
   plugin discovery at gateway start. `openclaw plugins reload` does not
   guarantee a fresh import of the plugin module.
 
+- **OpenClaw v2026.5+ requires `openclaw.extensions` in `package.json`.** OpenClaw versions ≥ 2026.5.22 enforce a stricter plugin-manifest validation at `openclaw plugins install` time. If `Option A` fails with `package.json missing openclaw.extensions` despite recent OLP releases, your local `olp-plugin/package.json` may predate the v0.5.x fix that adds `"extensions": ["./index.js"]` to the `openclaw` block. Pull latest OLP main (`git pull` in your OLP clone) and retry, or fall through to `Option B` symlink which works against any plugin shape. (Original drift event: 2026-05-27, see commit history of `olp-plugin/package.json`.)
+
 - **Owner key revocation kicks the plugin out immediately.** If you revoke
   the bot's owner key (`npx olp-keys revoke --id=<id>`), the next `/olp
   status` will return `401 unauthorized`. Mint a replacement key with a
diff --git a/olp-plugin/package.json b/olp-plugin/package.json
index 16b5975..eb066cb 100644
--- a/olp-plugin/package.json
+++ b/olp-plugin/package.json
@@ -10,6 +10,7 @@
   "openclaw": {
     "type": "plugin",
     "id": "olp",
-    "pluginManifest": "openclaw.plugin.json"
+    "pluginManifest": "openclaw.plugin.json",
+    "extensions": ["./index.js"]
   }
 }