Skip to content

fix #73713: surface nested embedding fetch failures#92628

Merged
vincentkoc merged 2 commits into
openclaw:mainfrom
mushuiyu886:feat/issue-73713
Jun 13, 2026
Merged

fix #73713: surface nested embedding fetch failures#92628
vincentkoc merged 2 commits into
openclaw:mainfrom
mushuiyu886:feat/issue-73713

Conversation

@mushuiyu886

@mushuiyu886 mushuiyu886 commented Jun 13, 2026

Copy link
Copy Markdown
Contributor

Summary

Real behavior proof

  • Behavior or issue addressed: The infer embedding create failure path no longer swallows the nested fetch cause/code at the shared CLI runtime boundary used by the embedding command.
  • Real environment tested: Local source checkout on Linux with Node v22.22.0, using the same runCommandWithRuntime(defaultRuntime, action) boundary called by openclaw infer embedding create.
  • Exact steps or command run after this patch:
cd /media/vdc/code/ai/aispace/openclaw-worktrees/issue-73713
node --import tsx /media/vdc/code/ai/aispace/openclaw-issue-73713-evidence/cli-error-cause-proof.mts
node scripts/run-vitest.mjs run src/cli/cli-utils.test.ts
node scripts/run-vitest.mjs run src/cli/capability-cli.test.ts src/cli/program/register.agent.test.ts src/cli/program/register.maintenance.test.ts src/cli/program/register.onboard.test.ts src/cli/program/register.setup.test.ts src/cli/program/register.configure.test.ts
pnpm tsgo:core:test
git diff --check
  • Evidence after fix:
CLI error cause proof at 2026-06-13T07:38:51.647Z
command_path=openclaw infer embedding create -> runCommandWithRuntime(defaultRuntime, action)
synthetic_top_error=TypeError: fetch failed
synthetic_cause_message=invalid onRequestStart method
synthetic_cause_code=UND_ERR_INVALID_ARG
runtime_error_message="TypeError: fetch failed | invalid onRequestStart method | UND_ERR_INVALID_ARG"
runtime_exit_codes=[1]
result=passed
[test] starting test/vitest/vitest.cli.config.ts

 RUN  v4.1.7 /media/vdc/code/ai/aispace/openclaw-worktrees/issue-73713

 Test Files  1 passed (1)
      Tests  44 passed (44)
$ node scripts/run-tsgo.mjs -p test/tsconfig/tsconfig.core.test.json --incremental --tsBuildInfoFile .artifacts/tsgo-cache/core-test.tsbuildinfo
Test Files  6 passed (6)
Tests  140 passed (140)
  • Observed result after fix: The default CLI runtime error message preserves the top-level TypeError: fetch failed, and also includes the nested invalid onRequestStart method and UND_ERR_INVALID_ARG code.
  • What was not tested: No live Voyage API request was sent, no real credential was used, and this local environment was Node v22.22.0 rather than Node 24. The proof targets the error-attribution boundary from the issue: a Node/Undici-style nested fetch failure now reaches CLI output.

Regression Test Plan

  • Target test file: src/cli/cli-utils.test.ts
  • Scenario locked in: A TypeError("fetch failed") with a nested cause carrying message: "invalid onRequestStart method" and code: "UND_ERR_INVALID_ARG" must be emitted by runCommandWithRuntime with the top-level TypeError: prefix, nested message, and nested code present.
  • Why this is the smallest reliable guardrail: openclaw infer embedding create uses this shared runtime wrapper, so this test locks the source CLI error boundary without needing live provider credentials or a network-dependent Node/Undici reproduction.

Merge risk

  • Risk labels considered: CLI error formatting, secret redaction, provider diagnostics.
  • Risk explanation: The change affects default CLI command failure output, so more nested cause detail may appear for other commands. The output still goes through the existing redacting formatter before printing, and custom onError handlers are unchanged.
  • Why acceptable: The patch is small, only changes failure diagnostics, preserves successful command behavior, and improves the shared source-of-truth path instead of adding a Voyage-specific string workaround.

Root Cause

  • Root cause: runCommandWithRuntime caught default command failures and printed String(err). For TypeError("fetch failed"), JavaScript stringification only includes the top-level error, so the source .cause chain from Node/Undici was discarded before the CLI output was written.
  • Why this is root-cause fix: This fixes the root cause because the source invariant is that CLI command failures should preserve the error attribution chain after provider/runtime layers attach it. The bug was caused at the shared CLI error boundary, not in Voyage request construction: the nested transport cause existed on the error object but was dropped by String(err). This patch changes that boundary directly by using the existing redacting formatter and extending the formatter to carry nested error codes while walking .cause.
  • Fix classification: Root cause fix.
  • Maintainer-ready confidence: High. The diff is limited to three files, the regression covers the exact Node/Undici-style nested fetch failure, and local proof exercises the same shared runtime wrapper used by the embedding CLI.
  • Patch quality notes: This is not a downstream provider workaround or a catch-all fallback. The shared CLI runtime already owns default command error rendering; the patch preserves diagnostic source information that was already attached to the thrown error.
  • Architecture / source-of-truth check: src/cli/cli-utils.ts is the source boundary for default CLI command failure rendering, and src/infra/errors.ts is the shared redacting formatter. Provider transport code remains owned by the memory host SDK and fetch guard layers.

