diff --git a/examples/openclaw-plugin/INSTALL-AGENT.md b/examples/openclaw-plugin/INSTALL-AGENT.md
index 39831c932..66207b61b 100644
--- a/examples/openclaw-plugin/INSTALL-AGENT.md
+++ b/examples/openclaw-plugin/INSTALL-AGENT.md
@@ -175,6 +175,16 @@ OpenViking service log, default local path:
 cat ~/.openviking/data/log/openviking.log
 ```
 
+### Pipeline Health Check (Optional)
+
+If the checks above all pass and you want to further verify the full Gateway → OpenViking pipeline, run the health check script:
+
+```bash
+python examples/openclaw-plugin/health_check_tools/ov-healthcheck.py
+```
+
+This injects a real conversation through Gateway and verifies from the OpenViking side that the session was captured, committed, archived, and had memories extracted. See [health_check_tools/HEALTHCHECK.md](./health_check_tools/HEALTHCHECK.md) for full details.
+
 ### Start commands
 
 Local mode:
diff --git a/examples/openclaw-plugin/INSTALL-ZH.md b/examples/openclaw-plugin/INSTALL-ZH.md
index 7a3282560..4ca32b88e 100644
--- a/examples/openclaw-plugin/INSTALL-ZH.md
+++ b/examples/openclaw-plugin/INSTALL-ZH.md
@@ -179,6 +179,16 @@ cat ~/.openviking/data/log/openviking.log
 ov-install --current-version
 ```
 
+### 链路检查（可选）
+
+如果上述验证都正常，还想进一步确认从 Gateway 到 OpenViking 的完整链路是否通畅，可以使用插件自带的健康检查脚本：
+
+```bash
+python examples/openclaw-plugin/health_check_tools/ov-healthcheck.py
+```
+
+该脚本会进行一次真实的对话注入，然后从 OpenViking 侧验证会话是否被正确捕获、提交、归档并提取出记忆。详细说明见 [health_check_tools/HEALTHCHECK-ZH.md](./health_check_tools/HEALTHCHECK-ZH.md)。
+
 ## 卸载
 
 只卸载 OpenClaw 插件、保留 OpenViking 运行时：
diff --git a/examples/openclaw-plugin/INSTALL.md b/examples/openclaw-plugin/INSTALL.md
index 9f87d8228..785fb761b 100644
--- a/examples/openclaw-plugin/INSTALL.md
+++ b/examples/openclaw-plugin/INSTALL.md
@@ -186,6 +186,16 @@ Check installed versions:
 ov-install --current-version
 ```
 
+### Pipeline Health Check (Optional)
+
+If the steps above all look good and you want to further verify the full Gateway → OpenViking pipeline, run the plugin's health check script:
+
+```bash
+python examples/openclaw-plugin/health_check_tools/ov-healthcheck.py
+```
+
+This script injects a real conversation through Gateway and then verifies from the OpenViking side that the session was captured, committed, archived, and had memories extracted. See [health_check_tools/HEALTHCHECK.md](./health_check_tools/HEALTHCHECK.md) for full details.
+
 ## Uninstall
 
 To remove only the OpenClaw plugin and keep the OpenViking runtime: