feat: enable batch indexing by default

CHANGELOG.md

@@ -6,6 +6,7 @@ Docs: https://docs.clawd.bot
 
 ### Changes
 - Memory: add OpenAI Batch API indexing for embeddings when configured.
+- Memory: enable OpenAI batch indexing by default for OpenAI embeddings.
 
 ### Fixes
 - Memory: retry transient 5xx errors (Cloudflare) during embedding indexing.

docs/concepts/memory.md

@@ -109,7 +109,7 @@ If you don't want to set an API key, use `memorySearch.provider = "local"` or se
 `memorySearch.fallback = "none"`.
 
 Batch indexing (OpenAI only):
-- Set `agents.defaults.memorySearch.remote.batch.enabled = true` to submit embeddings via the OpenAI Batch API.
+- Enabled by default for OpenAI embeddings. Set `agents.defaults.memorySearch.remote.batch.enabled = false` to disable.
 - Default behavior waits for batch completion; tune `remote.batch.wait`, `remote.batch.pollIntervalMs`, and `remote.batch.timeoutMinutes` if needed.
 - Batch mode currently applies only when `memorySearch.provider = "openai"` and uses your OpenAI API key.
 
@@ -123,7 +123,7 @@ agents: {
       model: "text-embedding-3-small",
       fallback: "openai",
       remote: {
-        batch: { enabled: true }
+        batch: { enabled: false }
       },
       sync: { watch: true }
     }

src/agents/memory-search.test.ts

@@ -98,7 +98,7 @@ describe("memory search config", () => {
       apiKey: "default-key",
       headers: { "X-Default": "on" },
       batch: {
-        enabled: false,
+        enabled: true,
         wait: true,
         pollIntervalMs: 5000,
         timeoutMinutes: 60,

src/agents/memory-search.ts

@@ -96,7 +96,7 @@ function mergeConfig(
   const provider = overrides?.provider ?? defaults?.provider ?? "openai";
   const hasRemote = Boolean(defaults?.remote || overrides?.remote);
   const batch = {
-    enabled: overrides?.remote?.batch?.enabled ?? defaults?.remote?.batch?.enabled ?? false,
+    enabled: overrides?.remote?.batch?.enabled ?? defaults?.remote?.batch?.enabled ?? true,
     wait: overrides?.remote?.batch?.wait ?? defaults?.remote?.batch?.wait ?? true,
     pollIntervalMs:
       overrides?.remote?.batch?.pollIntervalMs ??

src/config/schema.ts

@@ -367,7 +367,7 @@ const FIELD_HELP: Record<string, string> = {
   "agents.defaults.memorySearch.remote.headers":
     "Extra headers for remote embeddings (merged; remote overrides OpenAI headers).",
   "agents.defaults.memorySearch.remote.batch.enabled":
-    "Enable OpenAI Batch API for memory embeddings (default: false).",
+    "Enable OpenAI Batch API for memory embeddings (default: true).",
   "agents.defaults.memorySearch.remote.batch.wait":
     "Wait for OpenAI batch completion when indexing (default: true).",
   "agents.defaults.memorySearch.remote.batch.pollIntervalMs":

src/config/types.tools.ts

@@ -159,7 +159,7 @@ export type MemorySearchConfig = {
     apiKey?: string;
     headers?: Record<string, string>;
     batch?: {
-      /** Enable OpenAI Batch API for embedding indexing (default: false). */
+      /** Enable OpenAI Batch API for embedding indexing (default: true). */
       enabled?: boolean;
       /** Wait for batch completion (default: true). */
       wait?: boolean;