Skip to main content
Parallel Plugin は、2つの Parallel web_search プロバイダーを提供します。どちらも、AI エージェント向けに構築された Web インデックスから、 順位付けされた LLM 最適化済みの抜粋を返します。 明示的に選択するには、tools.web.search.providerparallel-free または parallel に設定します。どちらも自動検出されません。
OpenAI Responses の直接モデル(api: "openai-responses"、プロバイダー openai、公式 API ベース URL)は、tools.web.search.provider が未設定、空、 "auto"、または "openai" の場合、OpenAI がホストするネイティブ Web 検索を 自動的に使用するため、デフォルトでは Parallel を経由しません。代わりに Parallel を経由させるには、 tools.web.search.providerparallel-free または parallel に設定します。 Web 検索の概要を参照してください。

Plugin のインストール

API キー(有料プロバイダー)

parallel-free にはキーは不要ですが、明示的に選択する必要があります。有料の parallel プロバイダーには API キーが必要です。
1

アカウントを作成

platform.parallel.ai で登録し、 ダッシュボードから API キーを生成します。
2

キーを保存

Gateway 環境に PARALLEL_API_KEY を設定するか、次のコマンドで構成します。

構成

環境変数による代替方法: Gateway 環境に PARALLEL_API_KEY を設定します。 Gateway インストールでは、~/.openclaw/.env に記述します。

ベース URL の上書き

有料の parallel プロバイダーにのみ適用されます。parallel-free は常に https://search.parallel.ai/mcp を使用し、この設定を無視します。 互換性のあるプロキシまたは代替エンドポイント(たとえば Cloudflare AI Gateway)を 経由して有料リクエストを送信するには、plugins.entries.parallel.config.webSearch.baseUrl を設定します。 OpenClaw はベアホストの先頭に https:// を付加して正規化し、 パスがすでに /v1/search で終わっていない限り、それを末尾に追加します。 解決されたエンドポイントは検索キャッシュキーの一部になるため、異なる エンドポイントの結果が共有されることはありません。

ツールパラメーター

どちらのプロバイダーも Parallel のネイティブ検索形式を公開するため、モデルは 自然言語による目標と、少数の短いキーワードクエリを入力します。この組み合わせは、 最良の結果を得るために Parallel が推奨しています。
string
必須
根本となる質問または目標の自然言語による説明(最大 5000 文字)。 それだけで内容が完結している必要があります。
string[]
必須
簡潔なキーワード検索クエリ。各 3~6 語(1~5 件、各最大 200 文字)。 最良の結果を得るには、多様なクエリを 2~3 件指定します。
number
返す結果数(1~40)。
string
以前の結果の sessionId から取得した、任意の Parallel セッション ID。 同じタスク内の後続検索で渡すと、Parallel が関連する呼び出しをグループ化し、 後続の結果を改善します。parallel では最大 1000 文字です。無料の parallel-free Search MCP では最大 100 文字に制限されます。上限を超える ID は、 有料版では破棄され、無料版では新しい ID が生成されます。
string
呼び出しを行うモデルの任意の識別子(例: claude-opus-4-7gpt-5.6-sol)。最大 100 文字です。Parallel がモデルの機能に合わせて デフォルト設定を調整できるようにします。正確なアクティブモデルのスラッグを渡し、 ファミリーのエイリアスに短縮しないでください。

注記

  • Parallel は、人間によるリンクのクリックではなく LLM の推論での有用性を基準に結果を順位付けして圧縮します。 ページ全体のコンテンツではなく、結果ごとに情報密度の高い抜粋が返されます。
  • 結果の抜粋は excerpts 配列として返されるほか、汎用の web_search コントラクトとの互換性のために結合されて description にも格納されます。
  • どちらのプロバイダーも session_id を返します。OpenClaw はツールペイロード内で これを sessionId として公開し、呼び出し元が後続検索をグループ化できるようにします。 Parallel が生成したセッション ID(呼び出し元が指定していないもの)はキャッシュエントリから除外されます。 これは、同一のクエリを使用する無関係なタスクがその ID を引き継がないようにするためです。
  • Parallel からの searchIdwarnings、および usage は、 存在する場合、そのまま渡されます。
  • OpenClaw は、解決された結果数を常に advanced_settings.max_resultsparallel)として Parallel に転送するか、Parallel の固定サイズのレスポンス(parallel-free)に対して クライアント側で count を適用します。呼び出し元の count 引数が最優先され、 次に tools.web.search.maxResults、それ以外の場合は OpenClaw の汎用 web_search のデフォルト値(5)が 使用されます。Parallel 自体の API のデフォルト値は 10 です。
  • 結果はデフォルトで 15 分間キャッシュされます(cacheTtlMinutes)。
  • 呼び出し元が指定しない場合、parallel-free は MCP ハンドシェイクを介して 呼び出しごとに新しい session_id を生成します。一方、parallel は その場合、未設定のままにします。

関連項目