Parallel search

기준일: 2026-07-26
난이도: 중급
공식 기준: Parallel search

개요

이 페이지는 OpenClaw Parallel search 도구(파라미터, 권한, 설정, CLI)를 공식 문서 기준으로 정리합니다.

공식 요약: Parallel Search -- LLM-optimized dense excerpts from web sources

도구 가시성은 profile / allow·deny policy / sandbox / channel 권한에 따라 달라집니다. 최신 스키마는 항상 공식 문서를 우선합니다.

공식 문서 기반 상세

아래는 공식 tools/parallel-search 문서를 정리한 내용입니다. 코드 블록, 파라미터 이름, 기본값은 원문 그대로입니다.

The Parallel plugin provides two Parallel web_search providers, both returning ranked, LLM-optimized excerpts from a web index built for AI agents:

Provider	id	Auth
Parallel Search (Free)	`parallel-free`	None -- Parallel's free Search MCP
Parallel Search	`parallel`	`PARALLEL_API_KEY` -- paid Search API, higher rate limits and objective tuning

Set tools.web.search.provider to parallel-free or parallel to select one explicitly; neither is auto-detected.

Direct OpenAI Responses models (api: "openai-responses", provider openai, official API base URL) use OpenAI's hosted native web search automatically when tools.web.search.provider is unset, empty, "auto", or "openai" -- so they bypass Parallel by default. Set tools.web.search.provider to parallel-free or parallel to route them through Parallel instead. See Web Search overview.

Install plugin

openclaw plugins install @openclaw/parallel-plugin
openclaw gateway restart

API key (paid provider)

parallel-free needs no key but still must be selected explicitly. The paid parallel provider needs an API key:

Create an account

Sign up at [platform.parallel.ai](https://platform.parallel.ai) and
generate an API key from your dashboard.

Store the key

Set `PARALLEL_API_KEY` in the Gateway environment, or configure via:

```bash
openclaw configure --section web
```

Config

{
  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: {
        // "parallel-free" for the free Search MCP, or "parallel" for the
        // paid API-backed provider shown here.
        provider: "parallel",
      },
    },
  },
}

Environment alternative: set PARALLEL_API_KEY in the Gateway environment. For a gateway install, put it in ~/.openclaw/.env.

Base URL override

Applies to the paid parallel provider only; parallel-free always uses https://search.parallel.ai/mcp and ignores this setting.

Set plugins.entries.parallel.config.webSearch.baseUrl to route paid requests through a compatible proxy or alternate endpoint (for example, the Cloudflare AI Gateway). OpenClaw normalizes bare hosts by prepending https:// and appends /v1/search unless the path already ends there. The resolved endpoint is part of the search cache key, so results from different endpoints are never shared.

Tool parameters

Both providers expose Parallel's native search shape so the model fills in a natural-language goal plus a few short keyword queries -- the pairing Parallel recommends for best results.

objective (string) (required): Natural-language description of the underlying question or goal (max 5000 chars). Should be self-contained.
search_queries (string[]) (required): Concise keyword search queries, 3-6 words each (1-5 entries, max 200 chars each). Provide 2-3 diverse queries for best results.
count (number): Results to return (1-40).
session_id (string): Optional Parallel session id from a previous result's sessionId. Pass it on follow-up searches in the same task so Parallel groups related calls and improves subsequent results. Max 1000 chars on parallel; the free parallel-free Search MCP caps it at 100. An id past the limit is dropped (paid) or a fresh one is minted (free).
client_model (string): Optional identifier of the model making the call (e.g. claude-opus-4-7, gpt-5.6-sol), max 100 chars. Lets Parallel tailor default settings for your model's capabilities. Pass the exact active model slug; do not shorten to a family alias.

참고

Parallel ranks and compresses results for LLM reasoning utility, not human click-through; expect dense excerpts per result rather than full-page content.
Result excerpts come back as the excerpts array and are also joined into description for compatibility with the generic web_search contract.
Both providers return a session_id; OpenClaw surfaces it as sessionId in the tool payload so callers can group follow-up searches. A Parallel-generated session id (one the caller did not supply) is excluded from the cache entry, since unrelated tasks with identical queries should not inherit it.
searchId, warnings, and usage from Parallel are passed through when present.
OpenClaw always forwards a resolved result count to Parallel as advanced_settings.max_results (parallel) or applies count client-side after Parallel's fixed-size response (parallel-free). The caller's count arg wins, then tools.web.search.maxResults, otherwise OpenClaw's generic web_search default (5) -- Parallel's own API defaults to 10.
Results are cached for 15 minutes by default (cacheTtlMinutes).
parallel-free mints a fresh session_id per call via its MCP handshake when the caller does not supply one; parallel leaves it unset in that case.

검증 체크리스트

해당 tool이 활성 profile/policy에서 허용되는지 확인
sandbox / elevated / host 실행 경로 정책을 이해했는지 확인
채널·에이전트 권한과 충돌하지 않는지 확인
공식 CLI/--help와 문서 옵션이 버전과 맞는지 확인

Parallel search

