fix: honor configured store limits (openclaw#66240) (thanks @neeravmakwana)

* fix(media): honor configured store limits

* fix(media): report effective source limits

* refactor(media): distill configured limit wiring

---------

Co-authored-by: Ayaan Zaidi <hi@obviy.us>

Author: neeravmakwana

CHANGELOG.md

@@ -60,6 +60,7 @@ Docs: https://docs.openclaw.ai
 - Slack/doctor: add a dedicated doctor-contract sidecar so config warmup paths such as `openclaw cron` no longer fall back to Slack's broader contract surface, which could trigger Slack-related config-read crashes on affected setups. (#63192) Thanks @shhtheonlyperson.
 - Hooks/session-memory: pass the resolved agent workspace into gateway `/new` and `/reset` session-memory hooks so reset snapshots stay scoped to the right agent workspace instead of leaking into the default workspace. (#64735) Thanks @suboss87 and @vincentkoc.
 - CLI/approvals: raise the default `openclaw approvals get` gateway timeout and report config-load timeouts explicitly, so slow hosts stop showing a misleading `Config unavailable.` note when the approvals snapshot succeeds but the follow-up config RPC needs more time. (#66239) Thanks @neeravmakwana.
+- Media/store: honor configured agent media limits when saving generated media and persisting outbound reply media, so the store no longer hard-stops those flows at 5 MB before the configured limit applies. (#66229) Thanks @neeravmakwana and @vincentkoc.
 
 ## 2026.4.12
 

src/agents/tools/image-generate-tool.test.ts

@@ -348,6 +348,7 @@ describe("createImageGenerateTool", () => {
       config: {
         agents: {
           defaults: {
+            mediaMaxMb: 8,
             imageGenerationModel: {
               primary: "openai/gpt-image-1",
             },
@@ -375,6 +376,7 @@ describe("createImageGenerateTool", () => {
         cfg: {
           agents: {
             defaults: {
+              mediaMaxMb: 8,
               imageGenerationModel: {
                 primary: "openai/gpt-image-1",
               },
@@ -394,15 +396,15 @@ describe("createImageGenerateTool", () => {
       Buffer.from("png-1"),
       "image/png",
       "tool-image-generation",
-      undefined,
+      8 * 1024 * 1024,
       "cats/output.png",
     );
     expect(saveMediaBuffer).toHaveBeenNthCalledWith(
       2,
       Buffer.from("png-2"),
       "image/png",
       "tool-image-generation",
-      undefined,
+      8 * 1024 * 1024,
       "cats/output.png",
     );
     expect(result).toMatchObject({

src/agents/tools/image-generate-tool.ts

@@ -12,6 +12,7 @@ import type {
   ImageGenerationResolution,
   ImageGenerationSourceImage,
 } from "../../image-generation/types.js";
+import { resolveConfiguredMediaMaxBytes } from "../../media/configured-max-bytes.js";
 import { getImageMetadata } from "../../media/image-ops.js";
 import { saveMediaBuffer } from "../../media/store.js";
 import { loadWebMedia } from "../../media/web-media.js";
@@ -178,14 +179,6 @@ function normalizeReferenceImages(args: Record<string, unknown>): string[] {
   });
 }
 
-function pickConfiguredMediaMaxBytes(cfg?: OpenClawConfig): number | undefined {
-  const configured = cfg?.agents?.defaults?.mediaMaxMb;
-  if (typeof configured === "number" && Number.isFinite(configured) && configured > 0) {
-    return Math.floor(configured * 1024 * 1024);
-  }
-  return undefined;
-}
-
 function resolveSelectedImageGenerationProvider(params: {
   config?: OpenClawConfig;
   imageGenerationModelConfig: ToolModelConfig;
@@ -467,9 +460,10 @@ export function createImageGenerateTool(options?: {
         modelOverride: model,
       });
       const count = resolveRequestedCount(params);
+      const configuredMediaMaxBytes = resolveConfiguredMediaMaxBytes(effectiveCfg);
       const loadedReferenceImages = await loadReferenceImages({
         imageInputs,
-        maxBytes: pickConfiguredMediaMaxBytes(effectiveCfg),
+        maxBytes: configuredMediaMaxBytes,
         workspaceDir: options?.workspaceDir,
         sandboxConfig,
       });
@@ -542,7 +536,7 @@ export function createImageGenerateTool(options?: {
             image.buffer,
             image.mimeType,
             "tool-image-generation",
-            undefined,
+            configuredMediaMaxBytes,
             filename || image.fileName,
           ),
         ),

src/agents/tools/music-generate-tool.test.ts

@@ -167,7 +167,7 @@ describe("createMusicGenerateTool", () => {
       lyrics: ["wake the city up"],
       metadata: { taskId: "music-task-1" },
     });
-    vi.spyOn(mediaStore, "saveMediaBuffer").mockResolvedValueOnce({
+    const saveSpy = vi.spyOn(mediaStore, "saveMediaBuffer").mockResolvedValueOnce({
       path: "/tmp/generated-night-drive.mp3",
       id: "generated-night-drive.mp3",
       size: 11,
@@ -178,6 +178,7 @@ describe("createMusicGenerateTool", () => {
       config: asConfig({
         agents: {
           defaults: {
+            mediaMaxMb: 8,
             musicGenerationModel: { primary: "google/lyria-3-clip-preview" },
           },
         },
@@ -194,6 +195,13 @@ describe("createMusicGenerateTool", () => {
     });
     const text = (result.content?.[0] as { text: string } | undefined)?.text ?? "";
 
+    expect(saveSpy).toHaveBeenCalledWith(
+      Buffer.from("music-bytes"),
+      "audio/mpeg",
+      "tool-music-generation",
+      8 * 1024 * 1024,
+      "night-drive.mp3",
+    );
     expect(text).toContain("Generated 1 track with google/lyria-3-clip-preview.");
     expect(text).toContain("Lyrics returned.");
     expect(text).toContain("MEDIA:/tmp/generated-night-drive.mp3");

src/agents/tools/music-generate-tool.ts

@@ -3,6 +3,7 @@ import { loadConfig } from "../../config/config.js";
 import type { OpenClawConfig } from "../../config/types.openclaw.js";
 import { formatErrorMessage } from "../../infra/errors.js";
 import { createSubsystemLogger } from "../../logging/subsystem.js";
+import { resolveConfiguredMediaMaxBytes } from "../../media/configured-max-bytes.js";
 import { saveMediaBuffer } from "../../media/store.js";
 import { loadWebMedia } from "../../media/web-media.js";
 import { resolveMusicGenerationModeCapabilities } from "../../music-generation/capabilities.js";
@@ -359,13 +360,14 @@ async function executeMusicGenerationJob(params: {
       progressSummary: "Saving generated music",
     });
   }
+  const configuredMediaMaxBytes = resolveConfiguredMediaMaxBytes(params.effectiveCfg);
   const savedTracks = await Promise.all(
     result.tracks.map((track) =>
       saveMediaBuffer(
         track.buffer,
         track.mimeType,
         "tool-music-generation",
-        undefined,
+        configuredMediaMaxBytes,
         params.filename || track.fileName,
       ),
     ),

src/agents/tools/video-generate-tool.test.ts

@@ -134,7 +134,7 @@ describe("createVideoGenerateTool", () => {
       ],
       metadata: { taskId: "task-1" },
     });
-    vi.spyOn(mediaStore, "saveMediaBuffer").mockResolvedValueOnce({
+    const saveSpy = vi.spyOn(mediaStore, "saveMediaBuffer").mockResolvedValueOnce({
       path: "/tmp/generated-lobster.mp4",
       id: "generated-lobster.mp4",
       size: 11,
@@ -145,6 +145,7 @@ describe("createVideoGenerateTool", () => {
       config: asConfig({
         agents: {
           defaults: {
+            mediaMaxMb: 8,
             videoGenerationModel: { primary: "qwen/wan2.6-t2v" },
           },
         },
@@ -158,6 +159,13 @@ describe("createVideoGenerateTool", () => {
     const result = await tool.execute("call-1", { prompt: "friendly lobster surfing" });
     const text = (result.content?.[0] as { text: string } | undefined)?.text ?? "";
 
+    expect(saveSpy).toHaveBeenCalledWith(
+      Buffer.from("video-bytes"),
+      "video/mp4",
+      "tool-video-generation",
+      8 * 1024 * 1024,
+      "lobster.mp4",
+    );
     expect(text).toContain("Generated 1 video with qwen/wan2.6-t2v.");
     expect(text).toContain("MEDIA:/tmp/generated-lobster.mp4");
     expect(result.details).toMatchObject({

src/agents/tools/video-generate-tool.ts

@@ -3,6 +3,7 @@ import { loadConfig } from "../../config/config.js";
 import type { OpenClawConfig } from "../../config/types.openclaw.js";
 import { formatErrorMessage } from "../../infra/errors.js";
 import { createSubsystemLogger } from "../../logging/subsystem.js";
+import { resolveConfiguredMediaMaxBytes } from "../../media/configured-max-bytes.js";
 import { saveMediaBuffer } from "../../media/store.js";
 import { loadWebMedia } from "../../media/web-media.js";
 import { readSnakeCaseParamRaw } from "../../param-key.js";
@@ -611,13 +612,14 @@ async function executeVideoGenerationJob(params: {
     );
   }
 
+  const configuredMediaMaxBytes = resolveConfiguredMediaMaxBytes(params.effectiveCfg);
   const savedVideos = await Promise.all(
     bufferVideos.map((video) =>
       saveMediaBuffer(
         video.buffer,
         video.mimeType,
         "tool-video-generation",
-        undefined,
+        configuredMediaMaxBytes,
         params.filename || video.fileName,
       ),
     ),

src/auto-reply/reply/reply-media-paths.test.ts

@@ -165,7 +165,7 @@ describe("createReplyMediaPathNormalizer", () => {
       path: "/Users/peter/.openclaw/media/outbound/persisted.png",
     });
     const normalize = createReplyMediaPathNormalizer({
-      cfg: {},
+      cfg: { agents: { defaults: { mediaMaxMb: 8 } } },
       sessionKey: "session-key",
       workspaceDir: "/Users/peter/.openclaw/workspace",
     });
@@ -180,6 +180,7 @@ describe("createReplyMediaPathNormalizer", () => {
       "/Users/peter/.openclaw/workspace/.openclaw/media/tool-image-generation/generated.png",
       undefined,
       "outbound",
+      8 * 1024 * 1024,
     );
     expect(result).toMatchObject({
       mediaUrl: "/Users/peter/.openclaw/media/outbound/persisted.png",
@@ -206,7 +207,7 @@ describe("createReplyMediaPathNormalizer", () => {
       mediaUrls: [tmpVoicePath],
     });
 
-    expect(saveMediaSource).toHaveBeenCalledWith(tmpVoicePath, undefined, "outbound");
+    expect(saveMediaSource).toHaveBeenCalledWith(tmpVoicePath, undefined, "outbound", undefined);
     expect(result).toMatchObject({
       mediaUrl: "/Users/peter/.openclaw/media/outbound/tts-voice.opus",
       mediaUrls: ["/Users/peter/.openclaw/media/outbound/tts-voice.opus"],

src/auto-reply/reply/reply-media-paths.ts

@@ -8,6 +8,7 @@ import { resolveEffectiveToolFsWorkspaceOnly } from "../../agents/tool-fs-policy
 import type { OpenClawConfig } from "../../config/types.openclaw.js";
 import { logVerbose } from "../../globals.js";
 import { resolvePreferredOpenClawTmpDir } from "../../infra/tmp-openclaw-dir.js";
+import { resolveConfiguredMediaMaxBytes } from "../../media/configured-max-bytes.js";
 import { saveMediaSource } from "../../media/store.js";
 import { resolveConfigDir } from "../../utils.js";
 import type { ReplyPayload } from "../types.js";
@@ -103,6 +104,7 @@ export function createReplyMediaPathNormalizer(params: {
     cfg: params.cfg,
     agentId,
   });
+  const configuredMediaMaxBytes = resolveConfiguredMediaMaxBytes(params.cfg);
   let sandboxRootPromise: Promise<string | undefined> | undefined;
   const persistedMediaBySource = new Map<string, Promise<string>>();
 
@@ -133,7 +135,7 @@ export function createReplyMediaPathNormalizer(params: {
     if (cached) {
       return await cached;
     }
-    const persistPromise = saveMediaSource(media, undefined, "outbound")
+    const persistPromise = saveMediaSource(media, undefined, "outbound", configuredMediaMaxBytes)
       .then((saved) => saved.path)
       .catch((err) => {
         persistedMediaBySource.delete(media);

src/media/configured-max-bytes.ts

@@ -0,0 +1,11 @@
+import type { OpenClawConfig } from "../config/types.openclaw.js";
+
+const MB = 1024 * 1024;
+
+export function resolveConfiguredMediaMaxBytes(cfg?: OpenClawConfig): number | undefined {
+  const configured = cfg?.agents?.defaults?.mediaMaxMb;
+  if (typeof configured === "number" && Number.isFinite(configured) && configured > 0) {
+    return Math.floor(configured * MB);
+  }
+  return undefined;
+}