메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw는 DuckDuckGo를 키가 필요 없는 web_search 제공자로 지원합니다. API 키나 계정이 필요하지 않습니다.
DuckDuckGo는 공식 API가 아니라 DuckDuckGo의 JavaScript 미사용 검색 페이지에서 결과를 가져오는 실험적이고 비공식적인 통합입니다. 봇 챌린지 페이지나 HTML 변경으로 인해 가끔 중단될 수 있습니다.

​
설정

API 키가 필요 없습니다. DuckDuckGo를 제공자로 설정하기만 하면 됩니다.
1

Configure

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

​
구성

{
  tools: {
    web: {
      search: {
        provider: "duckduckgo",
      },
    },
  },
}
지역 및 SafeSearch에 대한 선택적 Plugin 수준 설정: 
{
  plugins: {
    entries: {
      duckduckgo: {
        config: {
          webSearch: {
            region: "us-en", // DuckDuckGo region code
            safeSearch: "moderate", // "strict", "moderate", or "off"
          },
        },
      },
    },
  },
}

​
도구 매개변수

​
query
string
필수
검색 쿼리입니다.
​
count
number
기본값:"5"
반환할 결과 수입니다(1~10).
​
region
string
DuckDuckGo 지역 코드입니다(예: us-en, uk-en, de-de).
​
safeSearch
'strict' | 'moderate' | 'off'
기본값:"moderate"
SafeSearch 수준입니다.
지역 및 SafeSearch는 Plugin 구성에서도 설정할 수 있습니다(위 참조). 도구 매개변수는 쿼리별로 구성 값을 재정의합니다.

​
참고 사항

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

​
관련 항목