Skip to content
OpenClaw Docs

DuckDuckGo Search

DuckDuckGo Search

Section titled “DuckDuckGo Search”

OpenClaw supports DuckDuckGo as a key-free web_search provider. No API key or account is required.

Setup

Section titled “Setup”

No API key needed — just set DuckDuckGo as your provider:

  1. Configure

    Terminal window
    openclaw configure --section web
    # Select "duckduckgo" as the provider

Config

Section titled “Config”
{
  tools: {
    web: {
      search: {
        provider: "duckduckgo",
      },
    },
  },
}

Optional plugin-level settings for region and SafeSearch:

{
  plugins: {
    entries: {
      duckduckgo: {
        config: {
          webSearch: {
            region: "us-en", // DuckDuckGo region code
            safeSearch: "moderate", // "strict", "moderate", or "off"
          },
        },
      },
    },
  },
}

Tool parameters

Section titled “Tool parameters”
ParameterDescription
querySearch query (required)
countResults to return (1-10, default: 5)
regionDuckDuckGo region code (e.g. us-en, uk-en, de-de)
safeSearchSafeSearch level: strict, moderate (default), or off

Region and SafeSearch can also be set in plugin config (see above) — tool parameters override config values per-query.

Notes

Section titled “Notes”
  • No API key — works out of the box, zero configuration
  • Experimental — gathers results from DuckDuckGo’s non-JavaScript HTML search pages, not an official API or SDK
  • Bot-challenge risk — DuckDuckGo may serve CAPTCHAs or block requests under heavy or automated use
  • HTML parsing — results depend on page structure, which can change without notice
  • Auto-detection order — DuckDuckGo is checked last (order 100) in auto-detection, so any API-backed provider with a key takes priority
  • SafeSearch defaults to moderate when not configured
Section titled “Related”