From cb45f16330f66adf3411d009bd9e50b1a332e7b7 Mon Sep 17 00:00:00 2001 From: Peter Steinberger Date: Mon, 27 Apr 2026 09:52:56 +0100 Subject: [PATCH] docs: clarify cron concurrency lanes --- docs/.generated/config-baseline.sha256 | 6 +++--- docs/gateway/configuration-examples.md | 2 +- docs/gateway/configuration-reference.md | 2 +- docs/gateway/configuration.md | 2 +- src/config/schema.base.generated.ts | 4 ++-- src/config/schema.help.ts | 2 +- 6 files changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/.generated/config-baseline.sha256 b/docs/.generated/config-baseline.sha256 index 1941ca03824..8cd9f5e3c7f 100644 --- a/docs/.generated/config-baseline.sha256 +++ b/docs/.generated/config-baseline.sha256 @@ -1,4 +1,4 @@ -d2b40fe44761f9e412ce3d4336f341c9c4406f990d09219898cb97cd12c0fdd1 config-baseline.json -200c156a074a1eec03bb04b3852b4fd5f1fa4ffa140cc5acdc5e412a33600f14 config-baseline.core.json +decbeacc65183b4b2cf7a064c8d8c7846c45fc56c5dd72392dce1ea3117a3808 config-baseline.json +d8c18c4bd1091dbc74865e1b1fb1bf5c78db12736373a2b4e5a866932b116f86 config-baseline.core.json 07963db49502132f26db396c56b36e018b110e6c55a68b3cb012d3ec96f43901 config-baseline.channel.json -74b74cb18ac37c0acaa765f398f1f9edbcee4c43567f02d45c89598a1e13afb4 config-baseline.plugin.json +f14d1d609ce93893f3bbd6c533251d30328f4deed5cf06da7cb2c9208147dc7a config-baseline.plugin.json diff --git a/docs/gateway/configuration-examples.md b/docs/gateway/configuration-examples.md index 9d31945e0ab..29d47401a81 100644 --- a/docs/gateway/configuration-examples.md +++ b/docs/gateway/configuration-examples.md @@ -369,7 +369,7 @@ Save to `~/.openclaw/openclaw.json` and you can DM the bot from that number. cron: { enabled: true, store: "~/.openclaw/cron/cron.json", - maxConcurrentRuns: 2, + maxConcurrentRuns: 2, // cron dispatch + isolated cron agent-turn execution sessionRetention: "24h", runLog: { maxBytes: "2mb", diff --git a/docs/gateway/configuration-reference.md b/docs/gateway/configuration-reference.md index a7971dd11e3..8ebd9aad399 100644 --- a/docs/gateway/configuration-reference.md +++ b/docs/gateway/configuration-reference.md @@ -1079,7 +1079,7 @@ Current builds no longer include the TCP bridge. Nodes connect over the Gateway { cron: { enabled: true, - maxConcurrentRuns: 2, + maxConcurrentRuns: 2, // cron dispatch + isolated cron agent-turn execution webhook: "https://example.invalid/legacy", // deprecated fallback for stored notify:true jobs webhookToken: "replace-with-dedicated-token", // optional bearer token for outbound webhook auth sessionRetention: "24h", // duration string or false diff --git a/docs/gateway/configuration.md b/docs/gateway/configuration.md index 2d944edb481..89c15a41233 100644 --- a/docs/gateway/configuration.md +++ b/docs/gateway/configuration.md @@ -397,7 +397,7 @@ cannot roll back unrelated user settings. { cron: { enabled: true, - maxConcurrentRuns: 2, + maxConcurrentRuns: 2, // cron dispatch + isolated cron agent-turn execution sessionRetention: "24h", runLog: { maxBytes: "2mb", diff --git a/src/config/schema.base.generated.ts b/src/config/schema.base.generated.ts index 9c690928cb3..53ed4f5b568 100644 --- a/src/config/schema.base.generated.ts +++ b/src/config/schema.base.generated.ts @@ -20719,7 +20719,7 @@ export const GENERATED_BASE_CONFIG_SCHEMA: BaseConfigSchemaResponse = { maximum: 9007199254740991, title: "Cron Max Concurrent Runs", description: - "Limits how many cron jobs can execute at the same time when multiple schedules fire together. Use lower values to protect CPU/memory under heavy automation load, or raise carefully for higher throughput.", + "Limits how many cron jobs can execute at the same time when multiple schedules fire together, including isolated agent-turn LLM execution on the dedicated cron-nested lane. Use lower values to protect CPU/memory under heavy automation load, or raise carefully for higher throughput.", }, retry: { type: "object", @@ -27466,7 +27466,7 @@ export const GENERATED_BASE_CONFIG_SCHEMA: BaseConfigSchemaResponse = { }, "cron.maxConcurrentRuns": { label: "Cron Max Concurrent Runs", - help: "Limits how many cron jobs can execute at the same time when multiple schedules fire together. Use lower values to protect CPU/memory under heavy automation load, or raise carefully for higher throughput.", + help: "Limits how many cron jobs can execute at the same time when multiple schedules fire together, including isolated agent-turn LLM execution on the dedicated cron-nested lane. Use lower values to protect CPU/memory under heavy automation load, or raise carefully for higher throughput.", tags: ["performance", "automation"], }, "cron.retry": { diff --git a/src/config/schema.help.ts b/src/config/schema.help.ts index a5518dc24ed..8cfc9f0dc14 100644 --- a/src/config/schema.help.ts +++ b/src/config/schema.help.ts @@ -1433,7 +1433,7 @@ export const FIELD_HELP: Record = { "cron.store": "Path to the cron job store file used to persist scheduled jobs across restarts. Set an explicit path only when you need custom storage layout, backups, or mounted volumes.", "cron.maxConcurrentRuns": - "Limits how many cron jobs can execute at the same time when multiple schedules fire together. Use lower values to protect CPU/memory under heavy automation load, or raise carefully for higher throughput.", + "Limits how many cron jobs can execute at the same time when multiple schedules fire together, including isolated agent-turn LLM execution on the dedicated cron-nested lane. Use lower values to protect CPU/memory under heavy automation load, or raise carefully for higher throughput.", "cron.retry": "Overrides the default retry policy for one-shot jobs when they fail with transient errors (rate limit, overloaded, network, server_error). Omit to use defaults: maxAttempts 3, backoffMs [30000, 60000, 300000], retry all transient types.", "cron.retry.maxAttempts":