diff --git a/AGENTS.md b/AGENTS.md
index 1937eb9..d3fdea5 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -8,5 +8,9 @@
   opt-in and secrets.
 - Prefer seam labels over product categories: `dynamic-tool`, `llm-observer`,
   `gateway-service`, `provider-capability`, and similar.
+- Treat `openclaw` package dependencies as host-linked inputs owned by the
+  inspector/workspace plan, not as upstream plugin install findings.
+- When plugin-inspector behavior or package versions change, update both the
+  source ref and generated report/test expectations. After npm publish, update
+  the package pin and run both source-mode and package-mode smoke checks.
 - When adding a fixture, explain the unique seam it covers in `why`.
-
diff --git a/scripts/plugin-inspector-source.mjs b/scripts/plugin-inspector-source.mjs
index 9c425c1..a6bb574 100644
--- a/scripts/plugin-inspector-source.mjs
+++ b/scripts/plugin-inspector-source.mjs
@@ -5,7 +5,7 @@ import { pathToFileURL } from "node:url";
 import { repoRoot } from "./manifest-lib.mjs";
 
 export const pluginInspectorRef = "e04c3fc1214f38277be1eab7c833ca1b02b17bad";
-export const pluginInspectorPackage = "@openclaw/plugin-inspector@0.3.3";
+export const pluginInspectorPackage = "@openclaw/plugin-inspector@0.3.4";
 
 export async function loadPluginInspector() {
   const publicApi = await import(pathToFileURL(resolvePluginInspectorSourcePath()).href);