@openclaw-barnacle openclaw-barnacle Bot added cli CLI command changes size: XS proof: supplied External PR includes structured after-fix real behavior proof. labels Jun 13, 2026
@clawsweeper

clawsweeper Bot commented Jun 13, 2026

Copy link
Copy Markdown
Contributor

Codex review: needs maintainer review before merge. Reviewed June 13, 2026, 4:31 AM ET / 08:31 UTC.

Summary
This PR changes shared CLI command error rendering to use redacted cause-chain formatting, adds nested error code output, and adds a regression test for a TypeError fetch-failed cause chain.

PR surface: Source +11, Tests +28. Total +39 across 3 files.

Reproducibility: yes. source-level: current main routes openclaw infer embedding create through runCommandWithRuntime, and that wrapper prints String(err), so an Error.cause chain on TypeError('fetch failed') is dropped. I did not run a live Voyage request in this read-only review.

Review metrics: 2 noteworthy metrics.

  • Closing reference scope: 1 linked issue. The linked issue includes both diagnostic surfacing and successful embedding-request expectations, so maintainers should decide whether this PR should auto-close it.
  • Shared CLI failure renderer: 1 default runtime boundary changed. All commands using runCommandWithRuntime without a custom onError inherit the new redacted cause-chain output.

Merge readiness
Overall: 🐚 platinum hermit
Proof: 🐚 platinum hermit
Patch quality: 🐚 platinum hermit
Result: ready for maintainer review.

Overall follows the weaker of proof and patch quality, so missing proof can cap an otherwise strong patch.

Rank-up moves:

  • [P2] Decide whether to remove or revise the closing reference so the linked issue can remain open for the Node 24/Voyage success-path audit if needed.

Risk before merge

Maintainer options:

  1. Narrow the issue-closing scope (recommended)
    Remove or revise the closing reference, or otherwise keep openclaw infer embedding create fails with TypeError: fetch failed on Node 24 despite valid Voyage credential; underlying cause is swallowed #73713 open for the Node 24/Voyage success-path audit while merging this diagnostic fix.
  2. Accept the broader close
    Maintainers can intentionally let this PR close the linked issue if they agree improved diagnostics fully satisfies the remaining report.
  3. Pause for live Voyage proof
    Hold merge until a Node 24/Voyage run verifies whether the original success-path failure still exists after the diagnostic fix.

Next step before merge

  • [P2] The remaining action is maintainer judgment on issue-closing scope and shared CLI diagnostic-output compatibility, not an automated code repair.

Security
Cleared: The diff only changes redacted CLI error formatting and a focused test; it adds no dependency, workflow, credential, permission, or code-execution surface.

Review details

Best possible solution:

Merge the shared diagnostic fix after maintainers either remove or revise the closing reference, or intentionally decide that the linked issue should close despite the remaining Voyage/Node 24 success-path question.

Do we have a high-confidence way to reproduce the issue?

Yes, source-level: current main routes openclaw infer embedding create through runCommandWithRuntime, and that wrapper prints String(err), so an Error.cause chain on TypeError('fetch failed') is dropped. I did not run a live Voyage request in this read-only review.

Is this the best way to solve the issue?

Mostly yes for the diagnostic part: the shared CLI runtime plus the existing redacting formatter is the narrow maintainable boundary. It is not a complete resolution for the linked issue's successful Voyage embedding path, so the issue-closing scope needs maintainer review.

AGENTS.md: found and applied where relevant.

Codex review notes: model internal, reasoning high; reviewed against 7bd533a80e9d.

Label changes

Label changes:

  • add proof: sufficient: Contributor real behavior proof is sufficient. The PR body includes copied after-fix output from a local source checkout exercising the changed runCommandWithRuntime boundary and observing the nested message/code in CLI-style output.

Label justifications:

  • P2: This is a normal-priority CLI diagnostics bug fix with limited blast radius, not data loss, security bypass, crash-loop, or broken channel delivery.
  • merge-risk: 🚨 compatibility: The PR changes shared user-visible CLI failure text and may close a broader issue before the Voyage/Node 24 success-path audit is settled.
  • rating: 🐚 platinum hermit: Overall readiness is 🐚 platinum hermit; proof is 🐚 platinum hermit and patch quality is 🐚 platinum hermit.
  • status: 👀 ready for maintainer look: ClawSweeper has no concrete contributor-facing blocker left for this PR. Sufficient (live_output): The PR body includes copied after-fix output from a local source checkout exercising the changed runCommandWithRuntime boundary and observing the nested message/code in CLI-style output.
  • proof: sufficient: Contributor real behavior proof is sufficient. The PR body includes copied after-fix output from a local source checkout exercising the changed runCommandWithRuntime boundary and observing the nested message/code in CLI-style output.
Evidence reviewed

PR surface:

Source +11, Tests +28. Total +39 across 3 files.

View PR surface stats
Area Files Added Removed Net
Source 2 12 1 +11
Tests 1 28 0 +28
Docs 0 0 0 0
Config 0 0 0 0
Generated 0 0 0 0
Other 0 0 0 0
Total 3 40 1 +39

