diff --git a/CHANGELOG.md b/CHANGELOG.md index f93fbf78154..6a7db8bd1db 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -51,7 +51,7 @@ Docs: https://docs.openclaw.ai - CLI: make read-only SecretRef status flows degrade safely (#37023) thanks @joshavant. - Tools/Diffs guidance: restore a short system-prompt hint for enabled diffs while keeping the detailed instructions in the companion skill, so diffs usage guidance stays out of user-prompt space. (#36904) thanks @gumadeiras. - Tools/Diffs guidance loading: move diffs usage guidance from unconditional prompt-hook injection to the plugin companion skill path, reducing unrelated-turn prompt noise while keeping diffs tool behavior unchanged. (#32630) thanks @sircrumpet. -- 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. +- Docs/Web search: update Brave Search docs for Feb 2026 plan restructuring: restore $5/month free-credit details, replace defunct "Data for Search"/"Data for AI" plan names with current "Search" plan, and note legacy subscription validity. (#26860) Thanks @HenryLoenwind. - Config/Compaction safeguard tuning: expose `agents.defaults.compaction.recentTurnsPreserve` and quality-guard retry knobs through the validated config surface and embedded-runner wiring, with regression coverage for real config loading and schema metadata. (#25557) thanks @rodrigouroz. - iOS/App Store Connect release prep: align iOS bundle identifiers under `ai.openclaw.client`, refresh Watch app icons, add Fastlane metadata/screenshot automation, and support Keychain-backed ASC auth for uploads. (#38936) Thanks @ngutman. - Mattermost/model picker: add Telegram-style interactive provider/model browsing for `/oc_model` and `/oc_models`, fix picker callback updates, and emit a normal confirmation reply when a model is selected. (#38767) thanks @mukhtharcm. diff --git a/docs/brave-search.md b/docs/brave-search.md index 3b1e55c0aae..a8bba5c3e91 100644 --- a/docs/brave-search.md +++ b/docs/brave-search.md @@ -13,7 +13,7 @@ OpenClaw supports Brave Search API as a `web_search` provider. ## Get an API key 1. Create a Brave Search API account at [https://brave.com/search/api/](https://brave.com/search/api/) -2. In the dashboard, choose the **Data for Search** plan and generate an API key. +2. In the dashboard, choose the **Search** plan and generate an API key. 3. Store the key in config or set `BRAVE_API_KEY` in the Gateway environment. ## Config example @@ -72,9 +72,9 @@ await web_search({ ## Notes -- The Data for AI plan is **not** compatible with `web_search`. -- 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. +- OpenClaw uses the Brave **Search** plan. If you have a legacy subscription (e.g. the original Free plan with 2,000 queries/month), it remains valid but does not include newer features like LLM Context or higher rate limits. +- Each Brave plan includes **$5/month in free credit** (renewing). The Search plan costs $5 per 1,000 requests, so the credit covers 1,000 queries/month. Set your usage limit in the Brave dashboard to avoid unexpected charges. See the [Brave API portal](https://brave.com/search/api/) for current plans. +- The Search plan includes the LLM Context endpoint and AI inference rights. Storing results to train or tune models requires a plan with explicit storage rights. See the Brave [Terms of Service](https://api-dashboard.search.brave.com/terms-of-service). - Results are cached for 15 minutes by default (configurable via `cacheTtlMinutes`). 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 28ead36b0c1..dba017aacc1 100644 --- a/docs/reference/api-usage-costs.md +++ b/docs/reference/api-usage-costs.md @@ -79,11 +79,16 @@ See [Memory](/concepts/memory). `web_search` uses API keys and may incur usage charges depending on your provider: -- **Perplexity Search API**: `PERPLEXITY_API_KEY` - **Brave Search API**: `BRAVE_API_KEY` or `tools.web.search.apiKey` - **Gemini (Google Search)**: `GEMINI_API_KEY` - **Grok (xAI)**: `XAI_API_KEY` - **Kimi (Moonshot)**: `KIMI_API_KEY` or `MOONSHOT_API_KEY` +- **Perplexity Search API**: `PERPLEXITY_API_KEY` + +**Brave Search free credit:** Each Brave plan includes $5/month in renewing +free credit. The Search plan costs $5 per 1,000 requests, so the credit covers +1,000 requests/month at no charge. Set your usage limit in the Brave dashboard +to avoid unexpected charges. See [Web tools](/tools/web). diff --git a/docs/tools/web.md b/docs/tools/web.md index 94732105098..c25deff970c 100644 --- a/docs/tools/web.md +++ b/docs/tools/web.md @@ -56,10 +56,14 @@ Use `openclaw configure --section web` to set up your API key and choose a provi ### Brave Search 1. Create a Brave Search API account at [brave.com/search/api](https://brave.com/search/api/) -2. In the dashboard, choose the **Data for Search** plan (not "Data for AI") and generate an API key. +2. In the dashboard, choose the **Search** plan and generate an API key. 3. Run `openclaw configure --section web` to store the key in config, or set `BRAVE_API_KEY` in your environment. -Brave provides paid plans; check the Brave API portal for the current limits and pricing. +Each Brave plan includes **$5/month in free credit** (renewing). The Search +plan costs $5 per 1,000 requests, so the credit covers 1,000 queries/month. Set +your usage limit in the Brave dashboard to avoid unexpected charges. See the +[Brave API portal](https://brave.com/search/api/) for current plans and +pricing. ### Perplexity Search