메인 콘텐츠로 건너뛰기

​
DuckDuckGo Search

OpenClaw는 DuckDuckGo를 키 없는 web_search provider로 지원합니다. API 키나 계정이 필요하지 않습니다.
DuckDuckGo 통합은 실험적이며 비공식적입니다. DuckDuckGo의 비 JavaScript 검색 페이지에서 결과를 가져오며, 공식 API를 쓰는 방식이 아닙니다. bot-challenge 페이지나 HTML 변경으로 인해 가끔 깨질 수 있습니다.

​
설정

API 키는 필요 없고, provider만 DuckDuckGo로 지정하면 됩니다:
1

구성

openclaw configure --section web
# provider로 "duckduckgo" 선택

​
Config

{
  tools: {
    web: {
      search: {
        provider: "duckduckgo",
      },
    },
  },
}
리전과 SafeSearch를 plugin 수준에서 추가로 설정할 수도 있습니다: 
{
  plugins: {
    entries: {
      duckduckgo: {
        config: {
          webSearch: {
            region: "us-en", // DuckDuckGo region code
            safeSearch: "moderate", // "strict", "moderate", or "off"
          },
        },
      },
    },
  },
}

​
도구 파라미터

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
리전과 SafeSearch는 plugin config에서도 설정할 수 있으며, 도구 파라미터가 쿼리별로 우선합니다.

​
참고

  • No API key - 즉시 사용 가능, zero configuration
  • Experimental - 비 JavaScript HTML 검색 페이지를 파싱하며, 공식 API나 SDK가 아닙니다
  • Bot-challenge risk - 대량 또는 자동화된 사용 시 CAPTCHA나 차단이 발생할 수 있습니다
  • HTML parsing - 결과는 페이지 구조에 의존하므로 예고 없이 바뀔 수 있습니다
  • Auto-detection order - DuckDuckGo는 자동 감지 순서에서 마지막(order 100)이므로, API 키가 있는 provider가 있으면 그것이 우선됩니다
  • SafeSearch 기본값은 moderate입니다
운영 환경에서는 Brave Search나 다른 API 기반 provider를 고려하는 편이 좋습니다.

​
관련 문서