openclaw - 💡(How to fix) Fix 2026.5.2 web_search cannot use Brave after plugin externalization; DuckDuckGo challenges immediately [1 comments, 2 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#77082Fetched 2026-05-05 05:52:34
View on GitHub
Comments
1
Participants
2
Timeline
3
Reactions
2
Timeline (top)
closed ×1commented ×1subscribed ×1

After moving OpenClaw 2026.5.2 web search from DuckDuckGo back to Brave, the first-class web_search tool still fails even though Brave API works directly, the Brave plugin is installed/loaded, and config validates as provider: "brave".

There appear to be two separate issues:

  1. DuckDuckGo key-free search immediately returns bot-detection challenges in normal web_search use.
  2. After installing/enabling the externalized Brave plugin, the agent web_search tool reports web_search is disabled or no provider is available despite openclaw plugins inspect brave showing web-search: brave and config showing tools.web.search.provider = brave.

Error Message

Bursting several searches in the same second produced the same challenge error for every call, not a normal 429.

Root Cause

After moving OpenClaw 2026.5.2 web search from DuckDuckGo back to Brave, the first-class web_search tool still fails even though Brave API works directly, the Brave plugin is installed/loaded, and config validates as provider: "brave".

There appear to be two separate issues:

  1. DuckDuckGo key-free search immediately returns bot-detection challenges in normal web_search use.
  2. After installing/enabling the externalized Brave plugin, the agent web_search tool reports web_search is disabled or no provider is available despite openclaw plugins inspect brave showing web-search: brave and config showing tools.web.search.provider = brave.

Code Example

{
  "tools": { "web": { "search": { "enabled": true, "provider": "duckduckgo", "maxResults": 5, "timeoutSeconds": 15 } } },
  "plugins": { "entries": { "duckduckgo": { "enabled": true } } }
}

---

web_search(query="Toronto weather today", count=3)

---

DuckDuckGo returned a bot-detection challenge.

---

"tools.web.search.provider": "brave"

---

tools.web.search.provider: web_search provider is not available: brave (install or enable plugin "brave", then run openclaw doctor --fix)
Config auto-restored from last-known-good

---

openclaw plugins install @openclaw/brave-plugin
openclaw doctor --fix
# doctor output: Plugin registry refreshed: 9/95 enabled plugins indexed.
# restart gateway

---

openclaw config get tools.web.search
{
  "enabled": true,
  "provider": "brave",
  "maxResults": 5,
  "timeoutSeconds": 15
}

openclaw plugins inspect brave
Status: loaded
Version: 2026.5.2
Capabilities:
web-search: brave

---

brave_direct_ok status 200 results 3

---

web_search is disabled or no provider is available.
RAW_BUFFERClick to expand / collapse

Summary

After moving OpenClaw 2026.5.2 web search from DuckDuckGo back to Brave, the first-class web_search tool still fails even though Brave API works directly, the Brave plugin is installed/loaded, and config validates as provider: "brave".

There appear to be two separate issues:

  1. DuckDuckGo key-free search immediately returns bot-detection challenges in normal web_search use.
  2. After installing/enabling the externalized Brave plugin, the agent web_search tool reports web_search is disabled or no provider is available despite openclaw plugins inspect brave showing web-search: brave and config showing tools.web.search.provider = brave.

Environment

  • OpenClaw: 2026.5.2 (8b2a6e5)
  • OS: macOS 26.4.1 arm64
  • Node: 25.8.1
  • Gateway: LaunchAgent, local loopback

DuckDuckGo repro

Config:

{
  "tools": { "web": { "search": { "enabled": true, "provider": "duckduckgo", "maxResults": 5, "timeoutSeconds": 15 } } },
  "plugins": { "entries": { "duckduckgo": { "enabled": true } } }
}

Tool call:

web_search(query="Toronto weather today", count=3)

Observed:

DuckDuckGo returned a bot-detection challenge.

Bursting several searches in the same second produced the same challenge error for every call, not a normal 429.

Direct local fetch of https://html.duckduckgo.com/html?q=...&kp=-1 with a browser User-Agent returned HTML with result__a, so this may be specific to the guarded fetch / plugin path.

Brave repro

Brave was externalized in 5.2, so initially setting:

"tools.web.search.provider": "brave"

failed gateway config validation:

tools.web.search.provider: web_search provider is not available: brave (install or enable plugin "brave", then run openclaw doctor --fix)
Config auto-restored from last-known-good

Then installed Brave:

openclaw plugins install @openclaw/brave-plugin
openclaw doctor --fix
# doctor output: Plugin registry refreshed: 9/95 enabled plugins indexed.
# restart gateway

Validated state:

openclaw config get tools.web.search
{
  "enabled": true,
  "provider": "brave",
  "maxResults": 5,
  "timeoutSeconds": 15
}

openclaw plugins inspect brave
Status: loaded
Version: 2026.5.2
Capabilities:
web-search: brave

Direct Brave API with the same restored key succeeds:

brave_direct_ok status 200 results 3

But the first-class agent tool still fails in both current and fresh isolated runs:

web_search is disabled or no provider is available.

Expected

Once @openclaw/brave-plugin is installed, loaded, registry-refreshed, and selected via tools.web.search.provider = "brave", the first-class web_search tool should use Brave.

Impact

Timely queries routed through OpenClaw currently cannot use either configured provider:

  • DuckDuckGo is challenged immediately.
  • Brave is loaded/configured but not exposed to the agent web_search tool registry.

extent analysis

TL;DR

The issue can be resolved by verifying the Brave plugin installation and configuration, and ensuring that the web_search tool is properly registered with the Brave provider.

Guidance

  • Check the Brave plugin version and ensure it is compatible with OpenClaw 2026.5.2.
  • Verify that the web_search tool is properly configured to use the Brave provider by running openclaw config get tools.web.search and checking the provider field.
  • Run openclaw plugins inspect brave to ensure the Brave plugin is loaded and has the web-search capability.
  • Try running openclaw doctor --fix again to refresh the plugin registry and restart the gateway.

Example

No code snippet is provided as the issue seems to be related to plugin configuration and installation.

Notes

The issue may be related to the externalization of the Brave plugin in OpenClaw 5.2, and the fact that the web_search tool is not properly registered with the Brave provider.

Recommendation

Apply workaround: Reinstall the Brave plugin and reconfigure the web_search tool to use the Brave provider, then run openclaw doctor --fix to refresh the plugin registry and restart the gateway. This should resolve the issue with the web_search tool not being able to use the Brave provider.

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…

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 - 💡(How to fix) Fix 2026.5.2 web_search cannot use Brave after plugin externalization; DuckDuckGo challenges immediately [1 comments, 2 participants]