From 97d35f4c575be0216ca51c39b03589650f75b5a8 Mon Sep 17 00:00:00 2001
From: Vincent Koc <vincentkoc@ieee.org>
Date: Mon, 4 May 2026 03:33:49 -0700
Subject: [PATCH] fix(gateway): clarify systemd service scope

---
 CHANGELOG.md               | 1 +
 src/daemon/service.test.ts | 2 +-
 src/daemon/service.ts      | 2 +-
 3 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index c1f1f439395..ee2cb0ae48d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -64,6 +64,7 @@ Docs: https://docs.openclaw.ai
 
 ### Fixes
 
+- Gateway/status: label Linux managed gateway services as `systemd user`, making status output explicit about the user-service scope instead of implying a system-level unit. Thanks @vincentkoc.
 - Plugins/install: remove the previous managed plugin directory when a reinstall switches sources, so stale ClawHub and npm copies no longer keep duplicate plugin ids in discovery after the new install wins. Thanks @vincentkoc.
 - Plugins/install: let official plugin reinstall recovery repair source-only installed runtime shadows, so `openclaw plugins install npm:@openclaw/discord --force` can replace the bad package instead of stopping at stale config validation. Thanks @vincentkoc.
 - Plugins/commands: allow the official ClawHub Codex plugin package to keep reserved `/codex` command ownership, matching the existing npm-managed Codex package behavior. Thanks @vincentkoc.
diff --git a/src/daemon/service.test.ts b/src/daemon/service.test.ts
index 22e1e549a08..435aaf1c196 100644
--- a/src/daemon/service.test.ts
+++ b/src/daemon/service.test.ts
@@ -41,7 +41,7 @@ function createService(overrides: Partial<GatewayService> = {}): GatewayService
 describe("resolveGatewayService", () => {
   it.each([
     { platform: "darwin" as const, label: "LaunchAgent", loadedText: "loaded" },
-    { platform: "linux" as const, label: "systemd", loadedText: "enabled" },
+    { platform: "linux" as const, label: "systemd user", loadedText: "enabled" },
     { platform: "win32" as const, label: "Scheduled Task", loadedText: "registered" },
   ])("returns the registered adapter for $platform", ({ platform, label, loadedText }) => {
     setPlatform(platform);
diff --git a/src/daemon/service.ts b/src/daemon/service.ts
index 6cfb79e5816..66124d60048 100644
--- a/src/daemon/service.ts
+++ b/src/daemon/service.ts
@@ -262,7 +262,7 @@ const GATEWAY_SERVICE_REGISTRY: Record<SupportedGatewayServicePlatform, GatewayS
     readRuntime: readLaunchAgentRuntime,
   },
   linux: {
-    label: "systemd",
+    label: "systemd user",
     loadedText: "enabled",
     notLoadedText: "disabled",
     stage: ignoreServiceWriteResult(stageSystemdService),