기준일: 2026-07-26
난이도: 중급
공식 기준: Parallel search

개요

이 페이지는 OpenClaw Parallel search 도구(파라미터, 권한, 설정, CLI)를 공식 문서 기준으로 정리합니다.

공식 요약: Parallel Search -- LLM-optimized dense excerpts from web sources

도구 가시성은 profile / allow·deny policy / sandbox / channel 권한에 따라 달라집니다. 최신 스키마는 항상 공식 문서를 우선합니다.

공식 문서 기반 상세

아래는 공식 tools/parallel-search 문서를 정리한 내용입니다. 코드 블록, 파라미터 이름, 기본값은 원문 그대로입니다.

The Parallel plugin provides two Parallel web_search providers, both returning ranked, LLM-optimized excerpts from a web index built for AI agents:

Provider	id	Auth
Parallel Search (Free)	`parallel-free`	None -- Parallel's free Search MCP
Parallel Search	`parallel`	`PARALLEL_API_KEY` -- paid Search API, higher rate limits and objective tuning

Set tools.web.search.provider to parallel-free or parallel to select one explicitly; neither is auto-detected.

Direct OpenAI Responses models (api: "openai-responses", provider openai, official API base URL) use OpenAI's hosted native web search automatically when tools.web.search.provider is unset, empty, "auto", or "openai" -- so they bypass Parallel by default. Set tools.web.search.provider to parallel-free or parallel to route them through Parallel instead. See Web Search overview.

Install plugin

openclaw plugins install @openclaw/parallel-plugin
openclaw gateway restart

API key (paid provider)

parallel-free needs no key but still must be selected explicitly. The paid parallel provider needs an API key:

Create an account

Sign up at [platform.parallel.ai](https://platform.parallel.ai) and
generate an API key from your dashboard.

Store the key

Set `PARALLEL_API_KEY` in the Gateway environment, or configure via:

```bash
openclaw configure --section web
```

Config

{
  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: {
        // "parallel-free" for the free Search MCP, or "parallel" for the
        // paid API-backed provider shown here.
        provider: "parallel",
      },
    },
  },
}

Environment alternative: set PARALLEL_API_KEY in the Gateway environment. For a gateway install, put it in ~/.openclaw/.env.

Base URL override

Applies to the paid parallel provider only; parallel-free always uses https://search.parallel.ai/mcp and ignores this setting.

Tool parameters

Both providers expose Parallel's native search shape so the model fills in a natural-language goal plus a few short keyword queries -- the pairing Parallel recommends for best results.

objective (string) (required): Natural-language description of the underlying question or goal (max 5000 chars). Should be self-contained.
search_queries (string[]) (required): Concise keyword search queries, 3-6 words each (1-5 entries, max 200 chars each). Provide 2-3 diverse queries for best results.
count (number): Results to return (1-40).
session_id (string): Optional Parallel session id from a previous result's sessionId. Pass it on follow-up searches in the same task so Parallel groups related calls and improves subsequent results. Max 1000 chars on parallel; the free parallel-free Search MCP caps it at 100. An id past the limit is dropped (paid) or a fresh one is minted (free).
client_model (string): Optional identifier of the model making the call (e.g. claude-opus-4-7, gpt-5.6-sol), max 100 chars. Lets Parallel tailor default settings for your model's capabilities. Pass the exact active model slug; do not shorten to a family alias.

참고

Parallel ranks and compresses results for LLM reasoning utility, not human click-through; expect dense excerpts per result rather than full-page content.
Result excerpts come back as the excerpts array and are also joined into description for compatibility with the generic web_search contract.
Both providers return a session_id; OpenClaw surfaces it as sessionId in the tool payload so callers can group follow-up searches. A Parallel-generated session id (one the caller did not supply) is excluded from the cache entry, since unrelated tasks with identical queries should not inherit it.
searchId, warnings, and usage from Parallel are passed through when present.
OpenClaw always forwards a resolved result count to Parallel as advanced_settings.max_results (parallel) or applies count client-side after Parallel's fixed-size response (parallel-free). The caller's count arg wins, then tools.web.search.maxResults, otherwise OpenClaw's generic web_search default (5) -- Parallel's own API defaults to 10.
Results are cached for 15 minutes by default (cacheTtlMinutes).
parallel-free mints a fresh session_id per call via its MCP handshake when the caller does not supply one; parallel leaves it unset in that case.

검증 체크리스트

해당 tool이 활성 profile/policy에서 허용되는지 확인
sandbox / elevated / host 실행 경로 정책을 이해했는지 확인
채널·에이전트 권한과 충돌하지 않는지 확인
공식 CLI/--help와 문서 옵션이 버전과 맞는지 확인

Parallel search

개요

공식 문서 기반 상세

Install plugin

API key (paid provider)

Create an account

Store the key

Config

Base URL override

Tool parameters

참고

관련 문서

검증 체크리스트

관련

관련 가이드

Parallel search

개요

공식 문서 기반 상세

Install plugin

API key (paid provider)

Create an account

Store the key

Config

Base URL override

Tool parameters

참고

관련 문서

검증 체크리스트

관련

관련 가이드