diff --git a/docs/install/clawdock.md b/docs/install/clawdock.md
index 805549b25b8..66523deaab0 100644
--- a/docs/install/clawdock.md
+++ b/docs/install/clawdock.md
@@ -94,7 +94,7 @@ ClawDock works with the same Docker config split described in [Docker](/install/
 
 - `<project>/.env` for Docker-specific values like image name, ports, and the gateway token
 - `~/.openclaw/.env` for env-backed provider keys and bot tokens
-- `~/.openclaw/auth-profiles.json` for stored provider OAuth/API-key auth
+- `~/.openclaw/agents/<agentId>/agent/auth-profiles.json` for stored provider OAuth/API-key auth
 - `~/.openclaw/openclaw.json` for behavior config
 
 Use `clawdock-show-config` when you want to inspect the `.env` files and `openclaw.json` quickly. It redacts `.env` values in its printed output.
diff --git a/docs/install/docker.md b/docs/install/docker.md
index e8cbade0a55..f91de3d071f 100644
--- a/docs/install/docker.md
+++ b/docs/install/docker.md
@@ -179,7 +179,7 @@ survive container replacement.
 That mounted config directory is where OpenClaw keeps:
 
 - `openclaw.json` for behavior config
-- `auth-profiles.json` for stored provider OAuth/API-key auth
+- `agents/<agentId>/agent/auth-profiles.json` for stored provider OAuth/API-key auth
 - `.env` for env-backed runtime secrets such as `OPENCLAW_GATEWAY_TOKEN`
 
 For full persistence details on VM deployments, see
diff --git a/docs/install/gcp.md b/docs/install/gcp.md
index d5c513280b7..97335834125 100644
--- a/docs/install/gcp.md
+++ b/docs/install/gcp.md
@@ -25,8 +25,8 @@ Pricing varies by machine type and region; pick the smallest VM that fits your w
 - Persist `~/.openclaw` + `~/.openclaw/workspace` on the host (survives restarts/rebuilds)
 - Access the Control UI from your laptop via an SSH tunnel
 
-That mounted `~/.openclaw` state includes `openclaw.json`, `auth-profiles.json`,
-and `.env`.
+That mounted `~/.openclaw` state includes `openclaw.json`, per-agent
+`agents/<agentId>/agent/auth-profiles.json`, and `.env`.
 
 The Gateway can be accessed via:
 
@@ -233,7 +233,8 @@ For the generic Docker flow, see [Docker](/install/docker).
     **Do not commit this file.**
 
     This `.env` file is for container/runtime env such as `OPENCLAW_GATEWAY_TOKEN`.
-    Stored provider OAuth/API-key auth lives in the mounted `~/.openclaw/auth-profiles.json`.
+    Stored provider OAuth/API-key auth lives in the mounted
+    `~/.openclaw/agents/<agentId>/agent/auth-profiles.json`.
 
   </Step>
 
diff --git a/docs/install/hetzner.md b/docs/install/hetzner.md
index 75ff4f1ce85..d32e90e5476 100644
--- a/docs/install/hetzner.md
+++ b/docs/install/hetzner.md
@@ -33,8 +33,8 @@ See [Security](/gateway/security) and [VPS hosting](/vps).
 - Persist `~/.openclaw` + `~/.openclaw/workspace` on the host (survives restarts/rebuilds)
 - Access the Control UI from your laptop via an SSH tunnel
 
-That mounted `~/.openclaw` state includes `openclaw.json`, `auth-profiles.json`,
-and `.env`.
+That mounted `~/.openclaw` state includes `openclaw.json`, per-agent
+`agents/<agentId>/agent/auth-profiles.json`, and `.env`.
 
 The Gateway can be accessed via:
 
@@ -154,7 +154,8 @@ For the generic Docker flow, see [Docker](/install/docker).
     **Do not commit this file.**
 
     This `.env` file is for container/runtime env such as `OPENCLAW_GATEWAY_TOKEN`.
-    Stored provider OAuth/API-key auth lives in the mounted `~/.openclaw/auth-profiles.json`.
+    Stored provider OAuth/API-key auth lives in the mounted
+    `~/.openclaw/agents/<agentId>/agent/auth-profiles.json`.
 
   </Step>