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 を宣言します

​

関連項目

• Web 検索の概要 — すべてのプロバイダーと自動検出
• DuckDuckGo Search — 別のキー不要プロバイダー
• Brave Search — 無料枠付きの構造化された結果