openclaw/openclaw · error · Error

Brave Search base URL must use http:// or https://.

Error message

Brave Search base URL must use http:// or https://.

What it means

Error "Brave Search base URL must use http:// or https://." thrown in openclaw/openclaw.

Source

Thrown at extensions/brave/src/brave-web-search-provider.runtime.ts:144

        allowRfc2544BenchmarkRange: true,
      },
    });
    return pinned.addresses.every((address) => isPrivateIpAddress(address));
  } catch {
    return false;
  }
}

async function validateBraveBaseUrl(baseUrl: string): Promise<BraveEndpointMode> {
  let parsed: URL;
  try {
    parsed = new URL(baseUrl);
  } catch {
    throw new Error("Brave Search base URL must be a valid http:// or https:// URL.");
  }

  if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
    throw new Error("Brave Search base URL must use http:// or https://.");
  }

  if (parsed.protocol === "http:") {
    await assertHttpUrlTargetsPrivateNetwork(parsed.toString(), {
      dangerouslyAllowPrivateNetwork: true,
      errorMessage:
        "Brave Search HTTP base URL must target a trusted private or loopback host. Use https:// for public hosts.",
    });
    return "selfHosted";
  }

  return (await braveEndpointTargetsPrivateNetwork(parsed)) ? "selfHosted" : "strict";
}

function missingBraveKeyPayload() {
  return {
    error: "missing_brave_api_key",
    message: `web_search (brave) needs a Brave Search API key. Run \`${formatCliCommand("openclaw configure --section web")}\` to store it, or set BRAVE_API_KEY in the Gateway environment. If you do not want to configure a search API key, use web_fetch for a specific URL or the browser tool for interactive pages.`,

View on GitHub (pinned to 01804a7531)

When it happens

Trigger: Thrown at extensions/brave/src/brave-web-search-provider.runtime.ts:144 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of openclaw/openclaw@01804a7531 (2026-08-12). Data as JSON: /api/errors/8aa5e53d50c2ee03. Report an issue: GitHub.