What I checked:

  • Repository policy read: Root AGENTS.md was read fully; its PR review guidance requires checking the changed function/module, callers, tests, dependency contracts, and owner history before verdict. (AGENTS.md:1, 7bd533a80e9d)
  • Current main drops nested causes at the shared CLI boundary: On current main, runCommandWithRuntime catches default failures and prints String(err), which loses an Error.cause chain attached to TypeError('fetch failed'). (src/cli/cli-utils.ts:47, 7bd533a80e9d)
  • Embedding create uses that boundary: The reported openclaw infer embedding create path calls runCommandWithRuntime(defaultRuntime, ...) around runMemoryEmbeddingCreate. (src/cli/capability-cli.ts:2789, 7bd533a80e9d)
  • PR head changes the default renderer: The PR head adds formatCommandRuntimeError and routes default runtime errors through formatErrorMessage while preserving the top-level Error/TypeError prefix. (src/cli/cli-utils.ts:35, 93e477a606a3)
  • PR head includes nested cause codes: formatErrorMessage now appends extractErrorCode(cause) while walking Error.cause, then returns the already-redacted formatted text. (src/infra/errors.ts:89, 93e477a606a3)
  • Regression coverage matches the diagnostic invariant: The new test throws TypeError('fetch failed') with a nested UND_ERR_INVALID_ARG cause and asserts the top-level prefix, nested message, nested code, and exit code. (src/cli/cli-utils.test.ts:37, 93e477a606a3)

Likely related people:

  • @joshavant: Current-main blame for runCommandWithRuntime, formatErrorMessage, and the embedding create wrapper points to d9124c9 / fix doctor channel SecretRef preview, a recent broad commit carrying all three central files. (role: recent area contributor; confidence: high; commits: d9124c970085; files: src/cli/cli-utils.ts, src/infra/errors.ts, src/cli/capability-cli.ts)
  • @steipete: The shared cli-utils file and early formatErrorMessage/withManager helper were introduced in b44d740, and later git log -S formatErrorMessage entries show related error-formatting work by Peter Steinberger. (role: original shared CLI utility contributor; confidence: medium; commits: b44d74072057, c2e2b87f28f0, e81ca7ab00ae; files: src/cli/cli-utils.ts, src/infra/errors.ts)
What the crustacean ranks mean
  • 🦀 challenger crab: rare, exceptional readiness with strong proof, clean implementation, and convincing validation.
  • 🦞 diamond lobster: very strong readiness with only minor maintainer review expected.
  • 🐚 platinum hermit: good normal PR, likely mergeable with ordinary maintainer review.
  • 🦐 gold shrimp: useful signal, but proof or patch confidence is still limited.
  • 🦪 silver shellfish: thin signal; proof, validation, or implementation needs work.
  • 🧂 unranked krab: not merge-ready because proof is missing/unusable or there are serious correctness or safety concerns.
  • 🌊 off-meta tidepool: rating does not apply to this item.

Shiny media proof means a screenshot, video, or linked artifact directly shows the changed behavior. Runtime, network, CSP, and security claims still need visible diagnostics.

How this review workflow works
  • ClawSweeper keeps one durable marker-backed review comment per issue or PR.
  • Re-runs edit this comment so the latest verdict, findings, and automation markers stay together instead of adding duplicate bot comments.
  • A fresh review can be triggered by eligible @clawsweeper re-review comments, exact-item GitHub events, scheduled/background review runs, or manual workflow dispatch.
  • PR/issue authors and users with repository write access can comment @clawsweeper re-review or @clawsweeper re-run on an open PR or issue to request a fresh review only.
  • Maintainers can also comment @clawsweeper review to request a fresh review only.
  • Fresh-review commands do not start repair, autofix, rebase, CI repair, or automerge.
  • Maintainer-only repair and merge flows require explicit commands such as @clawsweeper autofix, @clawsweeper automerge, @clawsweeper fix ci, or @clawsweeper address review.
  • Maintainers can comment @clawsweeper explain to ask for more context, or @clawsweeper stop to stop active automation.

@clawsweeper clawsweeper Bot added proof: sufficient ClawSweeper judged the real behavior proof convincing. rating: 🐚 platinum hermit Good normal PR readiness with ordinary maintainer review expected. status: 👀 ready for maintainer look ClawSweeper has no concrete contributor-facing blocker left for this PR. P2 Normal backlog priority with limited blast radius. labels Jun 13, 2026
@openclaw-barnacle openclaw-barnacle Bot removed the proof: sufficient ClawSweeper judged the real behavior proof convincing. label Jun 13, 2026
@clawsweeper clawsweeper Bot added proof: sufficient ClawSweeper judged the real behavior proof convincing. merge-risk: 🚨 compatibility 🚨 May break existing users, config, migrations, defaults, or upgrade paths. labels Jun 13, 2026
@openclaw-barnacle openclaw-barnacle Bot removed the proof: sufficient ClawSweeper judged the real behavior proof convincing. label Jun 13, 2026
@clawsweeper clawsweeper Bot added the proof: sufficient ClawSweeper judged the real behavior proof convincing. label Jun 13, 2026
@openclaw-barnacle openclaw-barnacle Bot removed the proof: sufficient ClawSweeper judged the real behavior proof convincing. label Jun 13, 2026

