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 は、信頼されたプライベートホストまたはループバックホストを指定する必要がある（公開ホストでは 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 検索 -- 別のキー不要プロバイダー
• Brave 検索 -- 無料枠付きの構造化された結果