openclaw/docs/reference
Peter Steinberger 1e20cc814e
docs: retire config keys that strict validation rejects (#113956)
* docs: correct retired cron/audit config keys, cron failure-alert default, memory recall default, and tool-search telemetry claims

- configuration-reference: cron block documented cron.webhook and cron.failureDestination, both retired by the config-surface reduction tranches (58452de711, edecdbd05e); the cron schema is strict so a copied snippet is rejected. Document only the live keys and note the doctor --fix migrations.
- configuration-reference: root-level audit block is retired; canonical path is logging.audit (src/config/zod-schema.root-shape.ts).
- configuration-reference: cron.failureAlert.after default is 2, not 3 (src/cron/service/failure-alerts.ts).
- memory-config: rememberAcrossConversations defaults on for personal installs (packages/memory-host-sdk/src/host/config-utils.ts), matching the canonical table earlier in the page.
- tool-search: telemetry records catalogSize, per-source counts, and search/describe/call counts, and only on tool_search_code results. No byte accounting exists in the runtime.

* docs: retire remaining references to removed cron, audit, and logging config keys

Sweep follow-up to the previous commit, covering the same bug class in the pages that still contradicted it.

- cron-jobs/cli-cron: global cron.failureDestination is retired; the destination fields now live on cron.failureAlert (src/config/zod-schema.root-shape.ts, merged by legacy-config-migrations.runtime.retired.ts:379). Per-job delivery.failureDestination bullets left intact.
- gateway/audit, cli/audit, gateway/protocol: root-level audit.* is retired; canonical path is logging.audit.*.
- logging: logging.redactSensitive is retired (dead-config-keys.test.ts:198; removed by legacy-config-migrations.runtime.tier-eval.ts:12). resolveConfigRedaction hardcodes DEFAULT_REDACT_MODE = tools, so redaction is unconditional. Also documented that redactPatterns replaces the defaults on the log path (redact.ts:419) while tool payloads always merge them.
- logging: consoleStyle accepts only pretty|json (zod-schema.root-shape.ts:106); compact remains the automatic non-TTY rendering style (logging/console.ts:40) but is no longer settable, and doctor maps a stored one to pretty.
- security: security --fix no longer touches redaction and the logging.redact_off audit check is retired (src/security/audit-loopback-logging.test.ts asserts it never fires).

* chore(docs): regenerate docs map after retired-key cleanup
2026-07-25 18:24:02 -07:00
..
templates fix(gateway): stop showing retired HEARTBEAT.md in the agent files editor (#113621) 2026-07-25 04:58:31 -07:00
AGENTS.default.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
api-usage-costs.md refactor(config): config-surface reduction tranche 3 — product consolidations (review request) (#111527) 2026-07-21 20:28:43 -07:00
credits.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
database-schemas.md refactor(sqlite): drop write-only verification history and share the terminal-open latch (#110532) 2026-07-18 09:18:40 +01:00
device-models.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
full-release-validation.md docs(release): document complete extended-stable workflow (#112524) 2026-07-23 10:48:48 +09:00
memory-config.md docs: retire config keys that strict validation rejects (#113956) 2026-07-25 18:24:02 -07:00
openclaw-ai.md refactor: extract reusable AI runtime package (#99059) 2026-07-05 01:56:40 -04:00
path3-live-sqlite-e2e-harness.md refactor: flip sessions and transcripts to sqlite storage (#98236) 2026-07-11 14:50:37 -07:00
prompt-caching.md fix(gateway): stop showing retired HEARTBEAT.md in the agent files editor (#113621) 2026-07-25 04:58:31 -07:00
pull-request-review-flow.md docs: explain pull request automation workflow (#101748) 2026-07-16 20:29:15 -07:00
release-performance-sweep.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
RELEASING.md docs(release): document complete extended-stable workflow (#112524) 2026-07-23 10:48:48 +09:00
rich-output-protocol.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
rpc.md feat(channels): add channel-owned setup contracts (#112176) 2026-07-22 19:57:42 -04:00
secret-placeholder-conventions.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
secretref-credential-surface.md refactor(config): config-surface reduction tranche 3 — product consolidations (review request) (#111527) 2026-07-21 20:28:43 -07:00
secretref-user-supplied-credentials-matrix.json refactor(config): config-surface reduction tranche 3 — product consolidations (review request) (#111527) 2026-07-21 20:28:43 -07:00
session-management-compaction.md refactor(config): config-surface reduction tranche 3 — product consolidations (review request) (#111527) 2026-07-21 20:28:43 -07:00
test.md fix: avoid remote boxes for focused validation (#107166) 2026-07-14 00:53:17 -07:00
token-use.md fix(gateway): stop showing retired HEARTBEAT.md in the agent files editor (#113621) 2026-07-25 04:58:31 -07:00
transcript-hygiene.md fix(agents): drop orphaned thinking blocks when NO_REPLY text leaves an assistant message with only thinking content (#99620) (#99772) 2026-07-21 00:34:15 -07:00
wizard.md feat(channels): add channel-owned setup contracts (#112176) 2026-07-22 19:57:42 -04:00