From af4e9d19cfd3fd2e6da38d76f7d246291a3827db Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Sat, 4 Apr 2026 10:32:33 +0100
Subject: [PATCH] docs: refresh linux gateway service guidance

---
 docs/gateway/index.md   | 25 +++++++++++++++++++++++++
 docs/install/fly.md     |  2 +-
 docs/platforms/linux.md | 10 ++++++++--
 3 files changed, 34 insertions(+), 3 deletions(-)

diff --git a/docs/gateway/index.md b/docs/gateway/index.md
index 077043bc59e..de5f1b0ecbe 100644
--- a/docs/gateway/index.md
+++ b/docs/gateway/index.md
@@ -177,6 +177,27 @@ For persistence after logout, enable lingering:
 
 ```bash
 sudo loginctl enable-linger <user>
+```
+
+Manual user-unit example when you need a custom install path:
+
+```ini
+[Unit]
+Description=OpenClaw Gateway
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+ExecStart=/usr/local/bin/openclaw gateway --port 18789
+Restart=always
+RestartSec=5
+TimeoutStopSec=30
+TimeoutStartSec=30
+SuccessExitStatus=0 143
+KillMode=control-group
+
+[Install]
+WantedBy=default.target
 ```
 
   </Tab>
@@ -190,6 +211,10 @@ sudo systemctl daemon-reload
 sudo systemctl enable --now openclaw-gateway[-<profile>].service
 ```
 
+Use the same service body as the user unit, but install it under
+`/etc/systemd/system/openclaw-gateway[-<profile>].service` and adjust
+`ExecStart=` if your `openclaw` binary lives elsewhere.
+
   </Tab>
 </Tabs>
 
diff --git a/docs/install/fly.md b/docs/install/fly.md
index 3cdfe52dee0..cc3c6815293 100644
--- a/docs/install/fly.md
+++ b/docs/install/fly.md
@@ -156,7 +156,7 @@ read_when:
         "defaults": {
           "model": {
             "primary": "anthropic/claude-opus-4-6",
-            "fallbacks": ["anthropic/claude-sonnet-4-6", "openai/gpt-4o"]
+            "fallbacks": ["anthropic/claude-sonnet-4-6", "openai/gpt-5.4"]
           },
           "maxConcurrent": 4
         },
diff --git a/docs/platforms/linux.md b/docs/platforms/linux.md
index ba6804500e3..291c43759fc 100644
--- a/docs/platforms/linux.md
+++ b/docs/platforms/linux.md
@@ -65,8 +65,10 @@ openclaw doctor
 ## System control (systemd user unit)
 
 OpenClaw installs a systemd **user** service by default. Use a **system**
-service for shared or always-on servers. The full unit example and guidance
-live in the [Gateway runbook](/gateway).
+service for shared or always-on servers. `openclaw gateway install` and
+`openclaw onboard --install-daemon` already render the current canonical unit
+for you; write one by hand only when you need a custom system/service-manager
+setup. The full service guidance lives in the [Gateway runbook](/gateway).
 
 Minimal setup:
 
@@ -82,6 +84,10 @@ Wants=network-online.target
 ExecStart=/usr/local/bin/openclaw gateway --port 18789
 Restart=always
 RestartSec=5
+TimeoutStopSec=30
+TimeoutStartSec=30
+SuccessExitStatus=0 143
+KillMode=control-group
 
 [Install]
 WantedBy=default.target