DuckDuckGo search

기준일: 2026-07-26
난이도: 중급
공식 기준: DuckDuckGo search

개요

이 페이지는 OpenClaw DuckDuckGo search 도구(파라미터, 권한, 설정, CLI)를 공식 문서 기준으로 정리합니다.

공식 요약: DuckDuckGo web search -- key-free provider (experimental, HTML-based)

도구 가시성은 profile / allow·deny policy / sandbox / channel 권한에 따라 달라집니다. 최신 스키마는 항상 공식 문서를 우선합니다.

공식 문서 기반 상세

아래는 공식 tools/duckduckgo-search 문서를 정리한 내용입니다. 코드 블록, 파라미터 이름, 기본값은 원문 그대로입니다.

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

DuckDuckGo is an experimental, unofficial integration that scrapes DuckDuckGo's non-JavaScript HTML search pages -- not an official API. Expect occasional breakage from bot-challenge pages or HTML changes.

설정

DuckDuckGo is never auto-selected, since auto-detection only considers providers with usable credentials. Set it explicitly:

Configure

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

Config

Set the provider directly in 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

• query (string) (required): Search query.

• count (number) · default: 5: Results to return (1-10).

• region (string): DuckDuckGo region code (e.g. us-en, uk-en, de-de).

• safeSearch ('strict' | 'moderate' | 'off') · default: moderate: SafeSearch level.

region and safeSearch tool parameters override the plugin config values above on a per-query basis.

참고

• No API key -- works once DuckDuckGo is selected as the web_search provider.
• Experimental -- scrapes DuckDuckGo's non-JavaScript HTML search pages, not an official API or SDK. Results depend on page structure, which can change without notice.
• Bot-challenge risk -- DuckDuckGo may serve CAPTCHAs or block requests under heavy or automated use.
• Explicit selection only -- OpenClaw's auto-detect only considers providers with usable credentials, so a key-free provider like DuckDuckGo is never chosen automatically; you must set provider: "duckduckgo".
• SafeSearch defaults to moderate when not configured.

For production use, consider Brave Search (free tier available) or another API-backed provider.

관련 문서

• Web Search overview -- all providers and auto-detection
• Brave Search -- structured results with free tier
• Exa Search -- neural search with content extraction

검증 체크리스트

• 해당 tool이 활성 profile/policy에서 허용되는지 확인
• sandbox / elevated / host 실행 경로 정책을 이해했는지 확인
• 채널·에이전트 권한과 충돌하지 않는지 확인
• 공식 CLI/--help와 문서 옵션이 버전과 맞는지 확인

관련

• Tools 목록 인덱스
• 공식: Tools overview, Tools and custom providers