OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Tools

Ricerca parallela

Il Plugin Parallel fornisce due provider web_search di Parallel, entrambi restituiscono estratti classificati e ottimizzati per gli LLM da un indice web creato per gli agenti IA:

Provider id Autenticazione
Ricerca Parallel (gratuita) parallel-free Nessuna — Search MCP gratuito di Parallel
Ricerca Parallel parallel PARALLEL_API_KEY — API Search a pagamento, limiti di frequenza superiori e ottimizzazione obiettivi

Imposta tools.web.search.provider su parallel-free o parallel per selezionarne esplicitamente uno; nessuno dei due viene rilevato automaticamente.

Installare il Plugin

bash
openclaw plugins install @openclaw/parallel-pluginopenclaw gateway restart

Chiave API (provider a pagamento)

parallel-free non richiede una chiave, ma deve comunque essere selezionato esplicitamente. Il provider parallel a pagamento richiede una chiave API:

  • Creare un account

    Registrati su platform.parallel.ai e genera una chiave API dalla tua dashboard.

  • Archiviare la chiave

    Imposta PARALLEL_API_KEY nell'ambiente del Gateway oppure esegui la configurazione tramite:

    bash
    openclaw configure --section web

    • Configurazione

    json5
    {  plugins: {    entries: {      parallel: {        config: {          webSearch: {            apiKey: "par-...", // facoltativo se PARALLEL_API_KEY è impostata            baseUrl: "https://api.parallel.ai", // facoltativo; OpenClaw aggiunge /v1/search          },        },      },    },  },  tools: {    web: {      search: {        // "parallel-free" per il Search MCP gratuito oppure "parallel" per il        // provider a pagamento basato su API mostrato qui.        provider: "parallel",      },    },  },}

    Alternativa tramite variabile d'ambiente: imposta PARALLEL_API_KEY nell'ambiente del Gateway. Per un'installazione del Gateway, inseriscila in ~/.openclaw/.env.

    Sostituzione dell'URL di base

    Si applica solo al provider parallel a pagamento; parallel-free utilizza sempre https://search.parallel.ai/mcp e ignora questa impostazione.

    Imposta plugins.entries.parallel.config.webSearch.baseUrl per instradare le richieste a pagamento tramite un proxy compatibile o un endpoint alternativo, ad esempio Cloudflare AI Gateway. OpenClaw normalizza gli host senza schema anteponendo https:// e aggiunge /v1/search, a meno che il percorso non termini già così. L'endpoint risolto fa parte della chiave della cache di ricerca, quindi i risultati provenienti da endpoint diversi non vengono mai condivisi.

    Parametri dello strumento

    Entrambi i provider espongono il formato di ricerca nativo di Parallel, affinché il modello specifichi un obiettivo in linguaggio naturale insieme ad alcune brevi query con parole chiave: la combinazione che Parallel consiglia per ottenere risultati ottimali.

    objectivestringrequired

    Descrizione in linguaggio naturale della domanda o dell'obiettivo sottostante (massimo 5000 caratteri). Deve essere autosufficiente.

    search_queriesstring[]required

    Query di ricerca concise basate su parole chiave, ciascuna di 3-6 parole (1-5 voci, massimo 200 caratteri ciascuna). Fornisci 2-3 query diverse per ottenere risultati ottimali.

    countnumber

    Numero di risultati da restituire (1-40).

    session_idstring

    ID di sessione Parallel facoltativo ricavato dal sessionId di un risultato precedente. Passalo alle ricerche successive della stessa attività, affinché Parallel raggruppi le chiamate correlate e migliori i risultati successivi. Massimo 1000 caratteri per parallel; il Search MCP gratuito parallel-free impone un limite di 100. Un ID oltre il limite viene scartato nella versione a pagamento oppure ne viene generato uno nuovo nella versione gratuita.

    client_modelstring

    Identificatore facoltativo del modello che effettua la chiamata, ad esempio claude-opus-4-7 o gpt-5.6-sol, con un massimo di 100 caratteri. Consente a Parallel di adattare le impostazioni predefinite alle capacità del modello. Passa lo slug esatto del modello attivo; non abbreviarlo con un alias della famiglia.

    Note

    • Parallel classifica e comprime i risultati in funzione della loro utilità per il ragionamento degli LLM, non per il clic degli utenti; aspettati quindi estratti densi per ciascun risultato anziché il contenuto completo delle pagine.
    • Gli estratti dei risultati vengono restituiti nell'array excerpts e sono inoltre concatenati in description per garantire la compatibilità con il contratto generico web_search.
    • Entrambi i provider restituiscono un session_id; OpenClaw lo espone come sessionId nel payload dello strumento, affinché i chiamanti possano raggruppare le ricerche successive. Un ID di sessione generato da Parallel, ovvero non fornito dal chiamante, viene escluso dalla voce della cache, poiché attività non correlate con query identiche non devono ereditarlo.
    • searchId, warnings e usage di Parallel vengono mantenuti quando presenti.
    • OpenClaw inoltra sempre a Parallel un numero di risultati risolto come advanced_settings.max_results (parallel) oppure applica count lato client dopo la risposta di dimensione fissa di Parallel (parallel-free). Ha precedenza l'argomento count del chiamante, seguito da tools.web.search.maxResults; altrimenti viene usato il valore predefinito generico di web_search di OpenClaw (5), mentre il valore predefinito dell'API di Parallel è 10.
    • Per impostazione predefinita, i risultati vengono memorizzati nella cache per 15 minuti (cacheTtlMinutes).
    • parallel-free genera un nuovo session_id per ogni chiamata tramite il proprio handshake MCP quando il chiamante non ne fornisce uno; in tal caso, parallel lo lascia non impostato.

    Contenuti correlati

    Was this useful?
    On this page

    On this page