docs: document cacheRetention parameter#6270
Conversation
| - **OAuth or setup-token** profiles: enable `cache-ttl` pruning and set heartbeat to `1h`. | ||
| - **API key** profiles: enable `cache-ttl` pruning, set heartbeat to `30m`, and default `cacheControlTtl` to `1h` on Anthropic models. | ||
| - **API key** profiles: enable `cache-ttl` pruning, set heartbeat to `30m`, and default `cacheRetention` to `"short"` on Anthropic models. | ||
| - If you set any of these values explicitly, OpenClaw does **not** override them. |
There was a problem hiding this comment.
[P2] Mixed quoting style for cacheRetention value. Here cacheRetention is shown as \"short\" (with quotes inside backticks), while other docs/examples in this PR use cacheRetention: "short" or just "short". Consider standardizing to avoid users copy/pasting inconsistent snippets.
Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!
Prompt To Fix With AI
This is a comment left during a code review.
Path: docs/concepts/session-pruning.md
Line: 23:25
Comment:
[P2] Mixed quoting style for `cacheRetention` value. Here `cacheRetention` is shown as ``\"short\"`` (with quotes inside backticks), while other docs/examples in this PR use `cacheRetention: "short"` or just `"short"`. Consider standardizing to avoid users copy/pasting inconsistent snippets.
<sub>Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!</sub>
How can I resolve this? If you propose a fix, please make it concise.
docs/providers/anthropic.md
Outdated
| | `"short"` | 5 minutes | Default for API Key auth | | ||
| | `"long"` | 1 hour | Extended cache (requires beta flag) | |
There was a problem hiding this comment.
[P2] Table uses backticked JSON strings (e.g. "none") instead of plain values. Since these are enum-like config values, using none/short/long (without embedded quotes) is usually clearer and matches how the later JSON5 example is written (e.g. cacheRetention: "long").
Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!
Prompt To Fix With AI
This is a comment left during a code review.
Path: docs/providers/anthropic.md
Line: 49:50
Comment:
[P2] Table uses backticked JSON strings (e.g. `"none"`) instead of plain values. Since these are enum-like config values, using `none`/`short`/`long` (without embedded quotes) is usually clearer and matches how the later JSON5 example is written (e.g. `cacheRetention: "long"`).
<sub>Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!</sub>
How can I resolve this? If you propose a fix, please make it concise.* docs: document cacheRetention parameter (openclaw#6240) * docs: standardize cacheRetention value quoting style * style: format anthropic.md table * Docs: align cacheRetention inline example --------- Co-authored-by: Sebastian <sebslight@gmail.com>
* docs: document cacheRetention parameter (openclaw#6240) * docs: standardize cacheRetention value quoting style * style: format anthropic.md table * Docs: align cacheRetention inline example --------- Co-authored-by: Sebastian <sebslight@gmail.com>
* docs: document cacheRetention parameter (openclaw#6240) * docs: standardize cacheRetention value quoting style * style: format anthropic.md table * Docs: align cacheRetention inline example --------- Co-authored-by: Sebastian <sebslight@gmail.com>
* docs: document cacheRetention parameter (openclaw#6240) * docs: standardize cacheRetention value quoting style * style: format anthropic.md table * Docs: align cacheRetention inline example --------- Co-authored-by: Sebastian <sebslight@gmail.com>
* docs: document cacheRetention parameter (openclaw#6240) * docs: standardize cacheRetention value quoting style * style: format anthropic.md table * Docs: align cacheRetention inline example --------- Co-authored-by: Sebastian <sebslight@gmail.com>
* docs: document cacheRetention parameter (openclaw#6240) * docs: standardize cacheRetention value quoting style * style: format anthropic.md table * Docs: align cacheRetention inline example --------- Co-authored-by: Sebastian <sebslight@gmail.com> (cherry picked from commit 7a8a39a) # Conflicts: # docs/concepts/session-pruning.md # docs/providers/anthropic.md
* docs: document cacheRetention parameter (openclaw#6240) * docs: standardize cacheRetention value quoting style * style: format anthropic.md table * Docs: align cacheRetention inline example --------- Co-authored-by: Sebastian <sebslight@gmail.com>
* docs: document cacheRetention parameter (openclaw#6240) * docs: standardize cacheRetention value quoting style * style: format anthropic.md table * Docs: align cacheRetention inline example --------- Co-authored-by: Sebastian <sebslight@gmail.com>
* docs: update changelog for mention patterns (#3303) (thanks @HirokiKobayashi-R) (cherry picked from commit 16a5549ec0b64528f6513627512abafdabe41e39) * chore: update clawtributors (add @HirokiKobayashi-R) (cherry picked from commit 34291321b4fa2b5aea5e12e93cab2cf15cc94cb9) * docs(changelog): rewrite 2026.1.29 notes (cherry picked from commit 51520601210380db154393179ecdb004fd4c23e7) # Conflicts: # CHANGELOG.md * chore: update clawtributors (cherry picked from commit c9fe062824cabdf919cfbedc1b915375b5e684d1) * docs: move deepwiki link (cherry picked from commit bf6ec64fd9ca20a6a7f78465e404f397d8c7863d) # Conflicts: # README.md * Add files via upload (cherry picked from commit ddad65588f709ae7375b6292f1f27146e01f026f) * Update README with responsive logo for dark mode (cherry picked from commit 4de0bae45a29ddbe419325f64ee369ab00b546d3) # Conflicts: # README.md * Update logo and contributor name in docs Replaced the static image with a responsive logo using the <picture> element for light/dark mode support. Updated contributor name from 'Clawd' to 'Molty'. (cherry picked from commit 12e8a8410fc0be2229f2193551d1ac5f1a2a2ee6) # Conflicts: # docs/index.md * docs: reorder 2026.1.29 changelog (cherry picked from commit 23c424899c4669caff57b18b9be3a9c2f3f13a99) # Conflicts: # CHANGELOG.md * chore: release 2026.1.29 (cherry picked from commit 62e4ad23d3f6cb11ea779df76f10b5597b784402) # Conflicts: # docs/index.md # extensions/bluebubbles/package.json # extensions/copilot-proxy/package.json # extensions/diagnostics-otel/package.json # extensions/discord/package.json # extensions/google-antigravity-auth/package.json # extensions/google-gemini-cli-auth/package.json # extensions/googlechat/package.json # extensions/imessage/package.json # extensions/line/package.json # extensions/llm-task/package.json # extensions/lobster/package.json # extensions/matrix/package.json # extensions/mattermost/package.json # extensions/memory-core/package.json # extensions/memory-lancedb/package.json # extensions/msteams/package.json # extensions/nextcloud-talk/package.json # extensions/nostr/package.json # extensions/open-prose/package.json # extensions/signal/package.json # extensions/slack/package.json # extensions/telegram/package.json # extensions/tlon/package.json # extensions/twitch/package.json # extensions/voice-call/package.json # extensions/whatsapp/package.json # extensions/zalo/package.json # extensions/zalouser/package.json # package.json * Update index.md (cherry picked from commit 613724c26e831146dacc48e2dc0b92fbe9405ddd) # Conflicts: # docs/index.md * docs: move WhatsApp image below dashboard (cherry picked from commit 87267fad4f0a84c9adbadd3fd05e3dde9437fbe9) * docs: update lore with final form (cherry picked from commit 6af205a13adfec1fd1eb27d2f3d3546b0b4e8f86) # Conflicts: # docs/start/lore.md * chore: remove legacy clawdhub files (cherry picked from commit 192a6ee8700615da107fcd4c52e22a1fdbe1c117) # Conflicts: # docs/tools/clawdhub.md # skills/clawdhub/SKILL.md * Fix typo in agent.md from p-mono to pi-mono (cherry picked from commit 9a1b4409680fd6a440d831e272473e58e2921c20) # Conflicts: # docs/concepts/agent.md * docs: use straight quotes for code terms in installer guide (cherry picked from commit 23f0efbf09b1487d7e2dc06b25a22cd68cdb6aef) # Conflicts: # docs/install/installer.md * docs: fix missing apostrophes in FAQ headers (cherry picked from commit 49a3e3795ae07d6de807cf7630e3c576a41df30b) # Conflicts: # docs/help/faq.md * docs: Internal linking of channel pages (cherry picked from commit 9334dd8017d32cfed1acdfa331e3b7783a84c7bc) # Conflicts: # docs/start/wizard.md * docs: fix GitHub branding capitalization (cherry picked from commit 7c96bde3b3db74dcf57bff0138eefd5d03ba1d08) * docs: update remaining clawdbot/moltbot references to openclaw - .pre-commit-config.yaml: update comment header - AGENTS.md: update plugin-sdk import path and state directory paths - skills/bluebubbles/SKILL.md: update plugin-sdk import reference - skills/discord/SKILL.md: update example sticker name (cherry picked from commit 0175cedf0e07b6528e2400d3d071fb36e9f9f050) # Conflicts: # skills/discord/SKILL.md * Update deployment link in railway documentation (cherry picked from commit 2f0592dbc65b4d17166941ecc05b016afa2e77c4) # Conflicts: # docs/railway.mdx * feat(ui): refresh session list after chat commands in Web UI (cherry picked from commit 0b7aa8cf1d2a318795ee23dc1ef10fc9873a365f) # Conflicts: # ui/src/ui/app-chat.ts # ui/src/ui/app-gateway.ts # ui/src/ui/app.ts * Fix typo from 'p-mono' to 'pi-mono' in agent.md (cherry picked from commit 97895a02393973483e07113e9651c93dabeeeae8) # Conflicts: # docs/concepts/agent.md * docs: add pi and pi-dev documentation (cherry picked from commit 9cb5e22861027c098e0367d3b68c9f763bbcc4f8) * chore: add .pi folder (cherry picked from commit 4b1956ab497379b6fcdf589f7cd87247b7df0e89) * chore: remove changelog section from pr.md prompt (cherry picked from commit cc366f4baa94a5baa0b1260e6cf9e31a7d1853f1) * Add prompt injection attacks to out of scope section (cherry picked from commit a767c584c7b6f5c110f35e263449264d3db49583) # Conflicts: # SECURITY.md * Docs: add actionable cron quick start (#5446) * Docs: add cron quick start examples * Docs: de-duplicate cron tool-call examples * Docs: fix cron code block fences (cherry picked from commit 75093ebe1cac1276dab5b5691c421df3e8f51ace) # Conflicts: # docs/automation/cron-jobs.md * Docs: fix index logo dark mode (#5474) (cherry picked from commit 8978d166592b867f1328360d61627bdf395c1d56) # Conflicts: # docs/index.md * docs: start 2026.1.31 changelog (cherry picked from commit 83e64c1ac9893804645148f781889b23e5bbd12b) # Conflicts: # CHANGELOG.md * docs: format cron jobs doc (cherry picked from commit 57ea4e88972d957903c10c567f3a67797304c17e) * fix(lobster): block arbitrary exec via lobsterPath/cwd (GHSA-4mhr-g7xj-cg8j) (#5335) * fix(lobster): prevent arbitrary exec via lobsterPath/cwd * fix(lobster): harden lobsterPath errors + normalize cwd sandboxing * fix(lobster): ignore tool-provided lobsterPath; validate + use plugin config * fix(lobster): use plugin config lobsterPath + add tests (#5335) (thanks @vignesh07) * fix(lobster): make Windows spawn fallback handle ENOENT (#5335) (thanks @vignesh07) --------- Co-authored-by: Tyler Yust <TYTYYUST@YAHOO.COM> (cherry picked from commit 1295b67057b5fc341bdd0f41d0130bc9b09470a7) # Conflicts: # CHANGELOG.md # extensions/lobster/src/lobster-tool.test.ts # extensions/lobster/src/lobster-tool.ts * Docs: add nav titles across docs (#5689) (cherry picked from commit abcaa8c7a9f3a28b4845347acddafe6076362a9a) # Conflicts: # docs/automation/webhook.md # docs/channels/twitch.md # docs/cli/dns.md # docs/cli/docs.md # docs/debug/node-issue.md # docs/gateway/configuration-examples.md # docs/help/faq.md # docs/index.md # docs/platforms/digitalocean.md # docs/platforms/hetzner.md # docs/platforms/oracle.md # docs/providers/github-copilot.md # docs/providers/openrouter.md # docs/providers/xiaomi.md # docs/start/pairing.md # docs/tools/clawdhub.md # docs/tools/index.md * Docs: point nav groups at index pages (#5694) (cherry picked from commit e6c38e078a9d148b318c71ee95d08c40d677aadd) # Conflicts: # docs/docs.json * fix(docs): update Twitter URLs to X for consistency (cherry picked from commit 9297ea48e51e5850f6b944e78c735d3334b8d12e) * fix(docs): use canonical openclaw.ai domain instead of openclaw.bot (cherry picked from commit 7a2c4d3cf19bbb7168ce956b0ce1f0ca51d600d5) # Conflicts: # docs/gateway/troubleshooting.md # docs/help/faq.md # docs/help/troubleshooting.md # docs/install/index.md # docs/install/installer.md # docs/install/uninstall.md # docs/install/updating.md # docs/platforms/digitalocean.md # docs/platforms/exe-dev.md # docs/platforms/oracle.md # docs/platforms/raspberry-pi.md # docs/reference/RELEASING.md # docs/start/getting-started.md * fix(docs): update MiniMax plugin URL from legacy moltbot org (cherry picked from commit bce8c0eb1276bb81b96602369295e2309fa8479b) # Conflicts: # docs/providers/minimax.md * fix(docs): remove invalid channels. prefix from Discord URL (cherry picked from commit a10603f9f092f9ef74a31f08b200363cc260a8f6) * Docs: mention weak gateway auth tokens (cherry picked from commit 66e33abd7b3f898610347fc95a9dec7a34687ce4) * docs: fix Venice AI typo (Venius → Venice) Co-authored-by: jonisjongithub <jonisjongithub@users.noreply.github.com> Co-authored-by: Clawdbot <bot@clawd.bot> (cherry picked from commit 96c9ffdedcb40b6027f2a52d6c5c324905c22f6c) * feat: code (cherry picked from commit b2aff036addc933de0405afad9a11e25783dd72c) # Conflicts: # extensions/minimax-portal-auth/index.ts * Docs: note MiniMax OAuth updates (#5402) (thanks @Maosghoul) (cherry picked from commit 73c405f74aa82cf035431ce28654b4f4239d37fd) # Conflicts: # CHANGELOG.md * docs: document cacheRetention parameter (#6270) * docs: document cacheRetention parameter (#6240) * docs: standardize cacheRetention value quoting style * style: format anthropic.md table * Docs: align cacheRetention inline example --------- Co-authored-by: Sebastian <sebslight@gmail.com> (cherry picked from commit 7a8a39a141086522c609c7b2922ab6c552cc5772) # Conflicts: # docs/concepts/session-pruning.md # docs/providers/anthropic.md * docs: fix anchor link for Google Vertex/Antigravity/Gemini section (#5967) * docs: fix anchor link for Google Vertex/Antigravity/Gemini section * Docs: fix model provider MDX markers --------- Co-authored-by: Sebastian <sebslight@gmail.com> (cherry picked from commit 7fabe03a8bb6689106945a0c81848535ca0522b2) # Conflicts: # docs/concepts/model-providers.md * Docs: fix Moonshot MDX comment marker (#6311) (cherry picked from commit 8582ed4d4f918e2b41e6d76dae4e3cc408fa0ba6) # Conflicts: # docs/providers/moonshot.md * docs(install): add pnpm approve-builds step for global installs (#5663) * docs(install): add pnpm approve-builds step for global installs pnpm requires explicit approval for packages with build scripts. Without running `pnpm approve-builds -g`, openclaw and its dependencies (node-llama-cpp, sharp, protobufjs) won't have their postinstall scripts executed, causing runtime errors. Fixes #5579 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * docs(install): clarify pnpm reinstall step after approve-builds Address review feedback: after running `pnpm approve-builds -g`, users need to re-run the install command for postinstall scripts to actually execute. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com> (cherry picked from commit 3ae049b5012cb61b5f241a5287a9d587369a4736) # Conflicts: # docs/install/index.md * docs(skills): update canvas URL prefix to /__openclaw__/ (#4729) Update remaining __moltbot__ references in canvas skill documentation to match the CANVAS_HOST_PATH constant (/__openclaw__/canvas). (cherry picked from commit 701d43892fa1152a06f472b8ae44f170c99e0492) # Conflicts: # skills/canvas/SKILL.md * Docs: Fix typo in docs/tools/skills.md (#3050) (cherry picked from commit 28a05f994092c52e5e84a66b267b8aa47f592d38) * docs: fix heading numbering and add missing section onboarding.md (#3461) (cherry picked from commit 76211500e81893c300fcec9ab129899b3270a297) * Docs: Direct link to BotFather on Telegram (#4064) * Docs: Direct link to BotFather on Telegram, sparing users from searching and potentially encountering impostors. * Update numbering syntax Update numbering syntax to match PR to latest doc layout. * Docs: add BotFather verification note --------- Co-authored-by: Sebastian <sebslight@gmail.com> (cherry picked from commit 8ff75eaf12b37ff9f65f579454e8a26be28783b0) # Conflicts: # CHANGELOG.md # docs/channels/telegram.md * docs: add device pairing section to Control UI docs (#5003) * docs: add device pairing section to Control UI docs Explains that new browser connections require one-time pairing approval, what error message users will see, and how to approve devices using the CLI. This was a gap in the documentation that caused confusion for users connecting via Tailscale Serve. * docs: clarify Control UI pairing error * docs: clarify device revoke flags --------- Co-authored-by: Lucifer (via OpenClaw) <lucy@neuwirth.cc> Co-authored-by: Sebastian <sebslight@gmail.com> (cherry picked from commit 63b13c7e2fe5bacb17a6a19979c1952be48bd200) * fix(docker): avoid using host port in gateway command (#5110) (thanks @mise42) (cherry picked from commit bc5b0c82acc9301e5acf93c80f3d56f3fc87ab50) # Conflicts: # docker-compose.yml * Docs: add Mintlify language navigation (cherry picked from commit 3cf35b0710216e50fb9545d7a963a861447fa00e) # Conflicts: # docs/docs.json * docs: add Mintlify language navigation (#6416) (thanks @joshp123) (cherry picked from commit 6453f5c395a521b576444f5bce2104059c38fd33) * fix(skill): update session-logs paths from .clawdbot to .openclaw (#4502) Co-authored-by: Jarvis <jarvis@openclaw.ai> Co-authored-by: CLAWDINATOR Bot <clawdinator[bot]@users.noreply.github.com> Co-authored-by: Shadow <shadow@openclaw.ai> (cherry picked from commit d3e53eaf276077530679901ebae00d3e94f2eb78) # Conflicts: # CHANGELOG.md * Docs: add zh-CN titles (cherry picked from commit 964b14d59c8fa7fe9cd82591843d7750e5c0a3ac) # Conflicts: # docs/zh-CN/index.md # docs/zh-CN/start/getting-started.md # docs/zh-CN/start/wizard.md * docs: add zh-CN titles (#6487) (thanks @joshp123) (cherry picked from commit 17287bc8d01b12a293e0452a76b1c117dd1e42c1) * docs(discord): clarify exec approvals UI (#6550) * docs(discord): clarify exec approvals UI * Add link for slash command in Discord exec approvals Updated documentation to include a link for the slash command used in Discord exec approvals. * docs(discord): move exec approvals note * docs(discord): document exec approvals config * docs(discord): reorder exec approvals config --------- Co-authored-by: Luke K (pr-0f3t) <2609441+lc0rp@users.noreply.github.com> (cherry picked from commit 8f366babe4d427523b16203c2c351550cf6f6b18) * Docs: clarify Moonshot endpoints (#4763) Co-authored-by: hansbbans <hansbbans@users.noreply.github.com> (cherry picked from commit a863ac9862f595c77cde31dc0c2d60664ed3da29) * Docs: update clawtributors (cherry picked from commit 6c03fe1a4d06c80cf4f456e3c7b99151b6fd406c) # Conflicts: # README.md * chore: fix Pi prompt template argument syntax (#6543) - Fix @1 -> $1 in landpr.md - Fix $@ -> $1 in reviewpr.md - Remove stray /reviewpr line from reviewpr.md - Delete old pr.md (replaced by reviewpr.md and landpr.md) (cherry picked from commit 395810a60b06817e15d748f8f2d7dbafe6591a59) # Conflicts: # .pi/prompts/pr.md * chore: oxfmt fixes (cherry picked from commit 443ee26af3f45272df545af2d4ccccaa1feaea0b) # Conflicts: # docker-compose.yml # docs/channels/telegram.md # docs/concepts/model-providers.md # docs/providers/moonshot.md # skills/canvas/SKILL.md * docs: preserve moonshot sync markers (cherry picked from commit 92803facf6c1bc3b038c29db8505f0f5da58ed1e) # Conflicts: # CHANGELOG.md # docs/concepts/model-providers.md # docs/providers/moonshot.md * docs: improve exe.dev setup instructions (#4675) * improve exe.dev setup instructions 1. Fix device approval command 2. Clarify where Gateway token can be found * Update device approval instructions in exe-dev.md Clarify instructions for approving devices in OpenClaw. (cherry picked from commit d54605bd82fb932c7172a2577c0f12c9b8cb86b4) # Conflicts: # docs/platforms/exe-dev.md * chore: update changelog and relay formatting (cherry picked from commit 238200f6527ded4e747b88ace131c707a7931e64) # Conflicts: # CHANGELOG.md * chore: update changelog (cherry picked from commit a68e32d95b8e88c3d859dc78cb4d0f177209f997) # Conflicts: # CHANGELOG.md * chore: expand changelog (cherry picked from commit 1968a4b7d24b101e78f23df54f25ad991f90ea9b) # Conflicts: # CHANGELOG.md * chore: trim docs changelog (cherry picked from commit 99346314f58860dca5d53747f4b40e128b658c1e) # Conflicts: # CHANGELOG.md * chore: add TLS 1.3 minimum changelog (#5970) (thanks @loganaden) (cherry picked from commit 92112a61db519296a7258d508677aa6c49f9a558) # Conflicts: # CHANGELOG.md * fix(twitch): enforce allowFrom allowlist (cherry picked from commit 8c7901c984866a776eb59662dc9d8b028de4f0d0) # Conflicts: # CHANGELOG.md # docs/channels/twitch.md * Docs: clarify node host SSH tunnel flow Co-authored-by: Dmytro Semchuk <x0m4ek@users.noreply.github.com> (cherry picked from commit 63c9fac9fca850b82dea603686691844bb587768) # Conflicts: # docs/nodes/index.md * Docs: update clawtributors (cherry picked from commit 0fa55ed2b4ec3d55b282332e63766007cc69420d) # Conflicts: # README.md * chore: Add `pnpm check` for fast repo checks. (cherry picked from commit 902f96805654a316ec24f9f8c95d5b659a063fee) # Conflicts: # AGENTS.md # CONTRIBUTING.md # docs/reference/RELEASING.md # docs/testing.md # package.json * docs: add ClawHub registry overview (cherry picked from commit 4682c2e3e20cd9388077b90474780077094d4bf5) * docs: merge 2026.2.2 changelog into 2026.2.1 (cherry picked from commit d5f6caba3fbf6a2b50de8e4bcc0bc6906d4c53cd) # Conflicts: # CHANGELOG.md * docs: clarify docker power-user setup (cherry picked from commit be9a2fb134182a4197d65989bbfaa7f54d6d3ae6) * docs: add changelog entry for plugin install hardening (cherry picked from commit f6d98a908af82437e823c15cc20d4feafbd005da) # Conflicts: # CHANGELOG.md * Docs: expand ClawHub overview (cherry picked from commit 385e66cbd52b93458003635d39eb289b798c4715) # Conflicts: # docs/tools/clawdhub.md * docs: fold 2026.2.2 into 2026.2.1 (cherry picked from commit 8b64705e059ace205714fe7a55babbcab3b24e9e) # Conflicts: # CHANGELOG.md * docs: update 2026.2.1 changelog (cherry picked from commit ed4529e24673fb19ea506bb04b2c6d3deed6a451) # Conflicts: # CHANGELOG.md * docs: note docker allow-unconfigured behavior (cherry picked from commit d134a8c7f3e20e304e4ca71d394752f27cfbc019) # Conflicts: # docs/install/docker.md * Docs: add zh-CN translations (cherry picked from commit 149dc7c4e76f2b264cd714c95b3e5ee399db3092) * Docs: fix zh-CN template time wording What: replace <2/<30 text in zh-CN AGENTS template with safe wording Why: avoid MDX parse errors during docs build Tests: not run (doc text change) (cherry picked from commit e9d117d22168f9c05c3cbfd256aab99915f50f22) * docs: add changelog for zh-CN translations (#6619) (thanks @joshp123) (cherry picked from commit 4023b76ed39fe4b999f06137d738cc93cac93bf8) # Conflicts: # CHANGELOG.md * Docs: fix zh-CN ClawHub link What: wrap clawhub.com in an explicit URL link in zh-CN skills doc Why: avoid Mintlify broken-link parser treating trailing punctuation as part of the URL Tests: not run (doc text change) (cherry picked from commit b4cce3ac7a97efccbab400e2f3d4270b14e989ed) * Docs: use explicit ClawHub markdown link What: switch clawhub.com reference to explicit Markdown link syntax Why: MDX parser rejects angle-bracket autolinks Tests: not run (doc text change) (cherry picked from commit 673583a38b8e7e72970b64490685ddf477a70aa6) * Docs: normalize zh-CN terminology + tone What: switch to 你/你的 tone; standardize Skills/Gateway网关/local loopback/私信 wording Why: align zh-CN docs with issue 6995 feedback + idiomatic tech style Tests: pnpm docs:build (cherry picked from commit 5676a6b38de81a13194223ac688e20087d5b74e7) * Docs: expand zh-Hans nav and fix assets (cherry picked from commit e0aa8457c2511e7f9c72a2e912e3307b112fdfb5) * Docs: expand zh-Hans nav (#7242) (thanks @joshp123) (cherry picked from commit 7cee8c2345908fe23c2be0f6bc0e107a579d8b7e) * docs: update changelog for PR #7226 (cherry picked from commit 1b34446bf55bcad9a03e2734c052f6580a5e11c1) * chore: fix formatting and CI (cherry picked from commit 37111435490e3378303c01a1f8dc3ff35211edec) # Conflicts: # ui/src/ui/app-scroll.test.ts # ui/src/ui/app.ts * iOS: wire node services and tests (cherry picked from commit 7b0a0f3dace575c33dafb61d4a13cdef4dd0d64e) # Conflicts: # apps/ios/Sources/Gateway/GatewayConnectionController.swift # apps/ios/Sources/Info.plist # apps/ios/Sources/Model/NodeAppModel.swift # apps/ios/SwiftSources.input.xcfilelist # apps/ios/Tests/GatewayConnectionControllerTests.swift # apps/ios/Tests/NodeAppModelInvokeTests.swift # apps/shared/MoltbotKit/Sources/MoltbotKit/CalendarCommands.swift # apps/shared/MoltbotKit/Sources/MoltbotKit/ContactsCommands.swift # apps/shared/MoltbotKit/Sources/MoltbotKit/DeviceCommands.swift # apps/shared/MoltbotKit/Sources/MoltbotKit/MotionCommands.swift # apps/shared/MoltbotKit/Sources/MoltbotKit/PhotosCommands.swift # apps/shared/MoltbotKit/Sources/MoltbotKit/RemindersCommands.swift * Docs: add zh-CN landing notice + AI image (cherry picked from commit 91e445c2601a55560769169c3d881058f9a7e9dd) * Docs: add zh-CN landing note (#7303) (thanks @joshp123) (cherry picked from commit ea9eed14f8589a58e59b6d5b37849daf0f6c72d0) * Docs: expand zh-CN landing note (cherry picked from commit c83bdb73a4a9a37e6e1de3269b36be671923cf80) * fix(telegram): recover from grammY long-poll timeouts (#7466) (thanks @macmimi23) (cherry picked from commit 561a10c491e28d04deb64b7abd9d89e4456561d0) # Conflicts: # CHANGELOG.md * Docs: fix compatibility shim note (cherry picked from commit 0eae9f456cc978a5fc7d2d66026ebd4283830610) # Conflicts: # CHANGELOG.md # docs/install/updating.md * Changelog: note tool call repair (cherry picked from commit 31face57402fc736bd4fcd474d5d3f20d73daadd) * Docs: simplify transcript hygiene scope (cherry picked from commit 118507953b1f743db7554163f1a434d223cf91ae) # Conflicts: # docs/reference/transcript-hygiene.md * Docs: clarify whats new FAQ heading (#7394) (cherry picked from commit c8af8e95559c2e117426e815dd1a6c5b6816a1d4) # Conflicts: # docs/help/faq.md * chore: fix formatting (cherry picked from commit 7dfa99a6f70c161ca88459be8b419cbfb9b75d7d) # Conflicts: # docs/reference/templates/BOOTSTRAP.md # skills/healthcheck/SKILL.md * chore: fix formatting (cherry picked from commit d5593d647c2f1aed1fef6f938f4d6ae95a503af3) # Conflicts: # docs/reference/templates/BOOTSTRAP.md * Add how to trigger model downloads for qmd in documentation (cherry picked from commit 20578da20407eea19bd725f2d1a8d0dbc186b9d8) # Conflicts: # docs/concepts/memory.md * Docs: align QMD state dir with OpenClaw (cherry picked from commit 11a968f5c30fcc373acab31276a52dba399a5231) * chore: oxfmt (cherry picked from commit 4322ca6f4ac031086abbb3ea9ed2d89368a3216f) # Conflicts: # CHANGELOG.md * docs: finish renaming memory state dir references (cherry picked from commit b37626ce6b1fb7476cc740c40d87090e6fa6367d) # Conflicts: # CHANGELOG.md # docs/concepts/memory.md * chore: update changelog for completion caching (cherry picked from commit 3014a91b0779f7629bf1d91675a99629e2798cb3) * Skills: refine healthcheck guidance (cherry picked from commit fc40ba8e7eb1345afdb1c8d274219cd702b73354) # Conflicts: # skills/healthcheck/SKILL.md * fix(voice-call): harden inbound policy (cherry picked from commit f8dfd034f5d9235c5485f492a9e4ccc114e97fdb) # Conflicts: # CHANGELOG.md # extensions/voice-call/src/manager.ts # extensions/voice-call/src/media-stream.ts # extensions/voice-call/src/providers/twilio.ts * fix(matrix): harden allowlists (cherry picked from commit 8f3bfbd1c4fb967a2ddb5b4b9a05784920814bcf) # Conflicts: # CHANGELOG.md # docs/channels/matrix.md # extensions/matrix/src/channel.ts # extensions/matrix/src/matrix/monitor/handler.ts * docs: Update information architecture for OpenClaw docs (#7622) * docs: restructure navigation into 5 tabs for better IA * dedupe redirects * use 8 tabs * add missing /index extensions * update zh navigation * remove `default: true` and rearrange languages * add missing redirects * format:fix * docs: update IA tabs + restore /images redirect (#7622) (thanks @ethanpalm) --------- Co-authored-by: Peter Steinberger <steipete@gmail.com> (cherry picked from commit f57e70912cad81bc99680026865ffd1051c89ef5) # Conflicts: # CHANGELOG.md # docs/docs.json * chore: prepare 2026.2.2 release (cherry picked from commit 1c4db91593358839a67f6e68576258cf31fa811e) # Conflicts: # CHANGELOG.md # apps/android/app/build.gradle.kts # apps/ios/Sources/Info.plist # apps/ios/Tests/Info.plist # apps/ios/project.yml # apps/macos/Sources/Moltbot/Resources/Info.plist # docs/platforms/mac/release.md # extensions/bluebubbles/package.json # extensions/copilot-proxy/package.json # extensions/diagnostics-otel/package.json # extensions/discord/package.json # extensions/google-antigravity-auth/package.json # extensions/google-gemini-cli-auth/package.json # extensions/googlechat/package.json # extensions/imessage/package.json # extensions/line/package.json # extensions/llm-task/package.json # extensions/lobster/package.json # extensions/matrix/CHANGELOG.md # extensions/matrix/package.json # extensions/mattermost/package.json # extensions/memory-core/package.json # extensions/memory-lancedb/package.json # extensions/minimax-portal-auth/package.json # extensions/msteams/CHANGELOG.md # extensions/msteams/package.json # extensions/nextcloud-talk/package.json # extensions/nostr/CHANGELOG.md # extensions/nostr/package.json # extensions/open-prose/package.json # extensions/signal/package.json # extensions/slack/package.json # extensions/telegram/package.json # extensions/tlon/package.json # extensions/twitch/CHANGELOG.md # extensions/twitch/package.json # extensions/voice-call/CHANGELOG.md # extensions/voice-call/package.json # extensions/whatsapp/package.json # extensions/zalo/CHANGELOG.md # extensions/zalo/package.json # extensions/zalouser/CHANGELOG.md # extensions/zalouser/package.json # package.json * fix(ui): note agent file refresh in changelog (cherry picked from commit f52ca0a712c7c9a7ca917974177515ebe7530393) # Conflicts: # CHANGELOG.md * Docs: refresh zh-CN translations + i18n guidance What: - update zh-CN glossary, translation prompt, and TM - regenerate zh-CN docs and apply targeted fixes - add zh-CN AGENTS guidance for translation pipeline Why: - address zh-CN terminology and spacing feedback from #6995 Tests: - pnpm build && pnpm check && pnpm test (cherry picked from commit 9f03791aa94a506ec5f6fec90425118221df5f1f) * Docs(zh-CN): add AGENTS translation workflow (cherry picked from commit 4027b3583e9a79cb80f3ead487d4e2b7c21ab1ec) * Docs: guard zh-CN i18n workflow What: - document zh-CN docs pipeline and generated-doc guardrails - note Discord escalation when the pipeline drags Why: - prevent accidental edits to generated translations Tests: - pnpm build - pnpm check - pnpm test Co-authored-by: Josh Palmer <joshpalmer123@gmail.com> (cherry picked from commit fd8f8843bd02dbc4cf225af27f59563de14b8622) # Conflicts: # CHANGELOG.md * Docs: drop healthcheck from bootstrap (cherry picked from commit 61a7fc5e0e135e04e3418050dc0142a870fa12e4) # Conflicts: # docs/reference/templates/BOOTSTRAP.md * chore: update changelog for #8193 (thanks @gildo) (cherry picked from commit b64c1a56a13893aab4e22ccd35c2006f4950938f) # Conflicts: # CHANGELOG.md * style: update chat new-messages button (cherry picked from commit 9f16de253354a0c064b0f54ed0479bf11c230d06) # Conflicts: # ui/src/ui/views/chat.ts * docs(skills): split tmux send-keys for TUI (#7737) * docs(skills): split tmux send-keys for TUI * docs(skills): soften TUI send-keys wording --------- Co-authored-by: wangnov <1694546283@qq.com> (cherry picked from commit 089d03453da1e643e1703aa846ac1cc3b44ff1e7) * docs: note tmux send-keys TUI guidance (#7737) (thanks @Wangnov) (cherry picked from commit efc9d0a4988fc4bdea2028d23332e62a5cc06fa8) # Conflicts: # CHANGELOG.md * docs: add changelog for #7178 (thanks @Yeom-JinHo) (cherry picked from commit 44d1aa31f3e2a35275ff48135b4e832c34050521) * docs: document secure DM mode preset (#7872) * docs: document secure DM mode preset * fix: resolve merge conflict in resizable-divider (cherry picked from commit 6fdb136688d462e2a55c7bd728e153fb9d47ac95) * docs: update Feishu plugin docs (cherry picked from commit 5292367324adc951cdce877623dfe88dda5da5ba) # Conflicts: # docs/channels/feishu.md # docs/reference/RELEASING.md * feat: Add Docs Chat Widget with RAG-powered Q&A (#7908) * feat: add docs chat prototype and related scripts - Introduced a minimal documentation chatbot that builds a search index from markdown files and serves responses via an API. - Added scripts for building the index and serving the chat API. - Updated package.json with new commands for chat index building and serving. - Created a new Vercel configuration file for deployment. - Added a README for the docs chat prototype detailing usage and integration. * feat: enhance docs chat with vector-based RAG pipeline - Added vector index building and serving capabilities to the docs chat. - Introduced new scripts for generating embeddings and serving the chat API using vector search. - Updated package.json with new commands for vector index operations. - Enhanced README with instructions for the new RAG pipeline and legacy keyword pipeline. - Removed outdated Vercel configuration file. * feat: enhance chat widget with markdown rendering and style updates - Integrated dynamic loading of markdown rendering for chat responses. - Implemented a fallback for markdown rendering to ensure consistent display. - Updated CSS variables for improved theming and visual consistency. - Enhanced chat bubble and input styles for better user experience. - Added new styles for markdown content in chat bubbles, including code blocks and lists. * feat: add copy buttons to chat widget for enhanced user interaction - Implemented copy buttons for chat responses and code blocks in the chat widget. - Updated CSS styles for improved visibility and interaction of copy buttons. - Adjusted textarea height for better user experience. - Enhanced functionality to allow users to easily copy text from chat bubbles and code snippets. * feat: update chat widget styles for improved user experience - Changed accent color for better visibility. - Enhanced preformatted text styles for code blocks, including padding and word wrapping. - Adjusted positioning and styles of copy buttons for chat responses and code snippets. - Improved hover effects for copy buttons to enhance interactivity. * feat: enhance chat widget styles for better responsiveness and scrollbar design - Updated chat panel dimensions for improved adaptability on various screen sizes. - Added custom scrollbar styles for better aesthetics and usability. - Adjusted chat bubble styles for enhanced visibility and interaction. - Improved layout for expanded chat widget on smaller screens. * feat: refine chat widget code block styles and copy button functionality - Adjusted padding and margin for preformatted text in chat responses for better visual consistency. - Introduced a compact style for single-line code blocks to enhance layout. - Updated copy button logic to skip short code blocks, improving user experience when copying code snippets. * feat: add resize handle functionality to chat widget for adjustable panel width - Implemented a draggable resize handle for the chat widget's sidebar, allowing users to adjust the panel width. - Added CSS styles for the resize handle, including hover effects and responsive behavior. - Integrated drag-to-resize logic to maintain user-set width across interactions. - Ensured the panel resets to default width when closed, enhancing user experience. * feat: implement rate limiting and error handling in chat API - Added rate limiting functionality to the chat API, allowing a maximum number of requests per IP within a specified time window. - Implemented error handling for rate limit exceeded responses, including appropriate headers and retry instructions. - Enhanced error handling for other API errors, providing user-friendly messages for various failure scenarios. - Updated README to include new environment variables for rate limiting configuration. * feat: integrate Upstash Vector for enhanced document retrieval in chat API - Implemented Upstash Vector as a cloud-based storage solution for document chunks, replacing the local LanceDB option. - Added auto-detection of storage mode based on environment variables for seamless integration. - Updated the chat API to utilize the new retrieval mechanism, enhancing response accuracy and performance. - Enhanced README with setup instructions for Upstash and updated environment variable requirements. - Introduced new scripts and configurations for managing the vector index and API interactions. * feat: add create-markdown-preview.js for markdown rendering - Introduced a new script for framework-agnostic HTML rendering of markdown content. - The script includes various parsing functions to handle different markdown elements. - Updated the chat widget to load the vendored version of @create-markdown/preview for improved markdown rendering. * docs: update README for Upstash Vector index setup and environment variables - Enhanced instructions for creating a Vector index in Upstash, including detailed settings and important notes. - Clarified environment variable requirements for both Upstash and LanceDB modes. - Improved formatting and organization of setup steps for better readability. - Added health check and API endpoint details for clearer usage guidance. * feat: add TRUST_PROXY environment variable for IP address handling - Introduced the TRUST_PROXY variable to control the trust of X-Forwarded-For headers when behind a reverse proxy. - Updated the README to document the new environment variable and its default value. - Enhanced the getClientIP function to conditionally trust proxy headers based on the TRUST_PROXY setting. * feat: add ALLOWED_ORIGINS environment variable for CORS configuration - Introduced the ALLOWED_ORIGINS variable to specify allowed origins for CORS, enhancing security and flexibility. - Updated the README to document the new environment variable and its usage. - Refactored CORS handling in the server code to utilize the ALLOWED_ORIGINS setting for dynamic origin control. * fix: ensure complete markdown rendering in chat widget - Added logic to flush any remaining buffered bytes from the decoder, ensuring that all text is rendered correctly in the assistant bubble. - Updated the assistant bubble's innerHTML to reflect the complete markdown content after streaming completes. * feat: enhance DocsStore with improved vector handling and similarity conversion - Added a constant for the distance metric used in vector searches, clarifying the assumption of L2 distance. - Updated the createTable method to ensure all chunk properties are correctly mapped during table creation. - Improved the similarity score calculation by providing a clear explanation of the conversion from L2 distance, ensuring accurate ranking of results. * chore: fix code formatting * Revert "chore: fix code formatting" This reverts commit 6721f5b0b7bf60b76c519ccadfa41742f19ecf87. * chore: format code for improved readability - Reformatted code in serve.ts to enhance readability by adjusting indentation and line breaks. - Ensured consistent style for function return types and object properties throughout the file. * feat: Update API URL selection logic in chat widget - Enhanced the API URL configuration to prioritize explicit settings, defaulting to localhost for development and using a production URL otherwise. - Improved clarity in the code by adding comments to explain the logic behind the API URL selection. * chore: Update documentation structure for improved organization - Changed the path for the "Start Here" page to "start/index" for better clarity. - Reformatted the "Web & Interfaces" and "Help" groups to use multi-line arrays for improved readability. * feat: Enhance markdown preview integration and improve chat widget asset loading - Wrapped the markdown preview functionality in an IIFE to expose a global API for easier integration. - Updated the chat widget to load the markdown preview library dynamically, checking for existing instances to avoid duplicate loads. - Adjusted asset paths in the chat widget to ensure correct loading based on the environment (local or production). - Added CORS headers in the Vercel configuration for improved API accessibility. * fix: Update chat API URL to include '/api' for correct endpoint access - Modified the chat configuration and widget files to append '/api' to the API URL, ensuring proper endpoint usage in production and local environments. * refactor: Simplify docs-chat configuration and remove unused scripts - Removed outdated scripts and configurations related to the docs-chat feature, including build and serve scripts, as well as the associated package.json and README files. - Streamlined the API URL configuration in the chat widget for better clarity and maintainability. - Updated the package.json to remove unnecessary scripts related to the now-deleted functionality. * refactor: Update documentation structure for improved clarity - Changed the path for the "Start Here" page from "start/index" to "index" to enhance navigation and organization within the documentation. * chore: Remove unused dependencies from package.json and pnpm-lock.yaml - Deleted `@lancedb/lancedb`, `@upstash/vector`, and `openai` from both package.json and pnpm-lock.yaml to streamline the project and reduce bloat. * chore: Clean up .gitignore by removing obsolete entries - Deleted unused entries related to the docs-chat vector database from .gitignore to maintain a cleaner configuration. * chore: Remove deprecated chat configuration and markdown preview script - Deleted the `create-markdown-preview.js` script and the `docs-chat-config.js` file to eliminate unused assets and streamline the project. - Updated the `docs-chat-widget.js` to directly reference the markdown library from a CDN, enhancing maintainability. * chore: Update markdown rendering in chat widget to use marked library - Replaced the deprecated `create-markdown-preview` library with the `marked` library for markdown rendering. - Adjusted the script loading mechanism to fetch `marked` from a CDN, improving performance and maintainability. - Enhanced the markdown rendering function to ensure security by disabling HTML pass-through and opening links in new tabs. * Delete docs/start/index.md (cherry picked from commit fa4b28d7af7464b07271bfef6c028e4135548f44) * Changelog: move cron entries to 2026.2.3 (cherry picked from commit c396877dd9860dc5d4a5a1d37abd419f663536ea) # Conflicts: # CHANGELOG.md * Revert "feat: Add Docs Chat Widget with RAG-powered Q&A (#7908)" (#8834) This reverts commit fa4b28d7af7464b07271bfef6c028e4135548f44. (cherry picked from commit 2196456d4a44d1e54651dce5ee89046a829185e5) * Add baidu qianfan model provider (cherry picked from commit 1de05ad068ac0371b4b520a12697a9973faea54d) # Conflicts: # docs/providers/qianfan.md * Optimize doc (cherry picked from commit 8c53dfb74f2484c323ffa835995978443f160baf) * fix(web ui): agent model selection (cherry picked from commit 9822985ea649b93f0deaa8a8a34928159795c55e) # Conflicts: # ui/src/styles/components.css # ui/src/ui/app-render.ts # ui/src/ui/views/agents.ts * chore: replace landpr prompt with end-to-end landing workflow (#8916) (cherry picked from commit eab0a07f71734551fcc88c830bef407c1cdd5297) * 🤖 docs: mirror landing revamp for zh-CN What: - add zh-CN versions of landing revamp pages (features, quickstart, docs directory, network model, credits) - refresh zh-CN index and hubs, plus glossary entries Why: - keep Chinese docs aligned with the new English landing experience - ensure navigation surfaces the new entry points Tests: - pnpm build && pnpm check && pnpm test (cherry picked from commit aaeecc8c8ddc52ded041d1c840bc9af5e2398054) # Conflicts: # docs/.i18n/glossary.zh-CN.json # docs/zh-CN/index.md # docs/zh-CN/start/hubs.md * 🤖 docs: note zh-CN landing revamp (#8994) (thanks @joshp123) What: - add changelog entry for the zh-CN landing revamp docs Why: - record the doc update and thank the contributor Tests: - pnpm lint && pnpm build && pnpm test (cherry picked from commit 2b1da4f5d86fa5e4dda630b7fc57213d973d4b26) # Conflicts: # CHANGELOG.md * changelog: add shell completion auto-fix entry (cherry picked from commit 43590d8287df1a4e26d953ccd982f093ccf87d0f) * chore: sync plugin versions to 2026.2.3 (cherry picked from commit f895c9fba12f0860f52f2689432023919b9b4b8f) # Conflicts: # extensions/bluebubbles/package.json # extensions/copilot-proxy/package.json # extensions/diagnostics-otel/package.json # extensions/discord/package.json # extensions/feishu/package.json # extensions/google-antigravity-auth/package.json # extensions/google-gemini-cli-auth/package.json # extensions/googlechat/package.json # extensions/imessage/package.json # extensions/line/package.json # extensions/llm-task/package.json # extensions/lobster/package.json # extensions/matrix/CHANGELOG.md # extensions/matrix/package.json # extensions/mattermost/package.json # extensions/memory-core/package.json # extensions/memory-lancedb/package.json # extensions/msteams/CHANGELOG.md # extensions/msteams/package.json # extensions/nextcloud-talk/package.json # extensions/nostr/CHANGELOG.md # extensions/nostr/package.json # extensions/open-prose/package.json # extensions/signal/package.json # extensions/slack/package.json # extensions/telegram/package.json # extensions/tlon/package.json # extensions/twitch/CHANGELOG.md # extensions/twitch/package.json # extensions/voice-call/CHANGELOG.md # extensions/voice-call/package.json # extensions/whatsapp/package.json # extensions/zalo/CHANGELOG.md # extensions/zalo/package.json # extensions/zalouser/CHANGELOG.md # extensions/zalouser/package.json * chore: update 2026.2.3 notes (cherry picked from commit 54ddbc466085b42526983f6c90d152fdd7bf365f) # Conflicts: # CHANGELOG.md # appcast.xml * Optimize format (cherry picked from commit ad759c94460c922e6b16951c9b8c1d09f7723baf) # Conflicts: # docs/providers/qianfan.md * Optimize doc (cherry picked from commit ff948a6dd7bb0ae1cd257541c1bb6715e07e91c5) # Conflicts: # docs/providers/qianfan.md * Docs: streamline start and install docs (#9648) * docs(start): streamline getting started flow * docs(nav): reorganize start and install sections * docs(style): move custom css to style.css * docs(navigation): align zh-CN ordering * docs(navigation): localize zh-Hans labels (cherry picked from commit 675c26b2b013cf1d8c95122cc8f50e3c2e7b8497) # Conflicts: # docs/docs.json # docs/start/docs-directory.md # docs/start/getting-started.md # docs/start/onboarding.md # docs/start/quickstart.md # docs/start/setup.md # docs/start/wizard.md * docs(install): rename install overview page (cherry picked from commit 34424ce5362908c2b0a51dd8f6adad209c7f63dc) * docs(onboarding): add bootstrapping page (#9767) (cherry picked from commit 3011b00d39e9fd6b64977efa573ef9c4f6295d1e) # Conflicts: # docs/start/onboarding.md * docs: fix onboarding rendering issues (cherry picked from commit c8f4bca0c4219527b96730211b607ac9b26b88d6) # Conflicts: # docs/start/onboarding.md * docs(onboarding): streamline CLI onboarding docs (#9830) (cherry picked from commit 9e0030b75f2ea20b1cc5e60df2a7c6418000a1e3) # Conflicts: # docs/cli/onboard.md # docs/start/wizard.md * update handle (cherry picked from commit 1473fb19a521f68221fe3c5c527290505acc4bfb) * docs: fix incorrect model.fallback to model.fallbacks in Ollama config (#9384) (#9749) Both English and Chinese documentation had incorrect configuration template using 'fallback' instead of 'fallbacks' in agents.defaults.model config. Co-authored-by: damaozi <1811866786@qq.com> (cherry picked from commit 679bb087db6f7ac59215171c213db55a3472aaad) # Conflicts: # docs/providers/ollama.md * feat(skills): add QR code skill (#8817) feat(skills): add QR code generation and reading skill Adds qr-code skill with: - qr_generate.py - Generate QR codes with customizable size/error correction - qr_read.py - Decode QR codes from images - SKILL.md documentation Co-authored-by: Omar-Khaleel (cherry picked from commit ad13c265ba1fd22dadfe30325ed998d9a3d95e5c) * chore(agentsmd): add tsgo command to AGENTS.md (#9894) Add `pnpm tsgo` command to AGENTS.md development reference Co-authored-by: vincentkoc <vincentkoc@users.noreply.github.com> (cherry picked from commit db8e9b37c6dc798a74a988a68bd709f4661f4b2b) * Revert "feat(skills): add QR code skill (#8817)" This reverts commit ad13c265ba1fd22dadfe30325ed998d9a3d95e5c. (cherry picked from commit 6b7d3c3062cdf5e1cf5e50860a56b867c8b2f66c) * docs: tighten secure DM example (cherry picked from commit 873182ec2d2c41546567ba97111d969ccacebf7d) # Conflicts: # docs/concepts/session.md * docs: note secure DM guidance update (#9377) (thanks @Shrinija17) (cherry picked from commit 8fdc0a284154c4343ef92a4c88e1c0338779ec92) # Conflicts: # CHANGELOG.md * docs: restructure Get Started tab and improve onboarding flow (#9950) * docs: restructure Get Started tab and improve onboarding flow - Flatten nested Onboarding group into linear First Steps flow - Add 'What is OpenClaw?' narrative section to landing page - Split wizard.md into streamlined overview + full reference (reference/wizard.md) - Move Pairing to Channels > Configuration - Move Bootstrapping to Agents > Fundamentals - Move macOS app onboarding to Platforms > macOS companion app - Move Lore to Help > Community - Remove duplicate install instructions from openclaw.md - Mirror navigation changes in zh-CN tabs - No content deleted — all detail preserved or relocated * docs: move deployment pages to install/, fix Platforms tab routing, clarify onboarding paths - Move deployment guides (fly, hetzner, gcp, macos-vm, exe-dev, railway, render, northflank) from platforms/ and root to install/ - Add 'Hosting and deployment' group to Install tab - Slim Gateway & Ops 'Remote access and deployment' down to 'Remote access' - Swap Platforms tab before Gateway & Ops to fix path-prefix routing - Move macOS app onboarding into First steps (parallel to CLI wizard) - Rename sidebar titles to 'Onboarding: CLI' / 'Onboarding: macOS App' - Add redirects for all moved paths - Update all internal links (en + zh-CN) - Fix img tag syntax in onboarding.md (cherry picked from commit c18452598aa0b6977ad8962c689bed03e144986d) # Conflicts: # docs/docs.json # docs/help/faq.md # docs/index.md # docs/start/clawd.md # docs/start/wizard.md # docs/zh-CN/gateway/remote.md # docs/zh-CN/help/faq.md # docs/zh-CN/install/docker.md # docs/zh-CN/platforms/digitalocean.md # docs/zh-CN/platforms/index.md # docs/zh-CN/platforms/oracle.md # docs/zh-CN/platforms/raspberry-pi.md # docs/zh-CN/start/getting-started.md # docs/zh-CN/vps.md * chore: remove tracked .DS_Store files (cherry picked from commit 8577d015b24e5d9ba65f0ab02c271659b86d1855) * chore: changelog for xAI onboarding (#9885) (thanks @grp06) (cherry picked from commit 68393bfa36cbbd2bf2acf088f51bf8dbb74bfd90) * Changelog: note #9976 thinking alias + Codex 5.3 docs sync (cherry picked from commit 7db839544d081103c22e5a7db4195245ef2c97af) # Conflicts: # CHANGELOG.md * add PR review workflow templates (cherry picked from commit 0a485924757174995a7bd6feae5b2da6e20bc58d) * Chore: Update memory.md with current default workspace path (#9559) Removed 'clawd' workspace reference - updated with current default workspace path of '~/.openclaw/workspace' (cherry picked from commit b1430aaaca7613aa74f618ed7a83f6413a843435) * docs: add activeHours to heartbeat field notes and examples (#9366) Co-authored-by: unisone <unisone@users.noreply.github.com> (cherry picked from commit d2aee7da6833898d847120c03c1d822d2267aa40) # Conflicts: # docs/gateway/heartbeat.md * docs: update clawtributors (add @unisone) (cherry picked from commit ac0c2f260f6bb60f4236a9d49abfcdfe45f9b622) # Conflicts: # README.md * Docs: add PR and issue submission guides (#10150) * Docs: add PR and issue submission guides * Docs: fix LLM-assisted wording (cherry picked from commit 50e687d17d7c7cd825efc23a67b76360c3c77ba8) * Docs: sharpen Install tab to stop duplicating Getting Started (#10416) * docs(install): reframe install overview to stop duplicating getting started * docs(install): link default installer row to getting started, not internals * docs(install): use Mintlify components for install overview * docs(install): fix card grid layout with CardGroup * docs(install): platform tabs for global install, npm/pnpm as accordion * docs(install): add PowerShell no-onboard alternative * docs(install): add repo link to from-source clone step * docs(install): capitalize OpenClaw in repo link * docs(install): add pnpm link --global to from-source steps * docs(install): rewrite install overview for clarity and flow * docs(install): use tooltip for Windows WSL2 recommendation * docs(install): use Note box for Windows WSL2 recommendation * docs(install): group install methods under single heading * docs(install): standardize tab labels across installer sections * docs(install): rewrite Node.js page with install instructions and better structure * docs(install): clarify Node.js page intro * docs(install): scope auto-install note to installer script, link Node page * docs(install): fix installer script link to internals page * docs: rename Install methods nav group to Other install methods * docs(install): link to on-page anchor, use Tip box for recommended * docs(install): wrap install methods in AccordionGroup with Tip box * docs: move Node.js page from Install to Help > Environment and debugging * docs(install): add complete flags and env vars reference to installer internals * docs(install): use stable troubleshooting anchor for Node.js link * docs(install): fix Node page installer anchor * docs(install): fix broken installer script anchor in requirements note (cherry picked from commit 18b480dd3ee7fc79605988c474b6f440f8083436) # Conflicts: # docs/install/index.md # docs/install/installer.md # docs/install/node.md * docs: linting (cherry picked from commit 1bf9f237f719385517ba5f6c709875a18c1a53b6) # Conflicts: # docs/channels/slack.md # docs/concepts/session.md # docs/help/faq.md # docs/platforms/mac/voice-overlay.md # docs/tui.md * docs(markdownlint): enable autofixable rules and normalize links (cherry picked from commit c7aec0660ea9075612c28d2e10eeb1829f0767d2) # Conflicts: # .markdownlint-cli2.jsonc # docs/automation/gmail-pubsub.md # docs/bedrock.md # docs/brave-search.md # docs/channels/bluebubbles.md # docs/channels/line.md # docs/channels/matrix.md # docs/channels/msteams.md # docs/channels/nextcloud-talk.md # docs/channels/nostr.md # docs/channels/slack.md # docs/channels/telegram.md # docs/channels/twitch.md # docs/channels/zalo.md # docs/channels/zalouser.md # docs/concepts/groups.md # docs/concepts/memory.md # docs/concepts/model-providers.md # docs/concepts/system-prompt.md # docs/concepts/typebox.md # docs/debug/node-issue.md # docs/experiments/research/memory.md # docs/gateway/authentication.md # docs/gateway/configuration.md # docs/gateway/local-models.md # docs/gateway/security/index.md # docs/help/faq.md # docs/index.md # docs/install/docker.md # docs/install/northflank.mdx # docs/install/railway.mdx # docs/install/render.mdx # docs/install/uninstall.md # docs/install/updating.md # docs/platforms/ios.md # docs/platforms/mac/dev-setup.md # docs/plugin.md # docs/providers/cloudflare-ai-gateway.md # docs/providers/deepgram.md # docs/providers/moonshot.md # docs/providers/ollama.md # docs/providers/vercel-ai-gateway.md # docs/reference/AGENTS.default.md # docs/reference/RELEASING.md # docs/reference/credits.md # docs/reference/device-models.md # docs/reference/templates/AGENTS.md # docs/reference/templates/HEARTBEAT.md # docs/start/clawd.md # docs/start/setup.md # docs/tools/browser-linux-troubleshooting.md # docs/tools/browser.md # docs/tools/chrome-extension.md # docs/tools/llm-task.md # docs/tools/skills.md # docs/tools/web.md # docs/tui.md # docs/web/dashboard.md * revert(docs): undo markdownlint autofix churn (cherry picked from commit 0a1f4f666a66846a67a103d10eeddb29d2ec422f) # Conflicts: # docs/automation/gmail-pubsub.md # docs/bedrock.md # docs/brave-search.md # docs/channels/bluebubbles.md # docs/channels/matrix.md # docs/channels/msteams.md # docs/channels/nextcloud-talk.md # docs/channels/nostr.md # docs/channels/telegram.md # docs/channels/twitch.md # docs/channels/zalo.md # docs/channels/zalouser.md # docs/concepts/groups.md # docs/concepts/memory.md # docs/concepts/system-prompt.md # docs/concepts/typebox.md # docs/debug/node-issue.md # docs/experiments/research/memory.md # docs/gateway/authentication.md # docs/gateway/configuration.md # docs/gateway/local-models.md # docs/gateway/security/index.md # docs/help/faq.md # docs/install/docker.md # docs/install/northflank.mdx # docs/install/railway.mdx # docs/install/render.mdx # docs/install/uninstall.md # docs/install/updating.md # docs/platforms/ios.md # docs/platforms/mac/dev-setup.md # docs/plugin.md # docs/providers/deepgram.md # docs/providers/moonshot.md # docs/providers/ollama.md # docs/providers/vercel-ai-gateway.md # docs/reference/AGENTS.default.md # docs/reference/RELEASING.md # docs/reference/device-models.md # docs/reference/templates/AGENTS.md # docs/reference/templates/HEARTBEAT.md # docs/start/clawd.md # docs/start/setup.md # docs/tools/browser-linux-troubleshooting.md # docs/tools/browser.md # docs/tools/chrome-extension.md # docs/tools/llm-task.md # docs/tools/skills.md # docs/tools/web.md # docs/tui.md # docs/web/dashboard.md * Docs: enable markdownlint autofixables except list numbering (#10476) * docs(markdownlint): enable autofixable rules except list numbering * docs(zalo): fix malformed bot platform link (cherry picked from commit 578a6e27aa76adab85471b322321d9b6d4227322) # Conflicts: # docs/brave-search.md # docs/channels/bluebubbles.md # docs/channels/matrix.md # docs/channels/msteams.md # docs/channels/nextcloud-talk.md # docs/channels/telegram.md # docs/channels/twitch.md # docs/concepts/system-prompt.md # docs/concepts/typebox.md # docs/debug/node-issue.md # docs/gateway/configuration.md # docs/gateway/local-models.md # docs/gateway/security/index.md # docs/help/faq.md # docs/install/northflank.mdx # docs/install/railway.mdx # docs/install/render.mdx # docs/install/updating.md # docs/platforms/mac/dev-setup.md # docs/providers/moonshot.md # docs/providers/ollama.md # docs/tools/skills.md # docs/tools/web.md # docs/web/dashboard.md * Docs: revamp installer internals for readability and accuracy (#10499) * docs(install): revamp installer internals for readability and accuracy Restructure the installer internals page with better flow and Mintlify components (CardGroup, Steps, Tabs, AccordionGroup). All flags, env vars, and behavioral descriptions cross-checked against install.sh, install-cli.sh, and install.ps1 source code. - Add CardGroup chooser and Quick Commands section at top - Organize each script into consistent Flow → Examples → Reference pattern - Move flags/env var tables into collapsible Accordions - Consolidate troubleshooting into AccordionGroup at bottom - Add missing flags (--version, --beta, --verbose, --help, etc.) - Add missing env vars (OPENCLAW_VERSION, OPENCLAW_BETA, etc.) - Document install-cli.sh fully (was one paragraph) - Fix non-interactive checkout detection behavior (defaults to npm) - Use --proto/--tlsv1.2 in curl examples to match script usage - No content deleted; all original info preserved or relocated * fix(docs): correct in-page anchor hrefs for installer cards * docs(install): replace CardGroup with table for installer overview (cherry picked from commit 991cf4d7fec5ce7215c02200325e54c7e3f38251) # Conflicts: # docs/install/installer.md * Docs: add PR sign-off template (#10561) (cherry picked from commit 5842bcaaf72c7dcb883790f7c837df5530f3dae3) * Docs: revise PR and issue submission guides (#10617) * Docs: revise PR submission guide * Docs: revise issue submission guide (cherry picked from commit e3d3893d5dbec30c2046166b6a71bacfe641ef78) * docs(changelog): prepare 2026.2.6 (cherry picked from commit 3b768a285134285ae52bafdbe57d48e37f838ca0) # Conflicts: # CHANGELOG.md * docs(changelog): include merged PRs since v2026.2.3 (cherry picked from commit ac5944cde71b8f7efa96b250a1f48575a75694b2) # Conflicts: # CHANGELOG.md * docs: fix markdownlint fragments + headings (cherry picked from commit 5163833be5c5759798f1132b93958894ada6bf90) # Conflicts: # docs/install/installer.md * docs(changelog): refresh 2026.2.6 since v2026.2.3 (cherry picked from commit 7be921c4340cbac1d62ef0d993977b31c18f9819) # Conflicts: # CHANGELOG.md * docs(imessage): add macOS TCC troubleshooting (cherry picked from commit fe308a3aa187870f752c25e21a61b4f60c4a9b50) * docs(imessage): improve macOS TCC troubleshooting guidance (#10781) (cherry picked from commit 93bf75279fbb2820e811d7cdabcaaf545018b575) # Conflicts: # docs/channels/imessage.md * docs(changelog): curate 2026.2.6 (cherry picked from commit c237a82b42f8fe885608560a389d0e368d5a019b) # Conflicts: # CHANGELOG.md * docs(changelog): highlight Opus 4.6 + Codex 5.3 first (cherry picked from commit f831c48e56705184195b69ebbf662f785b032ae4) * Fix QMD CLI installation link in memory.md (#8647) Correct the installation link for the QMD CLI in the documentation. (cherry picked from commit c80a09fc2f19c31b717bee9d06f5074ddf78ee4a) * Docs: fix broken /plugins links (#9308) * Docs: fix broken /plugins links to /plugin The documentation linked to /plugins which doesn't exist. The correct path is /plugin (singular) which contains the plugins overview documentation. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * docs: drop manual zh-CN doc edits from plugins link fix --------- Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com> Co-authored-by: Sebastian <19554889+sebslight@users.noreply.github.com> (cherry picked from commit d1dc60774ba10bfdfa6d2167760e1172579227c9) # Conflicts: # docs/cli/memory.md * Fix repository links in formal-verification.md (#10200) Updated repository links for formal verification models. (cherry picked from commit 3d2fe9284eb6617bdb00f295c9e87472bd70e6b2) * Revert previous change from 'Clawdbot' to 'OpenClaw' in lore (#9119) (cherry picked from commit 4c1da23a710bd7a1ded7ca840bc51481b727c8e7) * chore(skills): remove bird skill (cherry picked from commit 31a7e4f9375f64ee3177bdc955cbe73dadfd96b1) # Conflicts: # docs/tools/exec-approvals.md # skills/bird/SKILL.md * docs(changelog): note CI pipeline optimization (#10784) (thanks @mcaxtr) (cherry picked from commit 875324e7c730f4ab99db14a405cf51ebf1228811) * chore(release): 2026.2.6-2 (cherry picked from commit ad4dd0422ea46d21ad336151ca6f2a63119e80f1) # Conflicts: # extensions/bluebubbles/package.json # extensions/copilot-proxy/package.json # extensions/diagnostics-otel/package.json # extensions/discord/package.json # extensions/feishu/package.json # extensions/google-antigravity-auth/package.json # extensions/google-gemini-cli-auth/package.json # extensions/googlechat/package.json # extensions/imessage/package.json # extensions/line/package.json # extensions/llm-task/package.json # extensions/lobster/package.json # extensions/matrix/CHANGELOG.md # extensions/matrix/package.json # extensions/mattermost/package.json # extensions/memory-core/package.json # extensions/memory-lancedb/package.json # extensions/minimax-portal-auth/package.json # extensions/msteams/CHANGELOG.md # extensions/msteams/package.json # extensions/nextcloud-talk/package.json # extensions/nostr/CHANGELOG.md # extensions/nostr/package.json # extensions/open-prose/package.json # extensions/signal/package.json # extensions/slack/package.json # extensions/telegram/package.json # extensions/tlon/package.json # extensions/twitch/CHANGELOG.md # extensions/twitch/package.json # extensions/voice-call/CHANGELOG.md # extensions/voice-call/package.json # extensions/whatsapp/package.json # extensions/zalo/CHANGELOG.md # extensions/zalo/package.json # extensions/zalouser/CHANGELOG.md # extensions/zalouser/package.json # package.json * chore(release): 2026.2.6-3 (cherry picked from commit 9f703a44dc954349d4c9571cba2f16b7fb3d2adc) # Conflicts: # extensions/bluebubbles/package.json # extensions/copilot-proxy/package.json # extensions/diagnostics-otel/package.json # extensions/discord/package.json # extensions/feishu/package.json # extensions/google-antigravity-auth/package.json # extensions/google-gemini-cli-auth/package.json # extensions/googlechat/package.json # extensions/imessage/package.json # extensions/line/package.json # extensions/llm-task/package.json # extensions/lobster/package.json # extensions/matrix/CHANGELOG.md # extensions/matrix/package.json # extensions/mattermost/package.json # extensions/memory-core/package.json # extensions/memory-lancedb/package.json # extensions/minimax-portal-auth/package.json # extensions/msteams/CHANGELOG.md # extensions/msteams/package.json # extensions/nextcloud-talk/package.json # extensions/nostr/CHANGELOG.md # extensions/nostr/package.json # extensions/open-prose/package.json # extensions/signal/package.json # extensions/slack/package.json # extensions/telegram/package.json # extensions/tlon/package.json # extensions/twitch/CHANGELOG.md # extensions/twitch/package.json # extensions/voice-call/CHANGELOG.md # extensions/voice-call/package.json # extensions/whatsapp/package.json # extensions/zalo/CHANGELOG.md # extensions/zalo/package.json # extensions/zalouser/CHANGELOG.md # extensions/zalouser/package.json # package.json * docs: add symptom-first troubleshooting hub and deep runbooks (#11196) * docs(troubleshooting): add symptom-first troubleshooting runbooks * docs(troubleshooting): fix approvals command examples * docs(troubleshooting): wrap symptom cases in accordions * docs(automation): clarify userTimezone missing-key behavior * docs(troubleshooting): fix first-60-seconds ladder order (cherry picked from commit 9a3f62cb86cd505d8ee490aa6a1fe9600d96ad65) # Conflicts: # docs/channels/troubleshooting.md # docs/gateway/troubleshooting.md # docs/help/troubleshooting.md * docs: add missing HEARTBEAT.md and MEMORY.md to bootstrap files list (#8105) * docs: add missing HEARTBEAT.md and MEMORY.md to bootstrap files list Fixes #7928 The documentation for skipBootstrap and workspace setup was missing HEARTBEAT.md and MEMORY.md from the bootstrap files list. Changes: - docs/gateway/configuration.md: Add HEARTBEAT.md and MEMORY.md - docs/zh-CN/gateway/configuration.md: Same for Chinese version - docs/start/openclaw.md: Add HEARTBEAT.md, clarify MEMORY.md is optional - docs/zh-CN/start/openclaw.md: Same for Chinese version * fix: reference PR number instead of issue in CHANGELOG * docs(workspace): align bootstrap file docs with runtime (#8105) --------- Co-authored-by: damaozi <1811866786@qq.com> Co-authored-by: Sebastian <19554889+sebslight@users.noreply.github.com> (cherry picked from commit a4d5c7f6730a4648b20163f4194c43140df35da0) # Conflicts: # docs/start/clawd.md * adding PR review workflow (cherry picked from commit 6d1daf2ba5c8778f7cf0f6230c615e20b89eec2c) * added more explicit instructions (cherry picked from commit cde29fef715e4edf633be260051cdabab3db5dba) * Fix typo in FAQ regarding model configuration command (#6048) (cherry picked from commit 9201e140cb523fc9bac1362d6afef0efda415b88) # Conflicts: # docs/help/faq.md * Update CHANGELOG.md for version 2026.2.6-4: Added RPC methods for agent management, fixed context overflow recovery, improved LAN IP handling, enhanced memory retrieval, and updated media understanding for audio transcription. (cherry picked from commit a30c4f45c38434af6f4cac5bcc2cdd6b0bc6b336) # Conflicts: # CHANGELOG.md * docs: clarify onboarding instructions for beginners (#10956) (cherry picked from commit 9866a857a79a70bfe958034a2f462ff3a6150764) # Conflicts: # README.md * chore: updated PR review skills and workflow info on tests + fake timers (cherry picked from commit c27b03794afa19128c92430ced70ddac194b0842) * Fix Nix repository link in README (#7910) Updated Nix repository link in README. Co-authored-by: Josh <141778+bolapara@users.noreply.github.com> Co-authored-by: Seb Slight <19554889+sebslight@users.noreply.github.com> (cherry picked from commit 05a57e94a4b63d37bb5f063c2fe0466fa8299674) # Conflicts: # README.md * Docs: fix cron.update param name id → jobId (#11365) (#11467) * Docs: fix cron.update param name id → jobId (#11365) * Docs: sync zh-CN cron.update param name id → jobId * docs: revert manual zh-CN generated docs edit (#11467) (thanks @lailoo) --------- Co-authored-by: damaozi <1811866786@qq.com> Co-authored-by: Sebastian <19554889+sebslight@users.noreply.github.com> (cherry picked from commit 0499656c5905e82f2bc492960708b8ef879a5e28) * fix(ui): smooth chat refresh scroll and suppress new-messages badge flash (cherry picked from commit bc475f0172d15a896596d35969441ff57e1356f2) # Conflicts: # CHANGELOG.md # ui/s…
* docs: document cacheRetention parameter (openclaw#6240) * docs: standardize cacheRetention value quoting style * style: format anthropic.md table * Docs: align cacheRetention inline example --------- Co-authored-by: Sebastian <sebslight@gmail.com> (cherry picked from commit 7a8a39a) # Conflicts: # docs/concepts/session-pruning.md # docs/providers/anthropic.md
* docs: document cacheRetention parameter (openclaw#6240) * docs: standardize cacheRetention value quoting style * style: format anthropic.md table * Docs: align cacheRetention inline example --------- Co-authored-by: Sebastian <sebslight@gmail.com>
Summary
cacheRetentionparameter instead of deprecatedcacheControlTtlnone,short,long)Test plan
pnpm buildpassespnpm lintpassesCloses #6240
🤖 Generated with Claude Code
Greptile Overview
Greptile Summary
This PR updates documentation to prefer the new
cacheRetentionmodel param over the legacycacheControlTtl, and expands the Anthropic provider docs with a table describing the available retention values (none/short/long) plus a legacy mapping note. It also updates related examples (session pruning + token-use) to referencecacheRetentionso guidance matches the current configuration defaults/behavior in the codebase.Confidence Score: 4/5
cacheRetention/cacheControlTtl. No functional code changes; only minor formatting/consistency issues likely to confuse copy/paste.(2/5) Greptile learns from your feedback when you react with thumbs up/down!