docs/feat: clarify UptimeRobot limitations for private Spaces and disable setup UI in private views

README.md

@@ -60,7 +60,7 @@ Watch a quick walkthrough on YouTube: [Deploying HuggingClaw on HF Spaces](https
 
 [![Duplicate this Space](https://huggingface.co/datasets/huggingface/badges/resolve/main/duplicate-this-space-xl.svg)](https://huggingface.co/spaces/somratpro/HuggingClaw?duplicate=true)
 
-Click the button above to duplicate the template. And set the visibility to **Private** (recommended).
+Click the button above to duplicate the template. 
 
 ### Step 2: Add Your Secrets
 
@@ -81,7 +81,7 @@ That's it! The Space will build the container and start up automatically. You ca
 
 ### Step 4: Monitor & Manage
 
-HuggingClaw features a built-in dashboard at `/` (with `/dashboard` kept as an alias) to track:
+HuggingClaw features a built-in dashboard to track:
 
 - **Uptime:** Real-time uptime monitoring.
 - **Sync Status:** Visual indicators for workspace backup operations.
@@ -128,7 +128,7 @@ For persistent chat history and configuration, HuggingClaw can sync your workspa
 
 ## 💓 Staying Alive *(Recommended on Free HF Spaces)*
 
-Free Hugging Face Spaces can still sleep. HuggingClaw does not rely on internal self-pings anymore. To help keep your Space awake, set up an external UptimeRobot monitor from the dashboard.
+Free Hugging Face Spaces can still sleep. HuggingClaw does not rely on internal self-pings anymore. To help keep a public Space awake, set up an external UptimeRobot monitor from the dashboard.
 
 Use the **Main API key** from UptimeRobot.
 Do **not** use the `Read-only API key` or a `Monitor-specific API key`.
@@ -148,6 +148,11 @@ What happens next:
 
 You do **not** need to add this key to Hugging Face Space Secrets.
 
+Note:
+
+- This works for **public** Spaces.
+- It does **not** work reliably for **private** Spaces, because external monitors cannot access private HF health URLs.
+
 ## 🔔 Webhooks *(Optional)*
 
 Get notified when your Space restarts or if a backup fails:

health-server.js

@@ -556,37 +556,42 @@ function renderDashboard(initialData) {
 
         <div class="stat-card helper-card">
             <span class="stat-label">Keep Space Awake</span>
-            <div class="helper-copy">
-                If you use a free Hugging Face Space, it can still sleep.
-                To keep it awake, create an external UptimeRobot monitor here.
-                Use your <strong>Main API key</strong>.
-            </div>
-            <div class="helper-copy">
-                Do <strong>not</strong> use the Read-only API key or a Monitor-specific API key.
-            </div>
-            <div id="uptimerobot-summary" class="helper-summary">
-                Optional one-time setup. If you already created the monitor before, you do not need to paste the key again.
-            </div>
-            <button id="uptimerobot-toggle" class="helper-toggle" type="button">
-                Set Up Monitor
-            </button>
-            <div id="uptimerobot-shell" class="helper-shell hidden">
-                <div class="helper-row">
-                    <input
-                        id="uptimerobot-key"
-                        class="helper-input"
-                        type="password"
-                        placeholder="Paste your UptimeRobot Main API key"
-                        autocomplete="off"
-                    />
-                    <button id="uptimerobot-btn" class="helper-button" type="button">
-                        Create Monitor
-                    </button>
+            <div id="uptimerobot-public-flow">
+                <div class="helper-copy">
+                    If you use a free Hugging Face Space, it can still sleep.
+                    To keep it awake, create an external UptimeRobot monitor here.
+                    Use your <strong>Main API key</strong>.
+                </div>
+                <div class="helper-copy">
+                    Do <strong>not</strong> use the Read-only API key or a Monitor-specific API key.
+                </div>
+                <div id="uptimerobot-summary" class="helper-summary">
+                    Optional one-time setup. If you already created the monitor before, you do not need to paste the key again.
                 </div>
-                <div class="helper-note">
-                    One-time setup. Your key is only used to create the monitor for this Space.
+                <button id="uptimerobot-toggle" class="helper-toggle" type="button">
+                    Set Up Monitor
+                </button>
+                <div id="uptimerobot-shell" class="helper-shell hidden">
+                    <div class="helper-row">
+                        <input
+                            id="uptimerobot-key"
+                            class="helper-input"
+                            type="password"
+                            placeholder="Paste your UptimeRobot Main API key"
+                            autocomplete="off"
+                        />
+                        <button id="uptimerobot-btn" class="helper-button" type="button">
+                            Create Monitor
+                        </button>
+                    </div>
+                    <div class="helper-note">
+                        One-time setup. Your key is only used to create the monitor for this Space.
+                    </div>
                 </div>
             </div>
+            <div id="uptimerobot-private-note" class="helper-summary hidden">
+                <strong>Not available on private Spaces.</strong> External monitors like UptimeRobot cannot reliably access a private Hugging Face Space health URL, so this setup only works on public Spaces.
+            </div>
             <div id="uptimerobot-result" class="helper-result"></div>
         </div>
 
@@ -652,6 +657,11 @@ function renderDashboard(initialData) {
 
         const monitorStateKey = 'huggingclaw_uptimerobot_setup_v1';
 
+        function isPrivateSignedView() {
+            const params = new URLSearchParams(window.location.search || '');
+            return params.has('__sign');
+        }
+
         function setMonitorUiState(isConfigured) {
             const summary = document.getElementById('uptimerobot-summary');
             const shell = document.getElementById('uptimerobot-shell');
@@ -731,8 +741,13 @@ function renderDashboard(initialData) {
         setInterval(updateStats, 10000);
         restoreMonitorUiState();
         document.getElementById('control-ui-link').setAttribute('href', getDashboardBase() + '/app/' + getCurrentSearch());
-        document.getElementById('uptimerobot-btn').addEventListener('click', setupUptimeRobot);
-        document.getElementById('uptimerobot-toggle').addEventListener('click', toggleMonitorSetup);
+        if (isPrivateSignedView()) {
+            document.getElementById('uptimerobot-public-flow').classList.add('hidden');
+            document.getElementById('uptimerobot-private-note').classList.remove('hidden');
+        } else {
+            document.getElementById('uptimerobot-btn').addEventListener('click', setupUptimeRobot);
+            document.getElementById('uptimerobot-toggle').addEventListener('click', toggleMonitorSetup);
+        }
     </script>
 </body>
 </html>