SearXNG 검색

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

장점:

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

설정

openclaw plugins install @openclaw/searxng-plugin

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

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

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", // optional            language: "en", // optional          },        },      },    },  },}

baseUrl 필드는 SecretRef 객체도 허용합니다.

전송 규칙:

• https://는 공개 또는 비공개 SearXNG 호스트에서 작동합니다
• http://는 신뢰할 수 있는 비공개 네트워크 또는 루프백 호스트에만 허용됩니다
• 공개 SearXNG 호스트는 https://를 사용해야 합니다
• 비공개/내부 호스트는 자체 호스팅 네트워크 가드를 사용합니다. 공개 https:// 호스트는 엄격한 웹 검색 가드를 유지하며 비공개 주소로 리디렉션할 수 없습니다

환경 변수

구성의 대안으로 SEARXNG_BASE_URL을 설정하세요:

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

SEARXNG_BASE_URL이 설정되어 있고 명시적 제공자가 구성되지 않은 경우, 자동 감지는 SearXNG를 자동으로 선택합니다(가장 낮은 우선순위 -- 키가 있는 API 기반 제공자가 먼저 선택됩니다).

Plugin 구성 참조

참고

• JSON API -- HTML 스크래핑이 아니라 SearXNG의 기본 format=json 엔드포인트를 사용합니다
• 이미지 결과 URL -- SearXNG가 직접 이미지 URL을 반환하면 이미지 카테고리 결과에 img_src가 포함됩니다
• API 키 없음 -- 어떤 SearXNG 인스턴스에서도 바로 작동합니다
• 기본 URL 검증 -- baseUrl은 유효한 http:// 또는 https:// URL이어야 합니다. 공개 호스트는 https://를 사용해야 합니다
• 네트워크 가드 -- 비공개/내부 SearXNG 엔드포인트는 비공개 네트워크 접근을 명시적으로 사용합니다. 공개 https:// SearXNG 엔드포인트는 엄격한 SSRF 보호를 유지합니다
• 자동 감지 순서 -- SearXNG는 구성된 키가 있는 API 기반 제공자 뒤에 확인됩니다(순서 200). DuckDuckGo 또는 Ollama Web Search 같은 키 없는 제공자는 명시적 제공자 선택 없이는 자동 선택되지 않습니다
• 자체 호스팅 -- 인스턴스, 쿼리, 업스트림 검색 엔진을 직접 제어합니다
• 카테고리는 구성되지 않은 경우 기본값으로 general을 사용합니다
• 카테고리 폴백 -- general이 아닌 카테고리 요청이 성공했지만 결과가 0개이면, OpenClaw는 빈 결과 집합을 반환하기 전에 같은 쿼리를 general로 한 번 다시 시도합니다

관련 항목

• 웹 검색 개요 -- 모든 제공자 및 자동 감지
• DuckDuckGo 검색 -- 또 다른 키 없는 제공자
• Brave Search -- 무료 티어가 있는 구조화된 결과