@vincentkoc vincentkoc left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No blocking findings.

What changed: default CLI command error handling now routes through the redaction-aware formatter while preserving the top-level Error: / TypeError: prefix, and nested cause error codes are included in formatted cause chains. This directly addresses #73713's swallowed Undici root-cause diagnostics without changing provider selection, dispatcher policy, SSRF guard behavior, request construction, or successful embedding responses.

Best-fix verdict: best for this PR scope. Alternatives considered: patching only the embedding CLI would leave the same default-runtime swallowing path in other CLI commands; changing formatErrorMessage globally to include error names would churn user-facing messages across broader surfaces. The PR keeps the name-prefix compatibility local to command-runtime output and adds the missing nested code at the shared cause-chain formatter.

Verification:

  • git diff --check origin/main...HEAD
  • node_modules/.bin/oxfmt --check src/cli/cli-utils.ts src/cli/cli-utils.test.ts src/infra/errors.ts src/infra/errors.test.ts
  • node scripts/run-oxlint.mjs src/cli/cli-utils.ts src/cli/cli-utils.test.ts src/infra/errors.ts src/infra/errors.test.ts
  • .agents/skills/autoreview/scripts/autoreview --mode branch --base origin/main — clean, no accepted/actionable findings
  • Azure Crabbox cbx_851fd0e2a8d6 / run run_b672e34ea9db: node scripts/run-vitest.mjs src/cli/cli-utils.test.ts src/infra/errors.test.ts — 68 tests passed; lease stopped
  • GitHub exact head 9e8cdcbc94cf81f23d6a54ff970e80e2c1c493bd: 129 successful, 0 failing, 2 pending tail checks when reviewed

@vincentkoc
vincentkoc merged commit 6cdbcca into openclaw:main Jun 13, 2026
160 of 162 checks passed
github-actions Bot pushed a commit to Desicool/openclaw that referenced this pull request Jun 14, 2026
…#92628)

* fix(cli): surface nested fetch failure details

