diff --git a/docs/configuration.md b/docs/configuration.md
index d5995e756..bba03e23f 100644
--- a/docs/configuration.md
+++ b/docs/configuration.md
@@ -375,13 +375,16 @@ Gmail helper config (used by `clawdis hooks gmail setup` / `run`):
       includeBody: true,
       maxBytes: 20000,
       renewEveryMinutes: 720,
-      serve: { bind: "127.0.0.1", port: 8788, path: "/gmail-pubsub" },
+      serve: { bind: "127.0.0.1", port: 8788, path: "/" },
       tailscale: { mode: "funnel", path: "/gmail-pubsub" },
     }
   }
 }
 ```
 
+Note: when `tailscale.mode` is on, Clawdis defaults `serve.path` to `/` so
+Tailscale can proxy `/gmail-pubsub` correctly (it strips the set-path prefix).
+
 ### `canvasHost` (LAN/tailnet Canvas file server + live reload)
 
 The Gateway serves a directory of HTML/CSS/JS over HTTP so iOS/Android nodes can simply `canvas.navigate` to it.
diff --git a/docs/gmail-pubsub.md b/docs/gmail-pubsub.md
index 57e867e6b..6a90c7663 100644
--- a/docs/gmail-pubsub.md
+++ b/docs/gmail-pubsub.md
@@ -46,6 +46,11 @@ Defaults:
 - Writes `hooks.gmail` config for `clawdis hooks gmail run`.
 - Enables the Gmail hook preset (`hooks.presets: ["gmail"]`).
 
+Path note: when `tailscale.mode` is enabled, Clawdis automatically sets
+`hooks.gmail.serve.path` to `/` and keeps the public path at
+`hooks.gmail.tailscale.path` (default `/gmail-pubsub`) because Tailscale
+strips the set-path prefix before proxying.
+
 Want a custom endpoint? Use `--push-endpoint <url>` or `--tailscale off`.
 
 Platform note: on macOS the wizard installs `gcloud`, `gogcli`, and `tailscale`