SearXNG 검색

• 무료 및 무제한 — API 키나 상용 구독이 필요하지 않음
• 개인정보 보호 / 에어 갭 — 쿼리가 네트워크 외부로 전송되지 않음
• 어디서나 작동 — 상용 검색 API의 지역 제한이 없음

​

설정

openclaw plugins install @openclaw/searxng-plugin

docker run -d -p 8888:8080 searxng/searxng

openclaw configure --section web
# 제공자로 "searxng" 선택

export SEARXNG_BASE_URL="http://localhost:8888"

​

구성

{
  tools: {
    web: {
      search: {
        provider: "searxng",
      },
    },
  },
}

{
  plugins: {
    entries: {
      searxng: {
        config: {
          webSearch: {
            baseUrl: "http://localhost:8888",
            categories: "general,news", // 선택 사항
            language: "en", // 선택 사항
          },
        },
      },
    },
  },
}

​

환경 변수

export SEARXNG_BASE_URL="http://localhost:8888"

​

Plugin 구성 참조

​

참고 사항

• JSON API — HTML 스크래핑이 아닌 SearXNG의 네이티브 format=json 엔드포인트 사용
• 이미지 결과 URL — SearXNG가 직접 이미지 URL을 반환하면 이미지 카테고리 결과에 img_src가 포함됨
• API 키 불필요 — 모든 SearXNG 인스턴스에서 별도 설정 없이 작동
• 기본 URL 유효성 검사 — baseUrl은 유효한 http:// 또는 https:// URL이어야 함
• 네트워크 보호 — http:// 기본 URL은 신뢰할 수 있는 비공개 또는 local loopback 호스트를 대상으로 해야 하며(공개 호스트는 https://를 사용해야 함), 비공개/내부 주소로 확인되는 https:// 기본 URL에는 동일한 자체 호스팅 허용 사항이 적용되는 반면, 공개 주소로 확인되는 https:// 기본 URL에는 엄격한 SSRF 보호가 유지됨
• 자동 감지 순서 — SearXNG에는 구성된 baseUrl이 필요함(필수 자격 증명이 이미 있는 제공자 중 순서 200). DuckDuckGo 또는 Ollama Web Search와 같이 키가 필요 없는 제공자는 암시적으로 자동 감지에서 선택되지 않으며, 명시적으로 provider를 선택한 경우에만 활성화됨
• 자체 호스팅 — 인스턴스, 쿼리 및 업스트림 검색 엔진을 직접 제어
• 카테고리는 구성하지 않으면 기본값으로 general 사용
• 카테고리 대체 처리 — general이 아닌 카테고리 요청이 성공했지만 결과가 0개이면 OpenClaw은 빈 결과 집합을 반환하기 전에 동일한 쿼리를 general로 한 번 재시도함
• 결과 캐싱 — 동일한 쿼리(동일한 쿼리, 개수, 카테고리, 언어 및 기본 URL)는 짧은 TTL 동안 프로세스 내에 캐시됨
• 버전 요구 사항 — Plugin은 minHostVersion: >=2026.6.9를 선언함

​

관련 문서

• 웹 검색 개요 — 모든 제공자 및 자동 감지
• DuckDuckGo 검색 — 키가 필요 없는 또 다른 제공자
• Brave 검색 — 무료 등급이 있는 구조화된 결과