> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# SearXNG 검색

OpenClaw는 **자체 호스팅,
키 없는** `web_search` 제공자로 [SearXNG](https://docs.searxng.org/)를 지원합니다. SearXNG는 Google, Bing, DuckDuckGo 및 기타 소스의 결과를 집계하는 오픈 소스 메타 검색 엔진입니다.

장점:

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

## 설정

<Steps>
  <Step title="Plugin 설치">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw plugins install @openclaw/searxng-plugin
    ```
  </Step>

  <Step title="SearXNG 인스턴스 실행">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    docker run -d -p 8888:8080 searxng/searxng
    ```

    또는 접근할 수 있는 기존 SearXNG 배포를 사용하세요. 프로덕션 설정은
    [SearXNG 문서](https://docs.searxng.org/)를 참고하세요.
  </Step>

  <Step title="구성">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw configure --section web
    # Select "searxng" as the provider
    ```

    또는 환경 변수를 설정하고 자동 감지가 찾도록 합니다:

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    export SEARXNG_BASE_URL="http://localhost:8888"
    ```
  </Step>
</Steps>

## 구성

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  tools: {
    web: {
      search: {
        provider: "searxng",
      },
    },
  },
}
```

SearXNG 인스턴스의 Plugin 수준 설정:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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`을 설정하세요:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
export SEARXNG_BASE_URL="http://localhost:8888"
```

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

## Plugin 구성 참조

| 필드           | 설명                                           |
| ------------ | -------------------------------------------- |
| `baseUrl`    | SearXNG 인스턴스의 기본 URL(필수)                     |
| `categories` | `general`, `news`, `science` 같은 쉼표로 구분된 카테고리 |
| `language`   | `en`, `de`, `fr` 같은 결과의 언어 코드                |

## 참고

* **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`로
  한 번 다시 시도합니다

<Tip>
  SearXNG JSON API가 작동하려면 SearXNG 인스턴스의 `settings.yml`에서
  `search.formats` 아래에 `json` 형식이 활성화되어 있는지 확인하세요.
</Tip>

## 관련 항목

* [웹 검색 개요](/ko/tools/web) -- 모든 제공자 및 자동 감지
* [DuckDuckGo 검색](/ko/tools/duckduckgo-search) -- 또 다른 키 없는 제공자
* [Brave Search](/ko/tools/brave-search) -- 무료 티어가 있는 구조화된 결과