---
read_when:
    - شما یک ارائه‌دهندهٔ جستجوی وب خودمیزبان می‌خواهید
    - می‌خواهید از SearXNG برای web_search استفاده کنید
    - به یک گزینهٔ جستجوی متمرکز بر حریم خصوصی یا جداسازی‌شده از شبکه نیاز دارید
summary: جست‌وجوی وب SearXNG -- ارائه‌دهندهٔ فراجست‌وجوی خودمیزبان و بدون نیاز به کلید
title: جست‌وجوی SearXNG
x-i18n:
    generated_at: "2026-05-02T12:06:25Z"
    model: gpt-5.5
    provider: openai
    source_hash: b9be62f7398379e1672ea7e934a571a529cac07dc5d880ac74e51f8445594034
    source_path: tools/searxng-search.md
    workflow: 16
---

OpenClaw از [SearXNG](https://docs.searxng.org/) به‌عنوان ارائه‌دهنده‌ی `web_search` **خودمیزبان و
بدون نیاز به کلید** پشتیبانی می‌کند. SearXNG یک موتور فرا جست‌وجوی متن‌باز است
که نتایج را از Google، Bing، DuckDuckGo و منابع دیگر گردآوری می‌کند.

مزایا:

- **رایگان و نامحدود** -- به کلید API یا اشتراک تجاری نیاز ندارد
- **حریم خصوصی / شبکه‌ی ایزوله** -- پرس‌وجوها هرگز از شبکه‌ی شما خارج نمی‌شوند
- **در هرجا کار می‌کند** -- محدودیت‌های منطقه‌ای APIهای جست‌وجوی تجاری را ندارد

## راه‌اندازی

<Steps>
  <Step title="اجرای یک نمونه‌ی SearXNG">
    ```bash
    docker run -d -p 8888:8080 searxng/searxng
    ```

    یا از هر استقرار موجود SearXNG که به آن دسترسی دارید استفاده کنید. برای راه‌اندازی تولید،
    [مستندات SearXNG](https://docs.searxng.org/) را ببینید.

  </Step>
  <Step title="پیکربندی">
    ```bash
    openclaw configure --section web
    # Select "searxng" as the provider
    ```

    یا متغیر محیطی را تنظیم کنید و اجازه دهید تشخیص خودکار آن را پیدا کند:

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

  </Step>
</Steps>

## پیکربندی

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

تنظیمات سطح Plugin برای نمونه‌ی SearXNG:

```json5
{
  plugins: {
    entries: {
      searxng: {
        config: {
          webSearch: {
            baseUrl: "http://localhost:8888",
            categories: "general,news", // optional
            language: "en", // optional
          },
        },
      },
    },
  },
}
```

فیلد `baseUrl` اشیای SecretRef را نیز می‌پذیرد.

قواعد انتقال:

- `https://` برای میزبان‌های عمومی یا خصوصی SearXNG کار می‌کند
- `http://` فقط برای میزبان‌های قابل‌اعتماد در شبکه‌ی خصوصی یا loopback پذیرفته می‌شود
- میزبان‌های عمومی SearXNG باید از `https://` استفاده کنند
- میزبان‌های خصوصی/داخلی از محافظ شبکه‌ی خودمیزبان استفاده می‌کنند؛ میزبان‌های عمومی `https://`
  روی محافظ سخت‌گیرانه‌ی جست‌وجوی وب باقی می‌مانند و نمی‌توانند به نشانی‌های خصوصی
  تغییرمسیر دهند

## متغیر محیطی

`SEARXNG_BASE_URL` را به‌عنوان جایگزینی برای پیکربندی تنظیم کنید:

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

وقتی `SEARXNG_BASE_URL` تنظیم شده باشد و ارائه‌دهنده‌ی صریحی پیکربندی نشده باشد، تشخیص خودکار
SearXNG را به‌طور خودکار انتخاب می‌کند (با پایین‌ترین اولویت -- هر ارائه‌دهنده‌ی مبتنی بر API که
کلید داشته باشد ابتدا برنده می‌شود).

## مرجع پیکربندی Plugin

| فیلد        | توضیح                                                        |
| ------------ | ------------------------------------------------------------------ |
| `baseUrl`    | URL پایه‌ی نمونه‌ی SearXNG شما (الزامی)                       |
| `categories` | دسته‌های جداشده با کاما مانند `general`، `news` یا `science` |
| `language`   | کد زبان برای نتایج مانند `en`، `de` یا `fr`              |

## نکات

- **API JSON** -- از نقطه‌ی پایانی بومی `format=json` در SearXNG استفاده می‌کند، نه استخراج از HTML
- **URLهای نتایج تصویر** -- نتایج دسته‌ی تصویر وقتی SearXNG
  یک URL مستقیم تصویر برگرداند، شامل `img_src` هستند
- **بدون کلید API** -- با هر نمونه‌ی SearXNG بدون تنظیمات اضافه کار می‌کند
- **اعتبارسنجی URL پایه** -- `baseUrl` باید یک URL معتبر `http://` یا `https://`
  باشد؛ میزبان‌های عمومی باید از `https://` استفاده کنند
- **محافظ شبکه** -- نقاط پایانی خصوصی/داخلی SearXNG برای دسترسی
  به شبکه‌ی خصوصی opt in می‌کنند؛ نقاط پایانی عمومی `https://` SearXNG محافظت سخت‌گیرانه‌ی SSRF
  را حفظ می‌کنند
- **ترتیب تشخیص خودکار** -- SearXNG در تشخیص خودکار آخر از همه بررسی می‌شود (ترتیب 200).
  ارائه‌دهندگان مبتنی بر API با کلیدهای پیکربندی‌شده ابتدا اجرا می‌شوند، سپس
  DuckDuckGo (ترتیب 100)، سپس Ollama Web Search (ترتیب 110)
- **خودمیزبان** -- شما نمونه، پرس‌وجوها و موتورهای جست‌وجوی بالادستی را کنترل می‌کنید
- **دسته‌ها** وقتی پیکربندی نشده باشند، به‌طور پیش‌فرض `general` هستند
- **بازگشت دسته** -- اگر درخواست دسته‌ای غیر از `general` موفق شود اما
  هیچ نتیجه‌ای برنگرداند، OpenClaw همان پرس‌وجو را پیش از برگرداندن مجموعه‌نتایج خالی،
  یک‌بار با `general` دوباره امتحان می‌کند

<Tip>
  برای اینکه API JSON در SearXNG کار کند، مطمئن شوید نمونه‌ی SearXNG شما قالب `json`
  را در `settings.yml` خود زیر `search.formats` فعال کرده است.
</Tip>

## مرتبط

- [نمای کلی جست‌وجوی وب](/fa/tools/web) -- همه‌ی ارائه‌دهندگان و تشخیص خودکار
- [جست‌وجوی DuckDuckGo](/fa/tools/duckduckgo-search) -- یک fallback دیگر بدون نیاز به کلید
- [جست‌وجوی Brave](/fa/tools/brave-search) -- نتایج ساختاریافته با سطح رایگان