* fix(cli): preserve error prefixes in runtime output
eleboucher pushed a commit to eleboucher/homelab that referenced this pull request Jun 16, 2026
…26.6.8) (#1144)

This PR contains the following updates:

| Package | Update | Change |
|---|---|---|
| [ghcr.io/openclaw/openclaw](https://openclaw.ai) ([source](https://github.com/openclaw/openclaw)) | patch | `2026.6.6` → `2026.6.8` |

---

### Release Notes

<details>
<summary>openclaw/openclaw (ghcr.io/openclaw/openclaw)</summary>

### [`v2026.6.8`](https://github.com/openclaw/openclaw/blob/HEAD/CHANGELOG.md#202668)

[Compare Source](openclaw/openclaw@v2026.6.6...v2026.6.8)

##### Highlights

- Telegram and WhatsApp channel delivery are richer and less brittle: Telegram can send structured rich text with tables, lists, expandable blockquotes, prompt-preserving CLI backend delivery, retired native draft migration, and safer rich-media boundaries, while WhatsApp now honors configured ACP bindings. ([#&#8203;92679](openclaw/openclaw#92679), [#&#8203;84082](openclaw/openclaw#84082), [#&#8203;89421](openclaw/openclaw#89421), [#&#8203;92513](openclaw/openclaw#92513)) Thanks [@&#8203;obviyus](https://github.com/obviyus), [@&#8203;jzakirov](https://github.com/jzakirov), [@&#8203;spacegeologist](https://github.com/spacegeologist), and [@&#8203;TurboTheTurtle](https://github.com/TurboTheTurtle).
- Agent and Gateway recovery is sharper across account-scoped DM sends, generated media completions, restart shutdown aborts, yielded subagent pauses, yielded cron media, heartbeat dedupe, session identity prompts, and unknown OpenAI agent selector rejection. ([#&#8203;92788](openclaw/openclaw#92788), [#&#8203;91246](openclaw/openclaw#91246), [#&#8203;91357](openclaw/openclaw#91357), [#&#8203;92631](openclaw/openclaw#92631), [#&#8203;92146](openclaw/openclaw#92146), [#&#8203;91287](openclaw/openclaw#91287), [#&#8203;92468](openclaw/openclaw#92468), [#&#8203;92510](openclaw/openclaw#92510)) Thanks [@&#8203;yetval](https://github.com/yetval), [@&#8203;TurboTheTurtle](https://github.com/TurboTheTurtle), [@&#8203;ooiuuii](https://github.com/ooiuuii), [@&#8203;openperf](https://github.com/openperf), [@&#8203;IWhatsskill](https://github.com/IWhatsskill), [@&#8203;ZengWen-DT](https://github.com/ZengWen-DT), and [@&#8203;zhangguiping-xydt](https://github.com/zhangguiping-xydt).
- Provider/model handling expands and tightens with GLM-5.2, Claude Haiku 4.5 catalog rows, OpenRouter and Google Vertex provider-prefix normalization, managed SecretRef auth, bounded model browse discovery, storeless OpenAI Responses replay gating, and Claude 4.5 Copilot tool-streaming safety. ([#&#8203;92796](openclaw/openclaw#92796), [#&#8203;90116](openclaw/openclaw#90116), [#&#8203;92627](openclaw/openclaw#92627), [#&#8203;91218](openclaw/openclaw#91218), [#&#8203;90686](openclaw/openclaw#90686), [#&#8203;92247](openclaw/openclaw#92247), [#&#8203;90706](openclaw/openclaw#90706), [#&#8203;75393](openclaw/openclaw#75393)) Thanks [@&#8203;arkyu2077](https://github.com/arkyu2077), [@&#8203;liuhao1024](https://github.com/liuhao1024), [@&#8203;bymle](https://github.com/bymle), [@&#8203;rohitjavvadi](https://github.com/rohitjavvadi), [@&#8203;samson910022](https://github.com/samson910022), [@&#8203;snowzlm](https://github.com/snowzlm), and [@&#8203;Kailigithub](https://github.com/Kailigithub).
- `/usage` and reply payload hooks now have a native full footer renderer, default template, fixed-decimal formatting, credential-aware limits, better partial-count handling, and warnings for broken templates instead of silent bad output. ([#&#8203;92657](openclaw/openclaw#92657), [#&#8203;89835](openclaw/openclaw#89835), [#&#8203;89629](openclaw/openclaw#89629)) Thanks [@&#8203;Marvinthebored](https://github.com/Marvinthebored).
- UI and mobile flows are steadier: workspace files can collapse and start collapsed, WebChat backscroll survives streaming, the sidebar session picker remains interactive above the desktop workbench, reset soft args survive UI dispatch, stale dashboard session parent lineage is preserved, and iOS reconnects stale foreground gateways. ([#&#8203;92779](openclaw/openclaw#92779), [#&#8203;92622](openclaw/openclaw#92622), [#&#8203;92705](openclaw/openclaw#92705), [#&#8203;91353](openclaw/openclaw#91353), [#&#8203;90658](openclaw/openclaw#90658), [#&#8203;92552](openclaw/openclaw#92552)) Thanks [@&#8203;shakkernerd](https://github.com/shakkernerd), [@&#8203;TurboTheTurtle](https://github.com/TurboTheTurtle), [@&#8203;NianJiuZst](https://github.com/NianJiuZst), [@&#8203;zhouhe-xydt](https://github.com/zhouhe-xydt), [@&#8203;luoyanglang](https://github.com/luoyanglang), and [@&#8203;Solvely-Colin](https://github.com/Solvely-Colin).
- Memory, state, and diagnostics recover cleaner: oversized OpenAI embedding batches split before 431s, QMD memory search stays available in transient mode, SQLite avoids WAL on NFS state volumes, stuck-session recovery scheduling no longer resets warning backoff, and Infinity chunk limits stay genuinely unbounded. ([#&#8203;92650](openclaw/openclaw#92650), [#&#8203;92618](openclaw/openclaw#92618), [#&#8203;92639](openclaw/openclaw#92639), [#&#8203;91247](openclaw/openclaw#91247), [#&#8203;92752](openclaw/openclaw#92752), [#&#8203;92735](openclaw/openclaw#92735)) Thanks [@&#8203;mushuiyu886](https://github.com/mushuiyu886), [@&#8203;TurboTheTurtle](https://github.com/TurboTheTurtle), [@&#8203;849261680](https://github.com/849261680), [@&#8203;gnanam1990](https://github.com/gnanam1990), and [@&#8203;yhterrance](https://github.com/yhterrance).

##### Changes

- Providers/models: add GLM-5.2 support and Claude Haiku 4.5 catalog entries while keeping provider-qualified model IDs normalized across OpenRouter and Google Vertex paths. ([#&#8203;92796](openclaw/openclaw#92796), [#&#8203;90116](openclaw/openclaw#90116), [#&#8203;92627](openclaw/openclaw#92627), [#&#8203;91218](openclaw/openclaw#91218)) Thanks [@&#8203;arkyu2077](https://github.com/arkyu2077), [@&#8203;liuhao1024](https://github.com/liuhao1024), and [@&#8203;bymle](https://github.com/bymle).
- Channel plugins: ship Telegram rich-message delivery and WhatsApp ACP binding support, including rich prompt handoff to CLI backends and transport fixtures for richer drafts. ([#&#8203;92679](openclaw/openclaw#92679), [#&#8203;92513](openclaw/openclaw#92513)) Thanks [@&#8203;obviyus](https://github.com/obviyus) and [@&#8203;TurboTheTurtle](https://github.com/TurboTheTurtle).
- Agent commands: support `/btw` in CLI-backed sessions and keep CLI usage-error exits classified as usage failures instead of successful runs. ([#&#8203;92669](openclaw/openclaw#92669), [#&#8203;92162](openclaw/openclaw#92162)) Thanks [@&#8203;joshavant](https://github.com/joshavant) and [@&#8203;Pandah97](https://github.com/Pandah97).
- Usage hooks: add built-in full footer rendering, default footer templates, per-turn usage state, credential-aware limits, and fixed-decimal formatting for usage-bar templates. ([#&#8203;92657](openclaw/openclaw#92657), [#&#8203;89835](openclaw/openclaw#89835), [#&#8203;89629](openclaw/openclaw#89629)) Thanks [@&#8203;Marvinthebored](https://github.com/Marvinthebored).
- Docs and operator guidance: document node config examples, clarify before-install hook scope, correct agent default concurrency comments, refresh ZAI provider docs, and update channel/group docs for current Telegram and WhatsApp behavior. ([#&#8203;92677](openclaw/openclaw#92677), [#&#8203;92766](openclaw/openclaw#92766), [#&#8203;92695](openclaw/openclaw#92695)) Thanks [@&#8203;liuhao1024](https://github.com/liuhao1024), [@&#8203;sallyom](https://github.com/sallyom), and [@&#8203;ArielSmoliar](https://github.com/ArielSmoliar).

##### Fixes

- Onboarding/skills: show the Homebrew install recommendation only on macOS and Linux, so FreeBSD and other unsupported platforms no longer get a misleading brew prompt. Fixes [#&#8203;68893](openclaw/openclaw#68893); carries forward [#&#8203;68894](openclaw/openclaw#68894), [#&#8203;68910](openclaw/openclaw#68910), [#&#8203;68941](openclaw/openclaw#68941), [#&#8203;68943](openclaw/openclaw#68943), [#&#8203;69002](openclaw/openclaw#69002), and [#&#8203;69545](openclaw/openclaw#69545). Thanks [@&#8203;yurivict](https://github.com/yurivict), [@&#8203;Sanjays2402](https://github.com/Sanjays2402), [@&#8203;Eruditi](https://github.com/Eruditi), [@&#8203;JustInCache](https://github.com/JustInCache), [@&#8203;nnish16](https://github.com/nnish16), and [@&#8203;Mlightsnow](https://github.com/Mlightsnow).
- Channels and delivery: preserve account-scoped DM channel send policy, rich Telegram final replies, rich Telegram tables and lists, Telegram thread-create CLI remapping, Slack outbound `message_sent` hooks, contributed message-tool schema optionality, same-channel generated media completions, and channel chunking around surrogate pairs and Infinity limits. ([#&#8203;92788](openclaw/openclaw#92788), [#&#8203;92679](openclaw/openclaw#92679), [#&#8203;89421](openclaw/openclaw#89421), [#&#8203;89943](openclaw/openclaw#89943), [#&#8203;91137](openclaw/openclaw#91137), [#&#8203;91246](openclaw/openclaw#91246), [#&#8203;92735](openclaw/openclaw#92735)) Thanks [@&#8203;yetval](https://github.com/yetval), [@&#8203;obviyus](https://github.com/obviyus), [@&#8203;spacegeologist](https://github.com/spacegeologist), [@&#8203;rishitamrakar](https://github.com/rishitamrakar), [@&#8203;lundog](https://github.com/lundog), [@&#8203;TurboTheTurtle](https://github.com/TurboTheTurtle), and [@&#8203;yhterrance](https://github.com/yhterrance).
- Auto-reply/groups: keep ordinary group text replies on automatic final-reply delivery while allowing `message(action=send)` for files, images, and other attachments to the same group or topic. Carries forward [#&#8203;43276](openclaw/openclaw#43276); refs [#&#8203;48004](openclaw/openclaw#48004). Thanks [@&#8203;NayukiChiba](https://github.com/NayukiChiba) and [@&#8203;ShakaRover](https://github.com/ShakaRover).
- Auto-reply/skills: preserve multiline payloads for `/skill` and direct skill slash commands while keeping command-head normalization for aliases, colon syntax, and bot mentions. Fixes [#&#8203;79155](openclaw/openclaw#79155); carries forward [#&#8203;81305](openclaw/openclaw#81305). Thanks [@&#8203;web3blind](https://github.com/web3blind).
- iMessage: normalize leading NUL sent-message echo prefixes while preserving interior NUL bytes and the leading attributedBody marker handling from [#&#8203;73942](openclaw/openclaw#73942). Carries forward [#&#8203;63581](openclaw/openclaw#63581). Thanks [@&#8203;drvoss](https://github.com/drvoss).
- Discord: give generated auto-thread titles a 60-second timeout and 4,096-token reasoning-model output budget, clamped to the selected model output cap. ([#&#8203;64734](openclaw/openclaw#64734)) Thanks [@&#8203;hanamizuki](https://github.com/hanamizuki).
- Agent, cron, and Gateway runtime: mark active main sessions before restart shutdown aborts, pause yielded subagent runs whose terminal also signals abort, preserve yielded media completions, de-duplicate main-session heartbeat events, expose session identity in runtime prompts, reject unknown OpenAI agent selectors, keep generated media completions and slash-command block replies in WebChat, preserve fresh post-compaction usage while clearing stale usage snapshots, and require admin privileges for HTTP session/model override surfaces. ([#&#8203;91357](openclaw/openclaw#91357), [#&#8203;92631](openclaw/openclaw#92631), [#&#8203;92146](openclaw/openclaw#92146), [#&#8203;91287](openclaw/openclaw#91287), [#&#8203;92468](openclaw/openclaw#92468), [#&#8203;92510](openclaw/openclaw#92510), [#&#8203;91246](openclaw/openclaw#91246), [#&#8203;50795](openclaw/openclaw#50795), [#&#8203;50845](openclaw/openclaw#50845), [#&#8203;82874](openclaw/openclaw#82874), [#&#8203;92651](openclaw/openclaw#92651), [#&#8203;92646](openclaw/openclaw#92646)) Thanks [@&#8203;ooiuuii](https://github.com/ooiuuii), [@&#8203;openperf](https://github.com/openperf), [@&#8203;IWhatsskill](https://github.com/IWhatsskill), [@&#8203;ZengWen-DT](https://github.com/ZengWen-DT), [@&#8203;zhangguiping-xydt](https://github.com/zhangguiping-xydt), [@&#8203;Hollychou924](https://github.com/Hollychou924), [@&#8203;leno23](https://github.com/leno23), and [@&#8203;TurboTheTurtle](https://github.com/TurboTheTurtle).
- Agents/exec: default empty-success background completion notices on only for real chat channels, preserving explicit opt-outs and keeping generic providers silent while carrying forward the narrow UX intent from [#&#8203;39726](openclaw/openclaw#39726) and [#&#8203;46926](openclaw/openclaw#46926). Thanks [@&#8203;Sapientropic](https://github.com/Sapientropic) and [@&#8203;wenkang-xie](https://github.com/wenkang-xie).
- Providers and model replay: preserve storeless OpenAI Responses replay compatibility, avoid eager tool streaming for Claude 4.5 in Copilot, honor profile auth for SecretRef model entries, bound model browsing, strip provider prefixes where runtimes need bare IDs, and surface nested embedding fetch failures. ([#&#8203;90706](openclaw/openclaw#90706), [#&#8203;75393](openclaw/openclaw#75393), [#&#8203;90686](openclaw/openclaw#90686), [#&#8203;92247](openclaw/openclaw#92247), [#&#8203;92627](openclaw/openclaw#92627), [#&#8203;91218](openclaw/openclaw#91218), [#&#8203;92628](openclaw/openclaw#92628)) Thanks [@&#8203;snowzlm](https://github.com/snowzlm), [@&#8203;Kailigithub](https://github.com/Kailigithub), [@&#8203;rohitjavvadi](https://github.com/rohitjavvadi), [@&#8203;samson910022](https://github.com/samson910022), [@&#8203;liuhao1024](https://github.com/liuhao1024), [@&#8203;bymle](https://github.com/bymle), and [@&#8203;mushuiyu886](https://github.com/mushuiyu886).
- Memory, state, diagnostics, and config: split header-too-large embedding batches, keep QMD memory search enabled in transient mode, avoid SQLite WAL on NFS volumes, preserve recovery scheduling outside stuck-session warning backoff, and keep shell environment fallbacks contained in config write tests. ([#&#8203;92650](openclaw/openclaw#92650), [#&#8203;92618](openclaw/openclaw#92618), [#&#8203;92639](openclaw/openclaw#92639), [#&#8203;91247](openclaw/openclaw#91247), [#&#8203;92752](openclaw/openclaw#92752)) Thanks [@&#8203;mushuiyu886](https://github.com/mushuiyu886), [@&#8203;TurboTheTurtle](https://github.com/TurboTheTurtle), [@&#8203;849261680](https://github.com/849261680), and [@&#8203;gnanam1990](https://github.com/gnanam1990).
- Workspace setup state: store setup completion outside the workspace dot directory using an OpenClaw-named root file, migrate valid legacy state forward, and avoid clobbering generic root `workspace-state.json` files for TigerFS-style dot-path compatibility. This Clownfish replacement carries forward the focused [#&#8203;53326](openclaw/openclaw#53326) fix idea because the original branch was closed and uneditable. ([#&#8203;53326](openclaw/openclaw#53326), [#&#8203;44783](openclaw/openclaw#44783), [#&#8203;39446](openclaw/openclaw#39446)) Thanks [@&#8203;1qh](https://github.com/1qh).
- UI/mobile/TUI: preserve dashboard session parent lineage, WebChat backscroll, reset soft command args, sidebar session picker interactivity, collapsed workspace files, resolved `/model` confirmation refs, and stale foreground iOS Gateway reconnects. ([#&#8203;90658](openclaw/openclaw#90658), [#&#8203;92622](openclaw/openclaw#92622), [#&#8203;91353](openclaw/openclaw#91353), [#&#8203;92705](openclaw/openclaw#92705), [#&#8203;92779](openclaw/openclaw#92779), [#&#8203;92773](openclaw/openclaw#92773), [#&#8203;92552](openclaw/openclaw#92552)) Thanks [@&#8203;luoyanglang](https://github.com/luoyanglang), [@&#8203;TurboTheTurtle](https://github.com/TurboTheTurtle), [@&#8203;zhouhe-xydt](https://github.com/zhouhe-xydt), [@&#8203;NianJiuZst](https://github.com/NianJiuZst), [@&#8203;shakkernerd](https://github.com/shakkernerd), [@&#8203;NarahariRaghava](https://github.com/NarahariRaghava), and [@&#8203;Solvely-Colin](https://github.com/Solvely-Colin).
- TUI: reload the active session after external `/new` or `/reset` session-change events so stale transcript and stream state clear promptly. Fixes [#&#8203;38966](openclaw/openclaw#38966); carries forward [#&#8203;40472](openclaw/openclaw#40472). Thanks [@&#8203;yizhanzjz](https://github.com/yizhanzjz) and [@&#8203;wsyjh8](https://github.com/wsyjh8).
- Control UI: preserve Gateway Access tokens during same-normalized WebSocket URL edits and reload gateway-scoped tokens when switching endpoints. Fixes [#&#8203;41545](openclaw/openclaw#41545); repairs [#&#8203;42001](openclaw/openclaw#42001) with additional source PRs [#&#8203;41546](openclaw/openclaw#41546), [#&#8203;41552](openclaw/openclaw#41552), and [#&#8203;41718](openclaw/openclaw#41718). Thanks [@&#8203;wsyjh8](https://github.com/wsyjh8), [@&#8203;llagy0020](https://github.com/llagy0020), [@&#8203;llagy007](https://github.com/llagy007), [@&#8203;pingfanfan](https://github.com/pingfanfan), and [@&#8203;zheliu2](https://github.com/zheliu2).
- Gateway CLI: tolerate a single transient clean WebSocket close before `hello-ok` so one-shot RPC calls reconnect instead of failing noisily, while repeated clean pre-hello closes still surface. Carries forward source PRs [#&#8203;54475](openclaw/openclaw#54475) and [#&#8203;54774](openclaw/openclaw#54774); [#&#8203;85253](openclaw/openclaw#85253) covered adjacent connect assembly diagnostics. Thanks [@&#8203;ruanrrn](https://github.com/ruanrrn).
- Gateway/Linux: keep root-owned systemd user service lifecycle commands on root's user manager when a stale `SUDO_USER` remains in a root shell with root's user bus environment. Fixes [#&#8203;81410](openclaw/openclaw#81410). Thanks [@&#8203;Ericksza](https://github.com/Ericksza) and [@&#8203;ChuckClose-tech](https://github.com/ChuckClose-tech).
- Release and test reliability: extend slow Gateway/full-suite watchdogs, split local full-suite shards when throttled, stabilize plugin auth marker fixtures, avoid brittle provider-ref error text, and keep QA Lab bootstrap selection assertions aligned with flow-only scenarios. ([#&#8203;92652](openclaw/openclaw#92652))
- macOS Peekaboo bridge: update the embedded Peekaboo package to 3.5.2 and route bundled-skill CLI commands through the OpenClaw app bridge so they inherit its Screen Recording and Accessibility grants.
- Agent routing: route subagent RPC callbacks addressed to an agent-shaped `--to` target to the correct session key instead of falling back to the main session, so WeChat (and other channel) session-key callbacks reach the intended subagent session. ([#&#8203;90231](openclaw/openclaw#90231)) Thanks [@&#8203;zhangguiping-xydt](https://github.com/zhangguiping-xydt).
- Cron: preserve model, fallback, thinking, timeout, light-context, unsafe-content, and tool allow-list overrides on implicit text payloads by promoting them to agent turns, while explicit system events still prune those fields. Fixes [#&#8203;28905](openclaw/openclaw#28905); carries forward [#&#8203;64060](openclaw/openclaw#64060) and [#&#8203;73946](openclaw/openclaw#73946). Thanks [@&#8203;liaoandi](https://github.com/liaoandi).
- QQBot delivery: keep markdown table chunks self-contained across message boundaries by preserving table state across block deliveries, flushing unfinished table-row fragments as plain text, and detecting short pipe-terminated rows by column count so split rows are not sent as malformed markdown. ([#&#8203;92428](openclaw/openclaw#92428)) Thanks [@&#8203;sliverp](https://github.com/sliverp).

</details>

---

### Configuration

📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied.

♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 **Ignore**: Close this PR and you won't be reminded about these updates again.

---

 - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box

---

This PR has been generated by [Renovate Bot](https://github.com/renovatebot/renovate).
<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiI0My4xMDEuMSIsInVwZGF0ZWRJblZlciI6IjQzLjEwMS4xIiwidGFyZ2V0QnJhbmNoIjoibWFpbiIsImxhYmVscyI6WyJyZW5vdmF0ZS9jb250YWluZXIiLCJ0eXBlL3BhdGNoIl19-->

Reviewed-on: https://git.erwanleboucher.dev/eleboucher/homelab/pulls/1144
wangmiao0668000666 pushed a commit to wangmiao0668000666/openclaw that referenced this pull request Jun 17, 2026
…#92628)

* fix(cli): surface nested fetch failure details

* fix(cli): preserve error prefixes in runtime output
badgerbees pushed a commit to badgerbees/openclaw that referenced this pull request Jul 8, 2026
…#92628)

* fix(cli): surface nested fetch failure details

* fix(cli): preserve error prefixes in runtime output
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cli CLI command changes merge-risk: 🚨 compatibility 🚨 May break existing users, config, migrations, defaults, or upgrade paths. P2 Normal backlog priority with limited blast radius. proof: supplied External PR includes structured after-fix real behavior proof. rating: 🐚 platinum hermit Good normal PR readiness with ordinary maintainer review expected. size: XS status: 👀 ready for maintainer look ClawSweeper has no concrete contributor-facing blocker left for this PR.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

openclaw infer embedding create fails with TypeError: fetch failed on Node 24 despite valid Voyage credential; underlying cause is swallowed

2 participants