From 75775f2fe6fdd9f6538e4951543b45c366c2ec9c Mon Sep 17 00:00:00 2001 From: Henry Loenwind Date: Tue, 3 Mar 2026 07:34:15 +0100 Subject: [PATCH] chore: Updated Brave documentation (#26860) Merged via squash. Prepared head SHA: f8fc4bf01e0eacfb01f6ee58eea445680f7eeebd Co-authored-by: HenryLoenwind <1485873+HenryLoenwind@users.noreply.github.com> Co-authored-by: gumadeiras <5599352+gumadeiras@users.noreply.github.com> Reviewed-by: @gumadeiras --- CHANGELOG.md | 2 ++ docs/brave-search.md | 3 ++- docs/reference/api-usage-costs.md | 6 ------ docs/tools/web.md | 20 ++++++++++++-------- 4 files changed, 16 insertions(+), 15 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 3bb10f71d9c..19ed1e341b4 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,6 +6,8 @@ Docs: https://docs.openclaw.ai ### Changes +- Docs/Web search: remove outdated Brave free-tier wording and replace prescriptive AI ToS guidance with neutral compliance language in Brave setup docs. (#26860) Thanks @HenryLoenwind. + ### Fixes - LINE/auth boundary hardening synthesis: enforce strict LINE webhook authn/z boundary semantics across pairing-store account scoping, DM/group allowlist separation, fail-closed webhook auth/runtime behavior, and replay/duplication controls (including in-flight replay reservation and post-success dedupe marking). (from #26701, #26683, #25978, #17593, #16619, #31990, #26047, #30584, #18777) Thanks @bmendonca3, @davidahmann, @harshang03, @haosenwang1018, @liuxiaopai-ai, @coygeek, and @Takhoffman. diff --git a/docs/brave-search.md b/docs/brave-search.md index ba18a6c552d..1f0cffeceb0 100644 --- a/docs/brave-search.md +++ b/docs/brave-search.md @@ -36,6 +36,7 @@ OpenClaw uses Brave Search as the default provider for `web_search`. ## Notes - The Data for AI plan is **not** compatible with `web_search`. -- Brave provides a free tier plus paid plans; check the Brave API portal for current limits. +- Brave provides paid plans; check the Brave API portal for current limits. +- Brave Terms include restrictions on some AI-related uses of Search Results. Review the Brave Terms of Service and confirm your intended use is compliant. For legal questions, consult your counsel. See [Web tools](/tools/web) for the full web_search configuration. diff --git a/docs/reference/api-usage-costs.md b/docs/reference/api-usage-costs.md index a1002fc88ad..071d91f3b30 100644 --- a/docs/reference/api-usage-costs.md +++ b/docs/reference/api-usage-costs.md @@ -82,12 +82,6 @@ See [Memory](/concepts/memory). - **Brave Search API**: `BRAVE_API_KEY` or `tools.web.search.apiKey` - **Perplexity** (via OpenRouter): `PERPLEXITY_API_KEY` or `OPENROUTER_API_KEY` -**Brave free tier (generous):** - -- **2,000 requests/month** -- **1 request/second** -- **Credit card required** for verification (no charge unless you upgrade) - See [Web tools](/tools/web). ### 5) Web fetch tool (Firecrawl) diff --git a/docs/tools/web.md b/docs/tools/web.md index c452782cad8..66d787ec8f3 100644 --- a/docs/tools/web.md +++ b/docs/tools/web.md @@ -31,13 +31,13 @@ These are **not** browser automation. For JS-heavy sites or logins, use the ## Choosing a search provider -| Provider | Pros | Cons | API Key | -| ------------------- | -------------------------------------------- | ---------------------------------------- | -------------------------------------------- | -| **Brave** (default) | Fast, structured results, free tier | Traditional search results | `BRAVE_API_KEY` | -| **Perplexity** | AI-synthesized answers, citations, real-time | Requires Perplexity or OpenRouter access | `OPENROUTER_API_KEY` or `PERPLEXITY_API_KEY` | -| **Gemini** | Google Search grounding, AI-synthesized | Requires Gemini API key | `GEMINI_API_KEY` | -| **Grok** | xAI web-grounded responses | Requires xAI API key | `XAI_API_KEY` | -| **Kimi** | Moonshot web search capability | Requires Moonshot API key | `KIMI_API_KEY` / `MOONSHOT_API_KEY` | +| Provider | Pros | Cons | API Key | +| ------------------- | -------------------------------------------- | ---------------------------------------------- | -------------------------------------------- | +| **Brave** (default) | Fast, structured results | Traditional search results; AI-use terms apply | `BRAVE_API_KEY` | +| **Perplexity** | AI-synthesized answers, citations, real-time | Requires Perplexity or OpenRouter access | `OPENROUTER_API_KEY` or `PERPLEXITY_API_KEY` | +| **Gemini** | Google Search grounding, AI-synthesized | Requires Gemini API key | `GEMINI_API_KEY` | +| **Grok** | xAI web-grounded responses | Requires xAI API key | `XAI_API_KEY` | +| **Kimi** | Moonshot web search capability | Requires Moonshot API key | `KIMI_API_KEY` / `MOONSHOT_API_KEY` | See [Brave Search setup](/brave-search) and [Perplexity Sonar](/perplexity) for provider-specific details. @@ -94,9 +94,13 @@ Example: switch to Perplexity Sonar (direct API): 2. In the dashboard, choose the **Data for Search** plan (not “Data for AI”) and generate an API key. 3. Run `openclaw configure --section web` to store the key in config (recommended), or set `BRAVE_API_KEY` in your environment. -Brave provides a free tier plus paid plans; check the Brave API portal for the +Brave provides paid plans; check the Brave API portal for the current limits and pricing. +Brave Terms include restrictions on some AI-related uses of Search Results. +Review the Brave Terms of Service and confirm your intended use is compliant. +For legal questions, consult your counsel. + ### Where to set the key (recommended) **Recommended:** run `openclaw configure --section web`. It stores the key in