SearXNG 검색

OpenClaw은 SearXNG를 자체 호스팅되며 키가 필요 없는 web_search 제공자로 지원합니다. SearXNG는 Google, Bing, DuckDuckGo 및 기타 소스의 결과를 집계하는 오픈 소스 메타 검색 엔진입니다.

장점:

• 무료 및 무제한 -- 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",      },    },  },}

SearXNG 인스턴스에 대한 Plugin 수준 설정:

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

baseUrl은 SecretRef 객체도 허용합니다(예: { source: "env", id: "SEARXNG_BASE_URL" }).

환경 변수

구성 대신 SEARXNG_BASE_URL을 설정할 수 있습니다.

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

확인 순서는 구성된 baseUrl 문자열, baseUrl의 인라인 환경 변수 SecretRef, SEARXNG_BASE_URL 순입니다. 구성 경로가 하나도 설정되지 않았고 명시적으로 선택한 제공자 없이 SEARXNG_BASE_URL이 있으면 자동 감지가 SearXNG를 선택합니다.

Plugin 구성 참조

web_search 도구 호출은 호출별 재정의 값으로 count(결과 1~10개), categories, language도 허용합니다.

참고 사항

• 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 검색 -- 무료 등급이 있는 구조화된 결과