Tools

병렬 검색

Parallel Plugin은 AI 에이전트용으로 구축된 웹 인덱스에서 순위가 지정되고 LLM에 최적화된 발췌문을 반환하는 두 가지 Parallel web_search 제공자를 제공합니다.

제공자	id	인증
Parallel 검색(무료)	`parallel-free`	없음 -- Parallel의 무료 Search MCP
Parallel 검색	`parallel`	`PARALLEL_API_KEY` -- 유료 검색 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로 끝나지 않는 한 /v1/search를 추가하는 방식으로 기본 호스트를 정규화합니다. 확인된 엔드포인트는 검색 캐시 키의 일부이므로 서로 다른 엔드포인트의 결과는 절대 공유되지 않습니다.

도구 매개변수

두 제공자 모두 Parallel의 네이티브 검색 형식을 노출하므로 모델이 자연어 목표와 몇 개의 짧은 키워드 쿼리를 입력합니다. 이는 최상의 결과를 위해 Parallel이 권장하는 조합입니다.

objectivestringrequired

기본 질문이나 목표를 설명하는 자연어 문장입니다(최대 5,000자). 자체적으로 완결된 내용이어야 합니다.

search_queriesstring[]required

각각 3~6단어로 구성된 간결한 키워드 검색 쿼리입니다(1~5개 항목, 각각 최대 200자). 최상의 결과를 얻으려면 다양한 쿼리 2~3개를 제공하세요.

countnumber

반환할 결과 수입니다(1~40).

session_idstring

이전 결과의 sessionId에서 가져온 선택적 Parallel 세션 ID입니다. 같은 작업의 후속 검색에서 이를 전달하면 Parallel이 관련 호출을 그룹화하고 이후 결과를 개선합니다. parallel에서는 최대 1,000자이며, 무료 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은 이 경우 설정하지 않은 채로 둡니다.