Issue Station
Sign In
Tools hereToolbox

openclaw - ✅(Solved) Fix [Bug]: Brave Search docs URL in code points to legacy path instead of canonical location [4 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#65870•Fetched 2026-04-14 05:39:46
View on GitHub
Comments
0
Participants
1
Timeline
4
Reactions
0
Author
Jah-yeeJah-yee
Participants
Jah-yeeJah-yee
Timeline (top)
cross-referenced ×4

The Brave web search provider code references docsUrl: "https://docs.openclaw.ai/brave-search", which is the legacy path. While a redirect exists in docs.json from /brave-search to /tools/brave-search, the canonical page is at docs/tools/brave-search.md. Additionally, the legacy file docs/brave-search.md still exists with a title: "Brave Search (legacy path)", creating two source files for the same content.

Root Cause

The Brave web search provider code references docsUrl: "https://docs.openclaw.ai/brave-search", which is the legacy path. While a redirect exists in docs.json from /brave-search to /tools/brave-search, the canonical page is at docs/tools/brave-search.md. Additionally, the legacy file docs/brave-search.md still exists with a title: "Brave Search (legacy path)", creating two source files for the same content.

Fix Action

Fixed

PR fix notes

PR #65880: fix(brave): use canonical tools docs URL in provider metadata

Description (problem / solution / changelog)

Summary

  • fixes #65870
  • update Brave web search metadata to use canonical docs URL (/tools/brave-search)

Why

Brave provider metadata still pointed at the legacy path (/brave-search). It currently redirects, but using the canonical tools path avoids ambiguity and keeps provider metadata aligned with current docs navigation.

Changes

  • extensions/brave/src/brave-web-search-provider.ts
    • set docsUrl to https://docs.openclaw.ai/tools/brave-search
  • extensions/brave/web-search-contract-api.ts
    • mirror the same metadata change in contract API

Validation

  • pnpm vitest run src/plugins/contracts/bundled-web-search.brave.contract.test.ts src/plugins/contracts/web-search-provider.brave.contract.test.ts src/plugins/contracts/plugin-registration.brave.contract.test.ts

Notes

  • metadata-only change
  • local tests passed before PR creation

Made with Cursor

Changed files

  • extensions/brave/src/brave-web-search-provider.ts (modified, +1/-1)
  • extensions/brave/web-search-contract-api.ts (modified, +1/-1)

PR #65892: fix: update Brave Search docsUrl to canonical /tools/brave-search path

Description (problem / solution / changelog)

Problem

The docsUrl field in both Brave Search provider files points to the legacy path /brave-search instead of the canonical /tools/brave-search.

While a redirect exists in docs.json, the code should reference the canonical URL directly.

Changes

  • extensions/brave/web-search-contract-api.ts: Updated docsUrl
  • extensions/brave/src/brave-web-search-provider.ts: Updated docsUrl

Both changed from https://docs.openclaw.ai/brave-search to https://docs.openclaw.ai/tools/brave-search.

Closes #65870

Changed files

  • extensions/brave/src/brave-web-search-provider.ts (modified, +1/-1)
  • extensions/brave/web-search-contract-api.ts (modified, +1/-1)

PR #65927: fix(brave): use canonical tools docs URL in provider metadata

Description (problem / solution / changelog)

Summary

  • fixes #65870
  • switch Brave provider metadata docs URL from legacy path to canonical tools path

Changes

  • extensions/brave/src/brave-web-search-provider.ts
  • extensions/brave/web-search-contract-api.ts
    • set docsUrl to https://docs.openclaw.ai/tools/brave-search

Validation

  • pnpm vitest run src/plugins/contracts/bundled-web-search.brave.contract.test.ts src/plugins/contracts/web-search-provider.brave.contract.test.ts src/plugins/contracts/plugin-registration.brave.contract.test.ts

Notes

  • metadata-only change
  • local tests passed

Made with Cursor

Changed files

  • extensions/brave/src/brave-web-search-provider.ts (modified, +1/-1)
  • extensions/brave/web-search-contract-api.ts (modified, +1/-1)

PR #65941: fix(brave): use canonical tools docs URL in provider metadata

Description (problem / solution / changelog)

Summary

  • fixes #65870
  • switch Brave web-search provider docs URL to canonical tools path

Why

Metadata pointed at a legacy redirect path instead of the canonical docs location.

Changes

  • extensions/brave/src/brave-web-search-provider.ts
  • extensions/brave/web-search-contract-api.ts
    • update docsUrl to https://docs.openclaw.ai/tools/brave-search

Validation

  • pnpm vitest run src/plugins/contracts/bundled-web-search.brave.contract.test.ts src/plugins/contracts/web-search-provider.brave.contract.test.ts src/plugins/contracts/plugin-registration.brave.contract.test.ts

Notes

  • metadata-only update
  • local tests passed

Made with Cursor

Changed files

  • extensions/brave/src/brave-web-search-provider.ts (modified, +1/-1)
  • extensions/brave/web-search-contract-api.ts (modified, +1/-1)

Code Example

$ head -7 docs/brave-search.md
---
title: "Brave Search (legacy path)"
---
# Brave Search API

$ head -7 docs/tools/brave-search.md
---
title: "Brave Search"
---
# Brave Search API

$ rg '"source": "/brave-search"' docs/docs.json
      "source": "/brave-search",
      "destination": "/tools/brave-search"
RAW_BUFFERClick to expand / collapse

Bug type

Behavior bug (incorrect output/state without crash)

Beta release blocker

No

Summary

The Brave web search provider code references docsUrl: "https://docs.openclaw.ai/brave-search", which is the legacy path. While a redirect exists in docs.json from /brave-search to /tools/brave-search, the canonical page is at docs/tools/brave-search.md. Additionally, the legacy file docs/brave-search.md still exists with a title: "Brave Search (legacy path)", creating two source files for the same content.

Steps to reproduce

  1. Open extensions/brave/src/brave-web-search-provider.ts and find the docsUrl field.
  2. Observe it points to https://docs.openclaw.ai/brave-search.
  3. Open docs/brave-search.md — note the title is "Brave Search (legacy path)".
  4. Open docs/tools/brave-search.md — note the title is "Brave Search" (the canonical one).
  5. Check docs/docs.json — there is a redirect from /brave-search to /tools/brave-search.

Expected behavior

  • The code docsUrl should reference the canonical path /tools/brave-search.
  • The legacy docs/brave-search.md file should either be removed (relying solely on the redirect in docs.json) or clearly marked as a redirect stub without duplicated content.

Actual behavior

Two separate Markdown files exist with near-identical content but different titles:

  • docs/brave-search.md: title "Brave Search (legacy path)"
  • docs/tools/brave-search.md: title "Brave Search"

The docsUrl in code still points to the legacy path. Similarly, the contract file extensions/brave/web-search-contract-api.ts likely references the same legacy URL.

OpenClaw version

Current main (2026.4.12)

Operating system

N/A

Install method

N/A

Model

N/A

Provider / routing chain

Brave web search provider

Logs, screenshots, and evidence

$ head -7 docs/brave-search.md
---
title: "Brave Search (legacy path)"
---
# Brave Search API

$ head -7 docs/tools/brave-search.md
---
title: "Brave Search"
---
# Brave Search API

$ rg '"source": "/brave-search"' docs/docs.json
      "source": "/brave-search",
      "destination": "/tools/brave-search"

Impact and severity

  • Affected: Documentation maintainability; any tooling that indexes doc files
  • Severity: Low (redirect works, so end-user impact is minimal)
  • Frequency: Persistent
  • Consequence: Duplicate content maintenance burden; docsUrl in code not pointing to canonical path

Additional information

Suggested fix:

  1. Update docsUrl in extensions/brave/src/brave-web-search-provider.ts (and contract) to https://docs.openclaw.ai/tools/brave-search.
  2. Optionally remove docs/brave-search.md content (the redirect in docs.json handles the URL).

extent analysis

TL;DR

Update the docsUrl in the Brave web search provider code to reference the canonical path and consider removing the legacy Markdown file to avoid duplicate content.

Guidance

  • Verify the docsUrl field in extensions/brave/src/brave-web-search-provider.ts is updated to https://docs.openclaw.ai/tools/brave-search to point to the canonical documentation path.
  • Check if the contract file extensions/brave/web-search-contract-api.ts also references the legacy URL and update it accordingly.
  • Consider removing the content of docs/brave-search.md to avoid maintaining duplicate content, as the redirect in docs.json handles the legacy URL.
  • After updating, verify that the documentation maintainability issues are resolved and the docsUrl in the code points to the correct canonical path.

Example

// In extensions/brave/src/brave-web-search-provider.ts
const docsUrl = "https://docs.openclaw.ai/tools/brave-search";

Notes

The provided fix suggestions are based on the information given in the issue and assume that updating the docsUrl and potentially removing the legacy Markdown file will resolve the documentation maintainability issues without causing other problems.

Recommendation

Apply the workaround by updating the docsUrl to the canonical path and optionally removing the legacy Markdown file, as this directly addresses the identified issue of duplicate content and incorrect URL referencing.

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 code docsUrl should reference the canonical path /tools/brave-search.
  • The legacy docs/brave-search.md file should either be removed (relying solely on the redirect in docs.json) or clearly marked as a redirect stub without duplicated content.
#api#retrieval issue#search optimization#API routing#API middleware

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]: Brave Search docs URL in code points to legacy path instead of canonical location [4 pull requests, 1 participants]