Tools

並列検索

Parallel Plugin は、2 つの Parallel web_search プロバイダーを提供します。どちらも、AI エージェント向けに構築されたウェブインデックスから、順位付けされ、LLM 向けに最適化された抜粋を返します。

プロバイダー	id	認証
Parallel Search（無料）	`parallel-free`	なし -- Parallel の無料 Search MCP
Parallel Search	`parallel`	`PARALLEL_API_KEY` -- 有料 Search API、より高いレート制限と目的の調整

明示的に選択するには、tools.web.search.provider を parallel-free または parallel に設定します。どちらも自動検出されません。

Plugin のインストール

bash

openclaw plugins install @openclaw/parallel-pluginopenclaw gateway restart

API キー（有料プロバイダー）

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

アカウントを作成

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

キーを保存

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

bash

openclaw configure --section web

設定

json5

{  plugins: {    entries: {      parallel: {        config: {          webSearch: {            apiKey: "par-...", // PARALLEL_API_KEY が設定されている場合は省略可能            baseUrl: "https://api.parallel.ai", // 省略可能。OpenClaw が /v1/search を追加          },        },      },    },  },  tools: {    web: {      search: {        // 無料の Search MCP には "parallel-free"、ここで示す        // 有料 API ベースのプロバイダーには "parallel"。        provider: "parallel",      },    },  },}

環境変数による代替方法： 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 が推奨しているものです。

objectivestringrequired

根底にある質問または目的の自然言語による説明（最大 5000 文字）。それ単独で内容が理解できるようにする必要があります。

search_queriesstring[]required

簡潔なキーワード検索クエリ。各 3～6 語（1～5 件、各最大 200 文字）。最良の結果を得るには、異なる観点のクエリを 2～3 件指定します。

countnumber

返す結果数（1～40）。

session_idstring

以前の結果の sessionId から取得した、任意指定の Parallel セッション ID。同じタスク内の後続検索に渡すと、Parallel が関連する呼び出しをグループ化し、以降の結果を改善できます。parallel では最大 1000 文字、無料の parallel-free Search MCP では最大 100 文字です。上限を超える ID は、有料版では破棄され、無料版では新しい ID が発行されます。

client_modelstring

呼び出し元モデルの任意指定の識別子（例：claude-opus-4-7、 gpt-5.6-sol）。最大 100 文字です。Parallel がモデルの能力に合わせてデフォルト設定を調整できるようにします。有効なモデルの正確なスラッグを渡し、ファミリーのエイリアスに短縮しないでください。

注記

Parallel は、人間によるリンク先の閲覧ではなく、LLM の推論に役立つことを目的として結果を順位付けし圧縮します。ページ全体の内容ではなく、結果ごとに情報量の多い抜粋が返されます。
結果の抜粋は excerpts 配列として返され、汎用 web_search 契約との互換性のために結合されて description にも格納されます。
どちらのプロバイダーも session_id を返します。OpenClaw はツールペイロードでこれを sessionId として公開し、呼び出し元が後続検索をグループ化できるようにします。 Parallel が生成したセッション ID（呼び出し元が指定していないもの）は、同一クエリを使用する無関係なタスクに引き継がれないよう、キャッシュエントリから除外されます。
Parallel の searchId、warnings、usage は、存在する場合にそのまま渡されます。
OpenClaw は、解決された結果数を常に advanced_settings.max_results（parallel）として Parallel に転送するか、Parallel の固定件数レスポンスを受け取った後にクライアント側で count を適用します（parallel-free）。呼び出し元の count 引数が最優先され、次に tools.web.search.maxResults、それ以外の場合は OpenClaw の汎用 web_search デフォルト値（5）が使用されます。Parallel 自体の API のデフォルト値は 10 です。
結果はデフォルトで 15 分間キャッシュされます（cacheTtlMinutes）。
呼び出し元が session_id を指定しない場合、parallel-free は MCP ハンドシェイクを通じて呼び出しごとに新しい session_id を発行します。parallel はその場合、未設定のままにします。