メインコンテンツへスキップ

​
SearXNG Search

OpenClawは、SearXNG を セルフホスト型 かつ キー不要 の web_search プロバイダーとしてサポートしています。SearXNGは、 Google、Bing、DuckDuckGo などのソースから結果を集約するオープンソースの メタ検索エンジンです。 利点:
  • 無料かつ無制限 — APIキーや商用サブスクリプションは不要
  • プライバシー / エアギャップ — クエリがネットワーク外へ出ない
  • どこでも使える — 商用検索APIのリージョン制限なし

​
セットアップ

1

SearXNGインスタンスを実行する

docker run -d -p 8888:8080 searxng/searxng
または、アクセス可能な既存のSearXNGデプロイメントを使用してください。実運用向けセットアップについては SearXNG documentation を参照してください。
2

設定する

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 オブジェクトも受け付けます。 トランスポートルール:
  • https:// は公開または非公開のSearXNGホストで利用可能
  • http:// は信頼できるプライベートネットワークまたはloopbackホストでのみ受け付けられる
  • 公開SearXNGホストでは https:// を使用する必要がある

​
環境変数

設定の代わりに SEARXNG_BASE_URL を設定します: 
export SEARXNG_BASE_URL="http://localhost:8888"
SEARXNG_BASE_URL が設定されていて、明示的なプロバイダー設定がない場合、 自動検出は自動的にSearXNGを選択します（優先度は最低です — キー付きのAPIベースプロバイダーがあればそちらが先に選ばれます）。

​
plugin設定リファレンス

Field説明
baseUrlSearXNGインスタンスのベースURL（必須）
categoriesgeneral、news、science などのカンマ区切りカテゴリ
languageen、de、fr などの結果用言語コード

​
注意

  • JSON API — HTMLスクレイピングではなく、SearXNGネイティブの format=json エンドポイントを使用
  • APIキー不要 — どのSearXNGインスタンスでもそのまま動作
  • ベースURL検証 — baseUrl は有効な http:// または https:// URLである必要があります。公開ホストでは https:// を使用する必要があります
  • 自動検出順序 — SearXNGは自動検出で最後（順序200）に確認されます。 キーが設定されたAPIベースプロバイダーが先に実行され、その後 DuckDuckGo（順序100）、次に Ollama Web Search（順序110）が続きます
  • セルフホスト型 — インスタンス、クエリ、上流検索エンジンを自分で制御できます
  • カテゴリ は未設定時に general がデフォルトになります
SearXNG JSON API を動作させるには、SearXNGインスタンスの settings.yml にある search.formats で json 形式が有効になっていることを確認してください。

​
関連