diff --git a/.env.example b/.env.example
index 90d0dfd..e5631fb 100644
--- a/.env.example
+++ b/.env.example
@@ -8,3 +8,14 @@ VITE_LOCALE=en
 # Optional: client ID sent in the WebSocket connect frame (default: webchat)
 # Set to "openclaw-control-ui" to use OpenClaw's dangerouslyDisableDeviceAuth bypass
 VITE_CLIENT_ID=webchat
+
+# Optional: default session key to open on connect (default: agent:main:main)
+# Set this when deploying for a specific OpenClaw agent other than main.
+# Example: VITE_AGENT_SESSION=agent:artem:main
+VITE_AGENT_SESSION=
+
+# Optional: filter the session list to only show sessions matching this prefix.
+# Useful when multiple agents share a single gateway and you want each
+# PinchChat instance to show only its own sessions.
+# Example: VITE_AGENT_PREFIX=agent:artem:
+VITE_AGENT_PREFIX=