메인 콘텐츠로 건너뛰기

​
DuckDuckGo Search

OpenClaw는 DuckDuckGo를 키 없이 사용하는 web_search 프로바이더로 지원합니다. API 키나 계정이 필요하지 않습니다.
DuckDuckGo는 DuckDuckGo의 비자바스크립트 검색 페이지에서 결과를 가져오는 실험적이고 비공식적인 통합이며, 공식 API가 아닙니다. 봇 챌린지 페이지나 HTML 변경으로 인해 간헐적으로 깨질 수 있습니다.

​
설정

API 키는 필요 없습니다. DuckDuckGo를 프로바이더로 설정하기만 하면 됩니다:
1

구성

openclaw configure --section web
# 프로바이더로 "duckduckgo" 선택

​
Config

{
  tools: {
    web: {
      search: {
        provider: "duckduckgo",
      },
    },
  },
}
지역 및 SafeSearch를 위한 선택적 플러그인 수준 설정: 
{
  plugins: {
    entries: {
      duckduckgo: {
        config: {
          webSearch: {
            region: "us-en", // DuckDuckGo 지역 코드
            safeSearch: "moderate", // "strict", "moderate", 또는 "off"
          },
        },
      },
    },
  },
}

​
도구 매개변수

매개변수설명
query검색어(필수)
count반환할 결과 수(1-10, 기본값: 5)
regionDuckDuckGo 지역 코드(예: us-en, uk-en, de-de)
safeSearchSafeSearch 수준: strict, moderate(기본값), 또는 off
지역 및 SafeSearch는 플러그인 config에서도 설정할 수 있습니다(위 참조). 도구 매개변수는 쿼리별로 config 값을 재정의합니다.

​
참고

  • API 키 없음 — 즉시 사용 가능하며, 설정이 필요 없습니다
  • 실험적 — DuckDuckGo의 비자바스크립트 HTML 검색 페이지에서 결과를 수집하며, 공식 API나 SDK가 아닙니다
  • 봇 챌린지 위험 — 사용량이 많거나 자동화된 사용에서는 DuckDuckGo가 CAPTCHA를 제공하거나 요청을 차단할 수 있습니다
  • HTML 파싱 — 결과는 예고 없이 변경될 수 있는 페이지 구조에 따라 달라집니다
  • 자동 감지 순서 — DuckDuckGo는 자동 감지에서 첫 번째 키 없는 폴백 (순서 100)입니다. 키가 구성된 API 기반 프로바이더가 먼저 실행되고, 그다음 Ollama Web Search(순서 110), 그다음 SearXNG(순서 200)가 실행됩니다
  • 구성되지 않은 경우 SafeSearch 기본값은 moderate입니다
프로덕션 용도로는 Brave Search(무료 티어 사용 가능) 또는 다른 API 기반 프로바이더를 고려하세요.

​
관련