openclaw/docs/tools
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
..
acp-agents-setup.md refactor(config): config-surface reduction tranche 3 — product consolidations (review request) (#111527) 2026-07-21 20:28:43 -07:00
acp-agents.md refactor(config): config-surface reduction tranche 3 — product consolidations (review request) (#111527) 2026-07-21 20:28:43 -07:00
agent-send.md refactor(cli)!: remove automatic gateway→embedded fallback from openclaw agent (#112074) 2026-07-20 23:30:37 -07:00
apply-patch.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
ask-user.md fix(qa): align ask-user protocol shape (#111429) 2026-07-19 07:03:47 -07:00
brave-search.md refactor: remove expired plugin compatibility surfaces (#111451) 2026-07-19 11:04:48 -07:00
browser-control.md feat(browser): extract action — answer page questions via a bounded sub-model call (#113861) 2026-07-25 15:13:32 -07:00
browser-linux-troubleshooting.md refactor(config): purge numeric tuning knobs behind built-in defaults (#111382) 2026-07-19 07:35:45 -07:00
browser-login.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
browser-wsl2-windows-remote-cdp-troubleshooting.md refactor(config): purge numeric tuning knobs behind built-in defaults (#111382) 2026-07-19 07:35:45 -07:00
browser.md feat(browser): extract action — answer page questions via a bounded sub-model call (#113861) 2026-07-25 15:13:32 -07:00
btw.md refactor(gateway): remove dead sessions.observer.ask rpc (#113791) 2026-07-25 14:44:02 -07:00
capability-cookbook.md docs: consolidate moved docs pages 2026-05-05 17:38:21 +01:00
chrome-extension.md feat(browser): send pages to OpenClaw from the Chrome extension (#111158) 2026-07-19 01:07:28 -07:00
clawhub.md docs: add dedicated ClawHub docs tab (#79159) 2026-05-07 18:55:08 -07:00
code-execution.md fix(xai): require consent for cross-provider billed tools (#97629) 2026-07-10 05:30:23 +01:00
code-mode.md chore(scripts): remove resolved investigation tools and orphans (#113532) 2026-07-25 02:47:40 -07:00
creating-skills.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
diffs.md refactor(diffs): move ephemeral artifacts to SQLite (#109328) 2026-07-16 16:47:19 -07:00
duckduckgo-search.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
elevated.md refactor(config): config-surface reduction tranche 3 — product consolidations (review request) (#111527) 2026-07-21 20:28:43 -07:00
exa-search.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
exec-approvals-advanced.md refactor(config): config-surface reduction tranche 3 — product consolidations (review request) (#111527) 2026-07-21 20:28:43 -07:00
exec-approvals.md fix: reusable exec approvals apply to approved arguments (#112946) 2026-07-24 15:38:38 +05:30
exec.md refactor(config): config-surface reduction tranche 3 — product consolidations (review request) (#111527) 2026-07-21 20:28:43 -07:00
firecrawl.md feat(firecrawl): add keyless Firecrawl Search (Free) provider + richer firecrawl_search options (#97078) 2026-07-12 21:04:43 -07:00
gemini-search.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
goal.md fix(goals): route completion wakes to live session (#104265) 2026-07-21 13:58:16 -07:00
grok-search.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
image-generation.md refactor(config): config-surface reduction tranche 3 — product consolidations (review request) (#111527) 2026-07-21 20:28:43 -07:00
index.md refactor(config): config-surface reduction tranche 3 — product consolidations (review request) (#111527) 2026-07-21 20:28:43 -07:00
kimi-search.md refactor: remove expired plugin compatibility surfaces (#111451) 2026-07-19 11:04:48 -07:00
llm-task.md chore: migrate active GPT-5.5 references to GPT-5.6 (#104452) 2026-07-11 06:30:57 -07:00
lobster.md docs(lobster): enumerate injected workflow env vars and clarify step-output access (#108622) 2026-07-16 05:05:21 -07:00
loop-detection.md refactor(config): config-surface reduction tranche 3 — product consolidations (review request) (#111527) 2026-07-21 20:28:43 -07:00
media-overview.md refactor(config): config-surface reduction tranche 3 — product consolidations (review request) (#111527) 2026-07-21 20:28:43 -07:00
minimax-search.md refactor: remove expired plugin compatibility surfaces (#111451) 2026-07-19 11:04:48 -07:00
multi-agent-sandbox-tools.md refactor(config): config-surface reduction tranche 3 — product consolidations (review request) (#111527) 2026-07-21 20:28:43 -07:00
music-generation.md refactor(config): config-surface reduction tranche 3 — product consolidations (review request) (#111527) 2026-07-21 20:28:43 -07:00
ollama-search.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
parallel-search.md chore: migrate active GPT-5.5 references to GPT-5.6 (#104452) 2026-07-11 06:30:57 -07:00
pdf.md refactor(config): config-surface reduction tranche 3 — product consolidations (review request) (#111527) 2026-07-21 20:28:43 -07:00
permission-modes.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
perplexity-search.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
plugin.md fix: gateway boots when a configured plugin payload is broken (#110239) 2026-07-18 03:50:50 +01:00
reactions.md fix(channels): honor configured read target policies (#99905) 2026-07-10 22:29:37 -05:00
screen.md docs: align interactive client behavior (#111047) 2026-07-18 17:00:14 -07:00
searxng-search.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
self-learning.md fix: default skill workshop approvals to auto (#107690) 2026-07-14 18:31:51 +01:00
show-widget.md feat(linux): render widgets in Quick Chat (#111933) 2026-07-20 11:56:03 -07:00
skill-workshop.md fix: default skill workshop approvals to auto (#107690) 2026-07-14 18:31:51 +01:00
skills-config.md refactor(config): retire redundant settings (#113174) 2026-07-23 17:45:02 -07:00
skills.md feat(skills): support external skills.sh references (#112751) 2026-07-25 08:24:34 -05:00
slash-commands.md feat: session rail with read-only session companion in Control UI chat (#113698) 2026-07-25 08:14:32 -07:00
steer.md docs: align interactive client behavior (#111047) 2026-07-18 17:00:14 -07:00
subagents.md fix(gateway): stop showing retired HEARTBEAT.md in the agent files editor (#113621) 2026-07-25 04:58:31 -07:00
swarm.md feat(native): show Swarm progress in chat (#113850) 2026-07-25 15:11:19 -07:00
tavily.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
thinking.md docs(heartbeat): align retired config options with fixed runtime policies (#113455) 2026-07-25 06:52:27 -07:00
tokenjuice.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
tool-search.md docs: retire config keys that strict validation rejects (#113956) 2026-07-25 18:24:02 -07:00
trajectory.md refactor: flip sessions and transcripts to sqlite storage (#98236) 2026-07-11 14:50:37 -07:00
tts.md refactor(config): config-surface reduction tranche 3 — product consolidations (review request) (#111527) 2026-07-21 20:28:43 -07:00
video-generation.md refactor(config): config-surface reduction tranche 3 — product consolidations (review request) (#111527) 2026-07-21 20:28:43 -07:00
web-fetch.md improve(agents): exact web_fetch output contract with cleaned result shape (#110223) 2026-07-18 03:28:29 +01:00
web.md refactor: remove expired plugin compatibility surfaces (#111451) 2026-07-19 11:04:48 -07:00