Issue Station
Sign In
Tools hereToolbox

openclaw - ✅(Solved) Fix [Bug]: Error message references nonexistent docs anchor `tools/plugin#runtime-helpers` [3 pull requests, 1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openclaw/openclaw#65860•Fetched 2026-04-14 05:39:59
View on GitHub
Comments
0
Participants
1
Timeline
3
Reactions
0
Author
Jah-yeeJah-yee
Participants
Jah-yeeJah-yee
Timeline (top)
cross-referenced ×3

The error message in src/gateway/server-plugins.ts (line 165) references the docs anchor https://docs.openclaw.ai/tools/plugin#runtime-helpers, but the target page docs/tools/plugin.md does not contain a heading that resolves to #runtime-helpers. The user is directed to a dead anchor with no useful content.

Error Message

The error message in src/gateway/server-plugins.ts (line 165) references the docs anchor https://docs.openclaw.ai/tools/plugin#runtime-helpers, but the target page docs/tools/plugin.md does not contain a heading that resolves to #runtime-helpers. The user is directed to a dead anchor with no useful content. 2. Observe the error message: The error message should link to a valid docs page and anchor where the user can find guidance about allowModelOverride configuration. All (error message is platform-independent)

  • Affected: Any user hitting a plugin trust boundary error
  • Severity: Low-medium (misleading error guidance, not a crash)
  • Consequence: User cannot find the relevant configuration docs from the error message alone

Root Cause

The error message in src/gateway/server-plugins.ts (line 165) references the docs anchor https://docs.openclaw.ai/tools/plugin#runtime-helpers, but the target page docs/tools/plugin.md does not contain a heading that resolves to #runtime-helpers. The user is directed to a dead anchor with no useful content.

Fix Action

Fixed

PR fix notes

PR #65872: fix(gateway): point fallback override guidance to valid docs page

Description (problem / solution / changelog)

Summary

  • fixes #65860
  • update fallback override authorization error guidance in src/gateway/server-plugins.ts to point at a valid documentation page (/plugins/sdk-runtime) instead of a missing anchor
  • update the corresponding expectation in src/gateway/server-plugins.test.ts

Why

The previous URL (/tools/plugin#runtime-helpers) points to an anchor that does not exist, so users hitting this error could not find the configuration guidance for plugins.entries.<id>.subagent.allowModelOverride.

Changes

  • src/gateway/server-plugins.ts
    • replace docs URL in the fallback override rejection message
  • src/gateway/server-plugins.test.ts
    • align assertion string with the updated docs URL

Validation

  • pnpm vitest run src/gateway/server-plugins.test.ts

Notes

  • no behavior changes beyond user-facing error guidance text
  • no maintainer mention needed per request; local test passed before submission

Made with Cursor

Changed files

  • src/gateway/server-plugins.test.ts (modified, +1/-1)
  • src/gateway/server-plugins.ts (modified, +1/-1)

PR #65926: fix(gateway): point fallback override guidance to valid docs section

Description (problem / solution / changelog)

Summary

  • fixes #65860
  • update fallback override error guidance to point to an existing and specific runtime docs section
  • keep test assertion aligned with the runtime message

Changes

  • src/gateway/server-plugins.ts
    • docs URL now points to https://docs.openclaw.ai/plugins/sdk-runtime#api-runtime-subagent
  • src/gateway/server-plugins.test.ts
    • update expected error string

Validation

  • pnpm vitest run src/gateway/server-plugins.test.ts

Notes

  • no behavior changes beyond error guidance text
  • local test passed

Made with Cursor

Changed files

  • src/gateway/server-plugins.test.ts (modified, +1/-1)
  • src/gateway/server-plugins.ts (modified, +1/-1)

PR #65939: fix(gateway): point fallback override guidance to valid docs page

Description (problem / solution / changelog)

Summary

  • fixes #65860
  • update fallback override authorization guidance in gateway error text to point to a valid docs section
  • keep assertion text aligned in the corresponding unit test

Why

The previous docs guidance pointed to a non-resolving location for this runtime configuration path, which made troubleshooting harder when model override trust checks failed.

Changes

  • src/gateway/server-plugins.ts
    • docs guidance now points to plugins/sdk-runtime#api-runtime-subagent
  • src/gateway/server-plugins.test.ts
    • update expected message string to match runtime output

Validation

  • pnpm vitest run src/gateway/server-plugins.test.ts

Notes

  • no logic behavior change beyond error guidance text
  • local test passed

Made with Cursor

Changed files

  • src/gateway/server-plugins.test.ts (modified, +1/-1)
  • src/gateway/server-plugins.ts (modified, +1/-1)

Code Example

src/gateway/server-plugins.ts line 162-167:

    allowed: false,
    reason:
      `plugin "${pluginId}" is not trusted for fallback provider/model override requests. ` +
      "See https://docs.openclaw.ai/tools/plugin#runtime-helpers and search for: " +
      "plugins.entries.<id>.subagent.allowModelOverride",

---

$ rg "runtime-helpers" docs/tools/plugin.md
(no matches)
RAW_BUFFERClick to expand / collapse

Bug type

Behavior bug (incorrect output/state without crash)

Beta release blocker

No

Summary

The error message in src/gateway/server-plugins.ts (line 165) references the docs anchor https://docs.openclaw.ai/tools/plugin#runtime-helpers, but the target page docs/tools/plugin.md does not contain a heading that resolves to #runtime-helpers. The user is directed to a dead anchor with no useful content.

Steps to reproduce

  1. Trigger a plugin fallback provider/model override request with a plugin that is not trusted (i.e. plugins.entries.<id>.subagent.allowModelOverride is not set).
  2. Observe the error message:

    plugin "<id>" is not trusted for fallback provider/model override requests. See https://docs.openclaw.ai/tools/plugin#runtime-helpers and search for: plugins.entries.<id>.subagent.allowModelOverride

  3. Navigate to the URL. The page loads but the #runtime-helpers anchor does not exist.

Expected behavior

The error message should link to a valid docs page and anchor where the user can find guidance about allowModelOverride configuration.

Actual behavior

The #runtime-helpers anchor on docs/tools/plugin.md does not exist. A grep for runtime-helpers across docs/tools/plugin.md returns zero matches. The headings on that page are: Plugins, Quick start, Plugin types, etc. — none resolves to #runtime-helpers.

The relevant documentation for allowModelOverride actually lives in:

  • docs/plugins/sdk-runtime.md (around line 120)
  • docs/gateway/configuration-reference.md (around line 2755)

OpenClaw version

Current main (2026.4.12)

Operating system

All (error message is platform-independent)

Install method

Any

Model

Any

Provider / routing chain

Any (triggers on plugin subagent model override)

Logs, screenshots, and evidence

src/gateway/server-plugins.ts line 162-167:

    allowed: false,
    reason:
      `plugin "${pluginId}" is not trusted for fallback provider/model override requests. ` +
      "See https://docs.openclaw.ai/tools/plugin#runtime-helpers and search for: " +
      "plugins.entries.<id>.subagent.allowModelOverride",

Verified with grep:

$ rg "runtime-helpers" docs/tools/plugin.md
(no matches)

Impact and severity

  • Affected: Any user hitting a plugin trust boundary error
  • Severity: Low-medium (misleading error guidance, not a crash)
  • Frequency: Edge case, but confusing when hit
  • Consequence: User cannot find the relevant configuration docs from the error message alone

Additional information

Suggested fix: update the URL to point to the actual page and anchor where allowModelOverride is documented (e.g. plugins/sdk-runtime or gateway/configuration-reference), or add a ## Runtime helpers heading to docs/tools/plugin.md with the relevant content.

extent analysis

TL;DR

Update the error message URL in src/gateway/server-plugins.ts to point to a valid documentation page and anchor for allowModelOverride configuration.

Guidance

  • Identify the correct documentation page and anchor for allowModelOverride, which is currently found in docs/plugins/sdk-runtime.md or docs/gateway/configuration-reference.md.
  • Update the URL in the error message to point to one of these pages, ensuring the anchor exists and is relevant to the configuration.
  • Consider adding a new heading to docs/tools/plugin.md if it is deemed the most appropriate location for the allowModelOverride documentation.
  • Verify the fix by triggering the plugin trust boundary error and checking that the error message links to a valid and relevant documentation page.

Example

// Updated error message with correct URL
reason:
  `plugin "${pluginId}" is not trusted for fallback provider/model override requests. ` +
  "See https://docs.openclaw.ai/plugins/sdk-runtime#allowModelOverride and search for: " +
  "plugins.entries.<id>.subagent.allowModelOverride",

Notes

The suggested fix requires updating the documentation to ensure the anchor exists and is accurate. It's essential to verify the fix to prevent further confusion.

Recommendation

Apply workaround: update the error message URL to point to a valid documentation page and anchor for allowModelOverride configuration, as this is a low-medium severity issue with a clear solution.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

FAQ

Expected behavior

The error message should link to a valid docs page and anchor where the user can find guidance about allowModelOverride configuration.

#file not found#serialization error#model compatibility#GPU setup#container setup

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

openclaw - ✅(Solved) Fix [Bug]: Error message references nonexistent docs anchor `tools/plugin#runtime-helpers` [3 pull requests, 1 participants]