fix(openclaw): bound managed inference compaction

scripts/generate-openclaw-config.mts

@@ -74,6 +74,17 @@ const OPENCLAW_MIN_PROMPT_BUDGET_TOKENS = 8_000;
 const SMALL_OLLAMA_CONTEXT_THRESHOLD =
   OPENCLAW_DEFAULT_RESERVE_TOKENS_FLOOR + OPENCLAW_MIN_PROMPT_BUDGET_TOKENS;
 const LOCAL_OLLAMA_UPSTREAM_PROVIDER = "ollama-local";
+const MANAGED_INFERENCE_PROVIDER_KEY = "inference";
+const MANAGED_INFERENCE_HOSTNAME = "inference.local";
+const MANAGED_INFERENCE_SAFEGUARD_COMPACTION: JsonObject = {
+  mode: "safeguard",
+  timeoutSeconds: 120,
+  maxHistoryShare: 0.35,
+  recentTurnsPreserve: 1,
+  qualityGuard: { enabled: true, maxRetries: 0 },
+  notifyUser: true,
+  truncateAfterCompaction: true,
+};
 const FALSE_VALUES = new Set(["0", "false", "no", "off"]);
 const WEB_SEARCH_PROVIDERS = {
   brave: { credentialEnv: "BRAVE_API_KEY" },
@@ -1018,6 +1029,38 @@ export function buildLocalOllamaSmallContextCompaction(
   return { reserveTokens, reserveTokensFloor: reserveTokens };
 }
 
+function isManagedInferenceLocalRoute(
+  providerKey: string | undefined,
+  inferenceBaseUrl: string,
+): boolean {
+  if ((providerKey || "").trim() !== MANAGED_INFERENCE_PROVIDER_KEY) {
+    return false;
+  }
+  return parseUrl(normalizeUrlForParse(inferenceBaseUrl)).hostname === MANAGED_INFERENCE_HOSTNAME;
+}
+
+// Managed remote inference sessions use OpenClaw's safeguard compaction rather
+// than its plain runtime compactor. A two-minute timeout bounds each attempt,
+// lifecycle notices expose automatic and agent-run compaction progress, and
+// successful compaction rotates the active transcript. These safeguards do not
+// guarantee that summarization succeeds or that the resulting context is smaller.
+export function buildManagedInferenceSafeguardCompaction(
+  providerKey: string | undefined,
+  upstreamProvider: string | undefined,
+  inferenceBaseUrl: string,
+): JsonObject | undefined {
+  if (!isManagedInferenceLocalRoute(providerKey, inferenceBaseUrl)) {
+    return undefined;
+  }
+  if ((upstreamProvider || "").trim() === LOCAL_OLLAMA_UPSTREAM_PROVIDER) {
+    return undefined;
+  }
+  return {
+    ...MANAGED_INFERENCE_SAFEGUARD_COMPACTION,
+    qualityGuard: { ...MANAGED_INFERENCE_SAFEGUARD_COMPACTION.qualityGuard },
+  };
+}
+
 export function buildConfig(env: Env = process.env): JsonObject {
   const proxyHost = env.NEMOCLAW_PROXY_HOST || "10.200.0.1";
   const proxyPort = env.NEMOCLAW_PROXY_PORT || "3128";
@@ -1237,6 +1280,14 @@ export function buildConfig(env: Env = process.env): JsonObject {
   if (smallOllamaCompaction) {
     agentDefaults.compaction = smallOllamaCompaction;
   }
+  const managedInferenceCompaction = buildManagedInferenceSafeguardCompaction(
+    providerKey,
+    env.NEMOCLAW_UPSTREAM_PROVIDER,
+    inferenceBaseUrl,
+  );
+  if (managedInferenceCompaction) {
+    agentDefaults.compaction = managedInferenceCompaction;
+  }
 
   const config: JsonObject = {
     agents: {

test/ollama-local-openclaw-config-propagation.test.ts

@@ -10,6 +10,7 @@ import { afterEach, describe, expect, it } from "vitest";
 import {
   buildConfig,
   buildLocalOllamaSmallContextCompaction,
+  buildManagedInferenceSafeguardCompaction,
 } from "../scripts/generate-openclaw-config.mts";
 import { patchStagedDockerfile } from "../src/lib/onboard/dockerfile-patch";
 
@@ -131,7 +132,7 @@ describe("ollama-local OpenClaw config propagation", () => {
   });
 });
 
-describe("ollama-local small-context compaction policy (#5468)", () => {
+describe("OpenClaw managed-route compaction policy (#5468, #4781)", () => {
   it("emits a lowered compaction reserve for a small Local Ollama window", () => {
     const config = buildConfig({
       NEMOCLAW_MODEL: "qwen2.5:0.5b",
@@ -152,7 +153,7 @@ describe("ollama-local small-context compaction policy (#5468)", () => {
     });
   });
 
-  it("does not touch compaction for a non-ollama upstream provider", () => {
+  it("uses safeguard compaction for remote managed inference (#4781)", () => {
     const config = buildConfig({
       NEMOCLAW_MODEL: "nvidia/nemotron-3-super-120b-a12b",
       NEMOCLAW_PROVIDER_KEY: "inference",
@@ -164,7 +165,15 @@ describe("ollama-local small-context compaction policy (#5468)", () => {
       NEMOCLAW_MAX_TOKENS: "4096",
       NEMOCLAW_AGENT_TIMEOUT: "600",
     });
-    expect(config.agents.defaults.compaction).toBeUndefined();
+    expect(config.agents.defaults.compaction).toEqual({
+      mode: "safeguard",
+      timeoutSeconds: 120,
+      maxHistoryShare: 0.35,
+      recentTurnsPreserve: 1,
+      qualityGuard: { enabled: true, maxRetries: 0 },
+      notifyUser: true,
+      truncateAfterCompaction: true,
+    });
   });
 
   it("leaves OpenClaw's default reserve intact for large Local Ollama windows", () => {
@@ -182,6 +191,26 @@ describe("ollama-local small-context compaction policy (#5468)", () => {
     expect(config.agents.defaults.compaction).toBeUndefined();
   });
 
+  it("does not enable managed-inference safeguards outside inference.local (#4781)", () => {
+    expect(
+      buildManagedInferenceSafeguardCompaction(
+        "inference",
+        "nvidia-prod",
+        "https://integrate.api.nvidia.com/v1",
+      ),
+    ).toBeUndefined();
+  });
+
+  it("does not enable managed-inference safeguards for another provider key (#4781)", () => {
+    expect(
+      buildManagedInferenceSafeguardCompaction(
+        "nvidia-prod",
+        "nvidia-prod",
+        "https://inference.local/v1",
+      ),
+    ).toBeUndefined();
+  });
+
   it("clamps the reserve so the prompt budget never drops below OpenClaw's 8k minimum", () => {
     // A pathological maxTokens must not make the window worse than the default.
     const compaction = buildLocalOllamaSmallContextCompaction("ollama-local", 16384, 99999);