From 6dc5d003743ab3ce1b1d517abcb0e5f88f89da6f Mon Sep 17 00:00:00 2001
From: Vincent Koc <vincentkoc@ieee.org>
Date: Wed, 5 Aug 2026 02:10:27 +0800
Subject: [PATCH] fix(llama-cpp): explain cleanup failure recovery

---
 extensions/llama-cpp/src/inference-provider.test.ts | 2 +-
 extensions/llama-cpp/src/inference-provider.ts      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/extensions/llama-cpp/src/inference-provider.test.ts b/extensions/llama-cpp/src/inference-provider.test.ts
index 26bc0959e268..c723a29fb55d 100644
--- a/extensions/llama-cpp/src/inference-provider.test.ts
+++ b/extensions/llama-cpp/src/inference-provider.test.ts
@@ -869,7 +869,7 @@ describe("llama.cpp inference provider", () => {
     const disposing = inferenceRuntime.dispose();
     rejectCleanup(new Error("context cleanup failed"));
     await expect(unavailable.result()).resolves.toMatchObject({
-      errorMessage: "llama.cpp runtime stopped after cleanup failed",
+      errorMessage: expect.stringContaining("openclaw gateway restart"),
     });
     await expect(disposing).rejects.toThrow("context cleanup failed");
     expectDisposeCalls(2, 1, 0);
diff --git a/extensions/llama-cpp/src/inference-provider.ts b/extensions/llama-cpp/src/inference-provider.ts
index 1481862a8776..82b13e4b59ee 100644
--- a/extensions/llama-cpp/src/inference-provider.ts
+++ b/extensions/llama-cpp/src/inference-provider.ts
@@ -95,7 +95,7 @@ function runtimeUnavailableMessage(
     content: [],
     stopReason: "error",
     errorMessage: state.cleanupFailure
-      ? "llama.cpp runtime stopped after cleanup failed"
+      ? "llama.cpp runtime stopped after cleanup failed. Run `openclaw gateway restart` to recover."
       : "llama.cpp runtime is stopping",
   });
 }