diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json
index 4d817a530..7fe215802 100644
--- a/.openclaw-sync/source.json
+++ b/.openclaw-sync/source.json
@@ -1,5 +1,5 @@
 {
   "repository": "openclaw/openclaw",
-  "sha": "d1b2d81752b8b613620affd5dec42461e178792b",
-  "syncedAt": "2026-04-29T12:55:25.926Z"
+  "sha": "bbf985d50a6491bf02010c8ec30cd6b7dc4e2ed1",
+  "syncedAt": "2026-04-29T13:03:33.801Z"
 }
diff --git a/docs/.generated/plugin-sdk-api-baseline.sha256 b/docs/.generated/plugin-sdk-api-baseline.sha256
index 4ceea21f1..df7a39d31 100644
--- a/docs/.generated/plugin-sdk-api-baseline.sha256
+++ b/docs/.generated/plugin-sdk-api-baseline.sha256
@@ -1,2 +1,2 @@
-597577966dfee329740d7b0a331263afc26db518fe778f0fad95e2a01da88d83  plugin-sdk-api-baseline.json
-65fb1cad5e5ec1764e3ccfcfd3fbb2e5cfb938ad34b45e6416bba0c00a1d735a  plugin-sdk-api-baseline.jsonl
+d5b33ee6be988cd6a844a358aaa098e1f6401b151e5ee1e46dceeccddaeb7434  plugin-sdk-api-baseline.json
+dffa8b4afbb085faf42a857805c43708b748111e346552d7ea4654da3bafdee7  plugin-sdk-api-baseline.jsonl
diff --git a/docs/plugins/sdk-runtime.md b/docs/plugins/sdk-runtime.md
index fbf4c46f4..1742010ce 100644
--- a/docs/plugins/sdk-runtime.md
+++ b/docs/plugins/sdk-runtime.md
@@ -394,12 +394,28 @@ Provider and channel execution paths must use the active runtime config snapshot
 
   </Accordion>
   <Accordion title="api.runtime.state">
-    State directory resolution.
+    State directory resolution and SQLite-backed keyed storage.
 
     ```typescript
-    const stateDir = api.runtime.state.resolveStateDir();
+    const stateDir = api.runtime.state.resolveStateDir(process.env);
+    const store = api.runtime.state.openKeyedStore<MyRecord>({
+      namespace: "my-feature",
+      maxEntries: 200,
+      defaultTtlMs: 15 * 60_000,
+    });
+
+    await store.register("key-1", { value: "hello" });
+    const value = await store.lookup("key-1");
+    await store.consume("key-1");
+    await store.clear();
     ```
 
+    Keyed stores survive restarts and are isolated by the runtime-bound plugin id. Limits: `maxEntries` per namespace, 1,000 live rows per plugin, JSON values under 64KB, and optional TTL expiry.
+
+    <Warning>
+    Bundled plugins only in this release.
+    </Warning>
+
   </Accordion>
   <Accordion title="api.runtime.tools">
     Memory tool factories and CLI.