Ricerca Kimi

OpenClaw supporta Kimi come provider web_search, usando la ricerca web di Moonshot per produrre risposte sintetizzate dall'AI con citazioni.

# Ottieni una chiave API

openclaw configure --section web

Quando scegli Kimi durante openclaw onboard o openclaw configure --section web, OpenClaw può anche chiedere:

• la regione API di Moonshot:
  • https://api.moonshot.ai/v1
  • https://api.moonshot.cn/v1
• il modello predefinito di ricerca web Kimi (predefinito: kimi-k2.6)

# Configurazione

{
  plugins: {
    entries: {
      moonshot: {
        config: {
          webSearch: {
            apiKey: "sk-...", // optional if KIMI_API_KEY or MOONSHOT_API_KEY is set
            baseUrl: "https://api.moonshot.ai/v1",
            model: "kimi-k2.6",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "kimi",
      },
    },
  },
}

Se usi l'host API cinese per la chat (models.providers.moonshot.baseUrl: https://api.moonshot.cn/v1), OpenClaw riutilizza lo stesso host per Kimi web_search quando tools.web.search.kimi.baseUrl viene omesso, quindi le chiavi da platform.moonshot.cn non raggiungono per errore l'endpoint internazionale (che spesso restituisce HTTP 401). Esegui l'override con tools.web.search.kimi.baseUrl quando hai bisogno di un URL di base di ricerca diverso.

Alternativa con variabile d'ambiente: imposta KIMI_API_KEY o MOONSHOT_API_KEY nell'ambiente Gateway. Per un'installazione Gateway, inseriscila in ~/.openclaw/.env.

Se ometti baseUrl, OpenClaw usa come valore predefinito https://api.moonshot.ai/v1. Se ometti model, OpenClaw usa come valore predefinito kimi-k2.6.

# Come funziona

Kimi usa la ricerca web di Moonshot per sintetizzare risposte con citazioni inline, in modo simile all'approccio di risposta ancorata di Gemini e Grok.

OpenClaw considera Kimi web_search riuscito solo dopo che Moonshot restituisce prove native di grounding della ricerca web, come un payload dello strumento $web_search rieseguibile, search_results o URL di citazione. Se Kimi si interrompe immediatamente con una semplice risposta di chat come "Non posso navigare in internet" e senza prove di grounding, OpenClaw restituisce invece un errore strutturato kimi_web_search_ungrounded, anziché racchiudere quel testo come risultato di ricerca. Riprova la query, passa a un provider strutturato come Brave oppure usa web_fetch / lo strumento browser quando hai già un URL di destinazione.

# Parametri supportati

La ricerca Kimi supporta query.

count è accettato per la compatibilità condivisa di web_search, ma Kimi restituisce comunque una sola risposta sintetizzata con citazioni invece di un elenco di N risultati.

I filtri specifici del provider non sono attualmente supportati.

# Correlati

• Panoramica di Web Search -- tutti i provider e il rilevamento automatico
• Moonshot AI -- documentazione del provider di modelli Moonshot + Kimi Coding
• Ricerca Gemini -- risposte sintetizzate dall'AI tramite grounding Google
• Ricerca Grok -- risposte sintetizzate dall'AI tramite grounding xAI