docs: publish v2026.5.7-3 correction#1
Open
mudrii wants to merge 6 commits into
Open
Conversation
- telegram errorPolicy enum always|once|silent (default always); cooldown 14400000ms - feishu dmPolicy default pairing; textChunkLimit default 4000 - matrix add progress streaming mode row - tlon allowPrivateNetwork → network.dangerouslyAllowPrivateNetwork - bluebubbles enrichGroupParticipantsFromContacts default true - qqbot remove unsupported TTS section (schema has stt only)
- anthropic: claude-opus-4-6 → claude-opus-4-7 (8 refs); dot-form claude-opus-4.7 → dash-form - openai: TTS default voice coral → alloy (matches OPENAI_DEFAULT_TTS_VOICE) - groq: drop unsupported Mixtral 8x7B; add Mistral Saba 24B - mistral: remove stray Z.AI auth line (copy-paste leak) - moonshot: endpoint table accepts MOONSHOT_API_KEY or KIMI_API_KEY - zai: accept ZAI_API_KEY or Z_AI_API_KEY - xai: add grok-4.20-experimental-beta-0304-* legacy aliases - openrouter: clarify examples are illustrative (no static catalog)
- plugin-inventory.md: add active-memory, device-pair, phone-control, talk-voice, thread-ownership - reference.md: grow to 120 rows with same 5 entries (115→120) - sdk-overview.md: drop unsupported `plugin-sdk/slack`/signal/whatsapp seams (not exported at v2026.5.7)
Header version/date refresh. Body historical release-window references preserved where they label the changeset shipped in earlier releases.
- exec.md: document `process poll` timeout clamp (max 30000ms) and `process send-keys` alternate input forms (`hex`, `literal`) - snippets/plugin-publish/minimal-package.json: bump baseline from beta.2 minima to v2026.5.7 (matches current released floor)
Bump snapshot label to v2026.5.7-3 across CHANGELOG/README/ARCHITECTURE/AGENT_README. Same upstream baseline as v2026.5.7. Refresh prerelease exclusion note through the latest GitHub-published prerelease v2026.5.12-beta.3 (source tag v2026.5.10-beta.6 is not a GitHub release).
![gemini-code-assist[bot]](https://avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
There was a problem hiding this comment.
Code Review
This pull request updates the documentation to version v2026.5.7-3, incorporating corrections for channel defaults, provider catalogs, and plugin inventories. Key updates include bumping the default Anthropic model to claude-opus-4-7, correcting the OpenAI TTS default voice to alloy, and adding five missing source-only plugins to the reference tables. Additionally, configuration keys for Tlon and Telegram were updated, and the exec tool documentation was expanded to include new send-keys variants. Feedback was provided regarding an inconsistency in the Anthropic documentation where an example redundantly enables a 1M context window for a model that already supports it by default.
Comment on lines
+274
to
276
| "anthropic/claude-opus-4-7": { | ||
| params: { context1m: true }, | ||
| }, |
There was a problem hiding this comment.
The example here explicitly sets params.context1m: true for the anthropic/claude-opus-4-7 model. However, the documentation on line 297 states that this model has a 1M context window by default and that params.context1m: true is not needed. This creates a contradiction that may confuse users. Consider removing this redundant parameter from the example or using a different model that requires it to enable 1M context.
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 4c96fa6338
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| | [qa-channel](/plugins/reference/qa-channel) | Adds the QA Channel surface for sending and receiving OpenClaw messages. | `@openclaw/qa-channel`<br />source checkout only | channels: qa-channel | | ||
| | [qa-lab](/plugins/reference/qa-lab) | OpenClaw QA lab plugin with private debugger UI and scenario runner. | `@openclaw/qa-lab`<br />source checkout only | plugin | | ||
| | [qa-matrix](/plugins/reference/qa-matrix) | Matrix QA transport runner and substrate. | `@openclaw/qa-matrix`<br />source checkout only | plugin | | ||
| | [active-memory](/plugins/reference/active-memory) | Runs a bounded blocking memory sub-agent before eligible conversational replies and injects relevant memory into prompt context. | `@openclaw/active-memory`<br />source checkout only | plugin | |
There was a problem hiding this comment.
These newly added source-only plugin rows link to /plugins/reference/active-memory (and similarly device-pair, phone-control, talk-voice, and thread-ownership), but those pages are not present under docs/plugins/reference/ in this repo. On the published docs these links will 404 unless the corresponding reference pages are added or the rows link to an existing anchor/page instead.
Useful? React with 👍 / 👎.
There was a problem hiding this comment.
Pull request overview
Docs-only correction snapshot for the stable v2026.5.7 baseline (v2026.5.7-3), updating channel/provider defaults, plugin inventories, tool docs, and restamping analysis pages to the v2026.5.7 tag/date.
Changes:
- Update multiple channel/provider docs to match
v2026.5.7source defaults/aliases (Telegram/Feishu/Matrix/Tlon/QQ Bot/BlueBubbles; Anthropic/OpenAI/Moonshot/Z.AI/xAI/OpenRouter/Groq/Mistral). - Add 5 missing source-only plugins to the plugin reference + inventory tables; clarify SDK channel-branded seam guidance.
- Bump snapshot/version headers (README/CHANGELOG/ARCHITECTURE/AGENT_README + analysis pages), and refresh tool/snippet docs (
execpoll timeout + send-keys variants; minimal plugin publish package.json baseline).
Reviewed changes
Copilot reviewed 33 out of 33 changed files in this pull request and generated 6 comments.
Show a summary per file
| File | Description |
|---|---|
| README.md | Bumps docs snapshot to v2026.5.7-3 and adds a detailed versioning bullet. |
| docs/tools/exec.md | Documents process poll timeout + send-keys hex/literal forms. |
| docs/snippets/plugin-publish/minimal-package.json | Updates snippet compat/build baseline to 2026.5.7. |
| docs/providers/zai.md | Adds Z_AI_API_KEY auth env var alias. |
| docs/providers/xai.md | Restores legacy grok-4.20-experimental-beta-0304-* aliases. |
| docs/providers/openrouter.md | Rewords model refs list as illustrative (no static catalog). |
| docs/providers/openai.md | Corrects default TTS voice to alloy. |
| docs/providers/moonshot.md | Documents KIMI_API_KEY as an alias for Moonshot endpoints. |
| docs/providers/mistral.md | Removes stray Z.AI-related line from Mistral docs. |
| docs/providers/groq.md | Updates catalog example model row. |
| docs/providers/anthropic.md | Updates default model examples to claude-opus-4-7. |
| docs/plugins/sdk-overview.md | Clarifies channel-branded SDK seams are limited/internal. |
| docs/plugins/reference.md | Adds 5 source-only plugins to the generated reference table. |
| docs/plugins/plugin-inventory.md | Adds 5 source-only plugins to the inventory table. |
| docs/channels/tlon.md | Renames private-network config to network.dangerouslyAllowPrivateNetwork. |
| docs/channels/telegram.md | Updates error policy enum + cooldown default and example. |
| docs/channels/qqbot.md | Narrows voice docs to STT-only (no outbound TTS). |
| docs/channels/matrix.md | Adds progress streaming mode documentation. |
| docs/channels/feishu.md | Updates dmPolicy/text chunk defaults in config reference. |
| docs/channels/bluebubbles.md | Updates Contacts enrichment default to true. |
| CHANGELOG.md | Adds v2026.5.7-3 “Docs Correction Summary” entry. |
| ARCHITECTURE.md | Restamps header to v2026.5.7-3 (2026-05-13). |
| analysis/utils-support.md | Restamps analysis header to v2026.5.7 / 2026-05-13. |
| analysis/security-web-browser.md | Restamps analysis header to v2026.5.7 / 2026-05-13. |
| analysis/security-plugins.md | Restamps analysis header to v2026.5.7 / 2026-05-13. |
| analysis/memory-cron-media.md | Restamps analysis header to v2026.5.7 / 2026-05-13. |
| analysis/gateway-config-infra.md | Restamps analysis header to v2026.5.7 / 2026-05-13. |
| analysis/core-engine.md | Restamps analysis header to v2026.5.7 / 2026-05-13. |
| analysis/cli-tools-media.md | Restamps analysis header to v2026.5.7 / 2026-05-13. |
| analysis/cli-config-infra.md | Restamps analysis header to v2026.5.7 / 2026-05-13. |
| analysis/channels.md | Restamps analysis header to v2026.5.7 / 2026-05-13. |
| analysis/agent-system.md | Restamps analysis header to v2026.5.7 / 2026-05-13. |
| AGENT_README.md | Updates “Current docs version” banner to v2026.5.7-3. |
Comments suppressed due to low confidence (4)
docs/plugins/reference.md:44
- This newly added row appears to have inconsistent spacing/padding before the table pipes compared to the surrounding generated rows, which can break table pipe alignment linting (MD060). Please regenerate the table output or normalize spacing so the pipes align.
| [deepinfra](/plugins/reference/deepinfra) | Adds DeepInfra model provider support to OpenClaw. | `@openclaw/deepinfra-provider`<br />included in OpenClaw | providers: deepinfra; contracts: imageGenerationProviders, mediaUnderstandingProviders, memoryEmbeddingProviders, speechProviders, videoGenerationProviders |
| [deepseek](/plugins/reference/deepseek) | Adds DeepSeek model provider support to OpenClaw. | `@openclaw/deepseek-provider`<br />included in OpenClaw | providers: deepseek |
| [device-pair](/plugins/reference/device-pair) | Generate setup codes and approve device pairing requests. | `@openclaw/device-pair`<br />source checkout only | plugin |
| [diagnostics-otel](/plugins/reference/diagnostics-otel) | OpenClaw diagnostics OpenTelemetry exporter. | `@openclaw/diagnostics-otel`<br />npm; ClawHub: `clawhub:@openclaw/diagnostics-otel` | plugin |
docs/plugins/reference.md:100
- This newly added
phone-controlrow includes unusually large padding before the|separators compared to the rest of the table. Please normalize the markdown table formatting (ideally by re-runningpnpm plugins:inventory:gen) to avoid markdownlint table alignment issues.
| [openshell](/plugins/reference/openshell) | Sandbox backend powered by OpenShell with mirrored local workspaces and SSH-based command execution. | `@openclaw/openshell-sandbox`<br />included in OpenClaw | plugin |
| [perplexity](/plugins/reference/perplexity) | Adds web search provider support. | `@openclaw/perplexity-plugin`<br />included in OpenClaw | contracts: webSearchProviders |
| [phone-control](/plugins/reference/phone-control) | Arm/disarm high-risk phone node commands (camera/screen/writes) with an optional auto-expiry. | `@openclaw/phone-control`<br />source checkout only | plugin |
| [qa-channel](/plugins/reference/qa-channel) | Adds the QA Channel surface for sending and receiving OpenClaw messages. | `@openclaw/qa-channel`<br />source checkout only | channels: qa-channel |
| [qa-lab](/plugins/reference/qa-lab) | OpenClaw QA lab plugin with private debugger UI and scenario runner. | `@openclaw/qa-lab`<br />source checkout only | plugin |
docs/plugins/reference.md:116
- This newly added
talk-voicerow uses inconsistent spacing before the|separators compared to neighboring rows, which can cause markdown table alignment lint failures. Please regenerate/format the table so pipes align consistently.
| [synology-chat](/plugins/reference/synology-chat) | Adds the Synology Chat channel surface for sending and receiving OpenClaw messages. | `@openclaw/synology-chat`<br />npm; ClawHub | channels: synology-chat |
| [synthetic](/plugins/reference/synthetic) | Adds Synthetic model provider support to OpenClaw. | `@openclaw/synthetic-provider`<br />included in OpenClaw | providers: synthetic |
| [talk-voice](/plugins/reference/talk-voice) | Manage Talk voice selection (list/set). | `@openclaw/talk-voice`<br />source checkout only | plugin |
| [tavily](/plugins/reference/tavily) | Adds agent-callable tools. Adds web search provider support. | `@openclaw/tavily-plugin`<br />included in OpenClaw | contracts: tools, webSearchProviders; skills |
docs/plugins/reference.md:120
- This newly added
thread-ownershiprow has inconsistent padding before the table separators compared to the rest of the table. Please normalize table formatting (ideally via the generator) to keep pipe alignment consistent and avoid markdownlint MD060 failures.
| [telegram](/plugins/reference/telegram) | Adds the Telegram channel surface for sending and receiving OpenClaw messages. | `@openclaw/telegram`<br />included in OpenClaw | channels: telegram |
| [tencent](/plugins/reference/tencent) | Adds Tencent TokenHub model provider support to OpenClaw. | `@openclaw/tencent-provider`<br />included in OpenClaw | providers: tencent-tokenhub |
| [thread-ownership](/plugins/reference/thread-ownership) | Prevents multiple agents from responding in the same Slack thread (HTTP calls to slack-forwarder ownership API). | `@openclaw/thread-ownership`<br />source checkout only | plugin |
| [tlon](/plugins/reference/tlon) | Adds the Tlon channel surface for sending and receiving OpenClaw messages. | `@openclaw/tlon`<br />npm; ClawHub | channels: tlon; contracts: tools; skills |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| ## Versioning | ||
|
|
||
| Each documented release tracks an OpenClaw stable release line. Docs-only rereleases append a suffix like `-1`, `-2`, etc. while keeping the same validated upstream release; same-base npm correction builds are noted inside the matching docs snapshot rather than treated as separate published GitHub releases: | ||
| - `v2026.5.7-3` (2026-05-13, docs correction) - Same upstream baseline as `v2026.5.7`; corrected channel defaults and key names (telegram error policy enum/cooldown, feishu pairing/chunking, matrix streaming `progress`, tlon `network.dangerouslyAllowPrivateNetwork`, bluebubbles audio default, qqbot STT-only), provider catalogs and aliases (anthropic CLI default to `claude-opus-4-7`, OpenAI TTS default to `alloy`, Groq catalog example, Moonshot `KIMI_API_KEY` alias, Z.AI `Z_AI_API_KEY` alias, xAI legacy aliases, OpenRouter ref list wording), added 5 missing source-only plugin entries (active-memory, device-pair, phone-control, talk-voice, thread-ownership), tightened SDK channel-branded seam list, restamped 10 analysis pages from `v2026.5.5` baseline to `v2026.5.7`, documented `exec` `timeout` clamp and `hex`/`literal` send-keys variants, refreshed plugin-publish snippet to `v2026.5.7` baseline, and refreshed prerelease exclusion notes through `v2026.5.12-beta.3` (source tag `v2026.5.10-beta.6` excluded). No upstream stable behavior changes. |
|
|
||
| ### Corrections | ||
|
|
||
| - **Channels (`v2026.5.7`):** corrected `telegram` error policy enum (`always|once|silent`) and the 14400000 ms (4 h) default cooldown; `feishu` outbound chunking default raised to `4000` chars and pairing default flagged; `matrix` streaming mode enum now lists `progress`; `tlon` private-network knob renamed to `network.dangerouslyAllowPrivateNetwork`; `bluebubbles` audio fallback default flipped to `true`; `qqbot` voice docs narrowed to STT-only (no TTS in v2026.5.7 source). |
Comment on lines
426
to
429
| | `channels.feishu.groups.<chat_id>.requireMention` | Per-group @mention override; explicit IDs also admit the group in allowlist mode | inherited | | ||
| | `channels.feishu.groups.<chat_id>.enabled` | Enable/disable a specific group | `true` | | ||
| | `channels.feishu.textChunkLimit` | Message chunk size | `2000` | | ||
| | `channels.feishu.textChunkLimit` | Message chunk size | `4000` | | ||
| | `channels.feishu.mediaMaxMb` | Media size limit | `30` | |
Comment on lines
190
to
+194
| ### Contact name enrichment (macOS, optional) | ||
|
|
||
| BlueBubbles group webhooks often only include raw participant addresses. If you want `GroupMembers` context to show local contact names instead, you can opt in to local Contacts enrichment on macOS: | ||
|
|
||
| - `channels.bluebubbles.enrichGroupParticipantsFromContacts = true` enables the lookup. Default: `false`. | ||
| - `channels.bluebubbles.enrichGroupParticipantsFromContacts = false` disables the lookup. Default: `true` (lookup enabled when running on macOS). |
Comment on lines
20
to
22
| | [acpx](/plugins/reference/acpx) | Embedded ACP runtime backend with plugin-owned session and transport management. | `@openclaw/acpx`<br />npm; ClawHub | skills | | ||
| | [active-memory](/plugins/reference/active-memory) | Runs a bounded blocking memory sub-agent before eligible conversational replies and injects relevant memory into prompt context. | `@openclaw/active-memory`<br />source checkout only | plugin | | ||
| | [alibaba](/plugins/reference/alibaba) | Adds video generation provider support. | `@openclaw/alibaba-provider`<br />included in OpenClaw | contracts: videoGenerationProviders | |
Comment on lines
173
to
+182
| | Plugin | Description | Distribution | Surface | | ||
| | ------------------------------------------- | ------------------------------------------------------------------------ | ------------------------------------------------ | -------------------- | | ||
| | [qa-channel](/plugins/reference/qa-channel) | Adds the QA Channel surface for sending and receiving OpenClaw messages. | `@openclaw/qa-channel`<br />source checkout only | channels: qa-channel | | ||
| | [qa-lab](/plugins/reference/qa-lab) | OpenClaw QA lab plugin with private debugger UI and scenario runner. | `@openclaw/qa-lab`<br />source checkout only | plugin | | ||
| | [qa-matrix](/plugins/reference/qa-matrix) | Matrix QA transport runner and substrate. | `@openclaw/qa-matrix`<br />source checkout only | plugin | | ||
| | [active-memory](/plugins/reference/active-memory) | Runs a bounded blocking memory sub-agent before eligible conversational replies and injects relevant memory into prompt context. | `@openclaw/active-memory`<br />source checkout only | plugin | | ||
| | [device-pair](/plugins/reference/device-pair) | Generate setup codes and approve device pairing requests. | `@openclaw/device-pair`<br />source checkout only | plugin | | ||
| | [phone-control](/plugins/reference/phone-control) | Arm/disarm high-risk phone node commands (camera/screen/writes) with an optional auto-expiry. | `@openclaw/phone-control`<br />source checkout only | plugin | | ||
| | [qa-channel](/plugins/reference/qa-channel) | Adds the QA Channel surface for sending and receiving OpenClaw messages. | `@openclaw/qa-channel`<br />source checkout only | channels: qa-channel | | ||
| | [qa-lab](/plugins/reference/qa-lab) | OpenClaw QA lab plugin with private debugger UI and scenario runner. | `@openclaw/qa-lab`<br />source checkout only | plugin | | ||
| | [qa-matrix](/plugins/reference/qa-matrix) | Matrix QA transport runner and substrate. | `@openclaw/qa-matrix`<br />source checkout only | plugin | | ||
| | [talk-voice](/plugins/reference/talk-voice) | Manage Talk voice selection (list/set). | `@openclaw/talk-voice`<br />source checkout only | plugin | | ||
| | [thread-ownership](/plugins/reference/thread-ownership) | Prevents multiple agents from responding in the same Slack thread (HTTP calls to slack-forwarder ownership API). | `@openclaw/thread-ownership`<br />source checkout only | plugin | |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Docs-only correction snapshot for the stable
v2026.5.7baseline. Same upstream behavior; no new fixes claimed.Corrections by topic
errorPolicyenum (always|once|silent) +errorCooldownMsdefault14400000(4 h); feishupairingdefault + outbound chunk default4000; matrix streaming mode enum gainedprogress; tlon knob renamed tonetwork.dangerouslyAllowPrivateNetwork; bluebubblesenrichGroupParticipantsFromContactsdefault flipped totrue; qqbot voice surface narrowed to STT-only (no TTS in v2026.5.7).claude-opus-4-7; OpenAI default TTS voice corrected toalloy; Groq catalog example replaced (Mixtral 8x7B→Mistral Saba 24B); Moonshot endpoint table accepts bothMOONSHOT_API_KEY+KIMI_API_KEY; Z.AI auth addsZ_AI_API_KEYalias; xAI legacygrok-4.20-experimental-beta-0304-*aliases restored; OpenRouter ref list reworded as illustrative; stray Z.AI line removed from Mistral page.discord,matrix,telegram-account,telegram-command-configonly).v2026.5.5baseline tov2026.5.7(2026-05-13).exectimeoutclamp andhex/literalsend-keys variants; refreshedsnippets/plugin-publish/minimal-package.jsonbaseline.v2026.5.12-beta.3(source tagv2026.5.10-beta.6is not a GitHub release).Verified against v2026.5.7 source
extensions/telegram/src/error-policy.ts:17extensions/feishu/src/config-schema.ts:242,outbound.ts:493,channel.ts:1286extensions/matrix/src/config-schema.ts:71extensions/tlon/src/config-schema.ts:18extensions/bluebubbles/src/config-schema.ts:84extensions/qqbot/src/config-schema.ts:80(stt only; no tts)extensions/anthropic/src/cli/cli-constants.ts:2,openclaw.plugin.json(claude-opus-4-7)extensions/openai/default-models.ts:11(OPENAI_DEFAULT_TTS_VOICE = "alloy")extensions/moonshot/openclaw.plugin.json:116(both env keys)extensions/zai/openclaw.plugin.json:26(both env keys)extensions/xai/openclaw.plugin.json:15-16(legacy aliases)src/agents/bash-tools.schemas.ts:56-71(exec timeout/hex/literal)Test plan
## OpenClaw v2026.5.7-3 — Docs Correction Summary**Current validated docs snapshot: v2026.5.7-3 ...**v2026.5.7-3 (2026-05-13)docs/plugins/reference.mdhas 120 plugin rowsPost-merge
v2026.5.7-3on the merged main commitgh release create v2026.5.7-3with notes drawn from this CHANGELOG section