From 1580fe1018a0b14ceb3f7edf30ff1a771c0271d5 Mon Sep 17 00:00:00 2001
From: Ruslan Belkin <ruslan@jelled.io>
Date: Mon, 2 Mar 2026 17:55:51 -0800
Subject: [PATCH] scripts: default keepawake to allow display sleep

---
 docs/install/docker.md        |  3 ++-
 scripts/openclaw-keepawake.sh | 12 ++++++++++--
 2 files changed, 12 insertions(+), 3 deletions(-)

diff --git a/docs/install/docker.md b/docs/install/docker.md
index 61be00a81bf..1e1b9ca3fca 100644
--- a/docs/install/docker.md
+++ b/docs/install/docker.md
@@ -231,7 +231,8 @@ scripts/openclaw-keepawake.sh off
 
 Details:
 
-- Uses `caffeinate -dimsu` in the background.
+- Uses `caffeinate -imsu` in the background (allows display sleep).
+- Set `OPENCLAW_KEEPAWAKE_FLAGS=-dimsu` if you want displays to stay on.
 - Stores PID at `~/.openclaw/run/keepawake.pid`.
 - Requires macOS (`caffeinate` command).
 
diff --git a/scripts/openclaw-keepawake.sh b/scripts/openclaw-keepawake.sh
index 444d8487a1a..72bfab5a1c8 100755
--- a/scripts/openclaw-keepawake.sh
+++ b/scripts/openclaw-keepawake.sh
@@ -2,6 +2,7 @@
 set -euo pipefail
 
 PID_FILE="${OPENCLAW_KEEPAWAKE_PID_FILE:-$HOME/.openclaw/run/keepawake.pid}"
+KEEPAWAKE_FLAGS="${OPENCLAW_KEEPAWAKE_FLAGS:--imsu}"
 
 usage() {
   cat <<'USAGE'
@@ -14,6 +15,10 @@ Commands:
   off      Stop keep-awake background process
   status   Show current keep-awake status
   restart  Restart keep-awake background process
+
+Environment:
+  OPENCLAW_KEEPAWAKE_FLAGS  caffeinate flags (default: -imsu)
+                            Use -dimsu to keep displays awake too.
 USAGE
 }
 
@@ -50,10 +55,13 @@ start_awake() {
     return 0
   fi
 
-  caffeinate -dimsu >/dev/null 2>&1 &
+  local -a flags
+  # Allow override for special cases (for example keeping displays on).
+  read -r -a flags <<<"$KEEPAWAKE_FLAGS"
+  caffeinate "${flags[@]}" >/dev/null 2>&1 &
   pid="$!"
   echo "$pid" >"$PID_FILE"
-  echo "keep-awake on (pid $pid)"
+  echo "keep-awake on (pid $pid, flags: $KEEPAWAKE_FLAGS)"
 }
 
 stop_awake() {