From 6e6f3599db440dd0b2a9b5a6d02c26cee76eea4b Mon Sep 17 00:00:00 2001
From: David Aronchick <aronchick@expanso.io>
Date: Fri, 20 Feb 2026 03:09:51 +0000
Subject: [PATCH] gateway: integrate crash-loop detection and LKG rollback

---
 src/gateway/server.impl.ts | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/src/gateway/server.impl.ts b/src/gateway/server.impl.ts
index d46a38ef3d6..21abb6687bf 100644
--- a/src/gateway/server.impl.ts
+++ b/src/gateway/server.impl.ts
@@ -12,12 +12,19 @@ import { formatCliCommand } from "../cli/command-format.js";
 import { createDefaultDeps } from "../cli/deps.js";
 import {
   CONFIG_PATH,
+  STATE_DIR,
   isNixMode,
   loadConfig,
   migrateLegacyConfig,
   readConfigFileSnapshot,
   writeConfigFile,
 } from "../config/config.js";
+import {
+  hasLastKnownGood,
+  recordStartupAndCheckCrashLoop,
+  revertToLastKnownGood,
+  scheduleLastKnownGoodSave,
+} from "../config/crash-tracker.js";
 import { applyPluginAutoEnable } from "../config/plugin-auto-enable.js";
 import { clearAgentRunContext, onAgentEvent } from "../infra/agent-events.js";
 import {
@@ -156,6 +163,16 @@ export async function startGatewayServer(
   port = 18789,
   opts: GatewayServerOptions = {},
 ): Promise<GatewayServer> {
+  const isCrashLoop = recordStartupAndCheckCrashLoop(STATE_DIR);
+  if (isCrashLoop) {
+    if (hasLastKnownGood(CONFIG_PATH)) {
+      log.warn("gateway: crash loop detected; reverting to last-known-good config");
+      revertToLastKnownGood(CONFIG_PATH, STATE_DIR);
+    } else {
+      log.warn("gateway: crash loop detected but no last-known-good config found");
+    }
+  }
+
   // Ensure all default port derivations (browser/canvas) see the actual runtime port.
   process.env.OPENCLAW_GATEWAY_PORT = String(port);
   logAcceptedEnvOption({
@@ -622,6 +639,8 @@ export async function startGatewayServer(
     httpServers,
   });
 
+  scheduleLastKnownGoodSave(CONFIG_PATH, STATE_DIR);
+
   return {
     close: async (opts) => {
       if (diagnosticsEnabled) {