メインコンテンツへスキップ
Parallel Plugin は、2 つの Parallel web_search プロバイダーを提供します。
  • Parallel Search (Free) (parallel-free) — Parallel の無料 Search MCP。アカウントや API キーは不要です。Parallel のホスト型 キー不要検索パスを使いたい場合に明示的に選択します。
  • Parallel Search (parallel) — Parallel の有料 Search API。PARALLEL_API_KEY が必要で、より高いレート制限と objective チューニングを提供します。
どちらも、AI エージェント向けに構築された Web インデックスから、ランキング済みで LLM 向けに最適化された抜粋を返します。 どちらかを明示的に選択するには、tools.web.search.provider を parallel-free または parallel に設定します。
OpenAI Responses モデルは、tools.web.search.provider が未設定の場合、 OpenAI のネイティブ Web 検索を使用するため、Parallel プロバイダーをバイパスします。 Parallel 経由にルーティングするには、tools.web.search.provider を parallel-free または parallel に設定します。

​
Plugin をインストールする

公式 Plugin をインストールしてから、Gateway を再起動します。 
openclaw plugins install @openclaw/parallel-plugin
openclaw gateway restart

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

parallel-free には API キーは不要ですが、管理対象プロバイダーとして選択する必要があります。 有料の parallel プロバイダーには API キーが必要です。
1

アカウントを作成する

platform.parallel.ai でサインアップし、 ダッシュボードから API キーを生成します。
2

キーを保存する

Gateway 環境で PARALLEL_API_KEY を設定するか、次で構成します。
openclaw configure --section web

​
設定

{
  plugins: {
    entries: {
      parallel: {
        config: {
          webSearch: {
            apiKey: "par-...", // optional if PARALLEL_API_KEY is set
            baseUrl: "https://api.parallel.ai", // optional; OpenClaw appends /v1/search
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        // Use "parallel-free" for the free Search MCP, or "parallel" for
        // the paid API-backed provider shown here.
        provider: "parallel",
      },
    },
  },
}
環境変数の代替: Gateway 環境で PARALLEL_API_KEY を設定します。 Gateway インストールでは、~/.openclaw/.env に配置します。

​
ベース URL の上書き

ベース URL の上書きは、有料の parallel プロバイダーのみに適用されます。無料の parallel-free プロバイダーは常に https://search.parallel.ai/mcp を使用します。 Parallel リクエストを互換プロキシまたは代替の Parallel エンドポイント（たとえば Cloudflare AI Gateway）経由にする必要がある場合は、 plugins.entries.parallel.config.webSearch.baseUrl を設定します。OpenClaw は、 裸のホストの先頭に https:// を付け、パスがすでにそこで終わっていない限り /v1/search を追加して正規化します。解決済みエンドポイントは検索キャッシュキーに含まれるため、 異なる Parallel エンドポイントからの結果は共有されません。

​
ツールパラメーター

OpenClaw は Parallel のネイティブ検索形状を公開するため、モデルは自然言語のゴールと いくつかの短いキーワードクエリの両方を入力できます。これは最良の結果のために Parallel が推奨する組み合わせです。
​
objective
string
必須
基になる質問またはゴールの自然言語による説明（最大 5000 文字）。 自己完結している必要があります。
​
search_queries
string[]
必須
簡潔なキーワード検索クエリ。各 3～6 語（1～5 件、各最大 200 文字）。 最良の結果のために、2～3 個の多様なクエリを指定します。
​
count
number
返す結果数（1～40）。
​
session_id
string
任意の Parallel セッション ID（parallel では最大 1000 文字、無料の parallel-free Search MCP では 100 文字に制限）。同じタスクの一部であるフォローアップ検索では、 以前の Parallel 結果の sessionId を渡すと、Parallel が関連する呼び出しをグループ化し、 後続の結果を改善できます。上限を超える ID は破棄され、新しい ID が生成されます。
​
client_model
string
呼び出しを行うモデルの任意の識別子（例: claude-opus-4-7、 gpt-5.5）。Parallel がモデルの能力に合わせてデフォルト設定を調整できるようにします。 有効なモデルの正確な slug を渡し、ファミリーのエイリアスに短縮しないでください。

​
注記

  • Parallel は、人間のクリック率ではなく LLM 推論での有用性に基づいて結果をランク付けし圧縮します。 各結果にはフルページの内容ではなく、密度の高い抜粋が含まれると考えてください
  • 結果の抜粋は excerpts 配列として返され、汎用 web_search コントラクトとの互換性のために description フィールドにも結合されます
  • Parallel はすべてのレスポンスで session_id を返します。OpenClaw はツールペイロード内で sessionId として公開するため、呼び出し元はフォローアップ検索をグループ化できます
  • Parallel からの searchId、warnings、usage は、存在する場合にそのまま渡されます
  • OpenClaw は、解決済みの結果数を常に advanced_settings.max_results として Parallel に転送します。呼び出し元の count 引数が優先され、次にトップレベルの tools.web.search.maxResults 設定、それ以外の場合は OpenClaw の汎用 web_search デフォルト（5）が使用されます。これにより、プロバイダーを切り替えても結果数が一貫します。 Parallel 単独のデフォルトは 10 です
  • 結果はデフォルトで 15 分間キャッシュされます（cacheTtlMinutes で構成可能）
  • 無料の parallel-free プロバイダーは同じパラメーターを受け入れます。count はクライアント側で適用され、 指定されていない場合は呼び出しごとに session_id を生成します。

​
関連