Tools

Pesquisa Kimi

Kimi é um provedor de web_search baseado na pesquisa nativa na web da Moonshot. A Moonshot sintetiza uma única resposta com citações em linha, de forma semelhante aos provedores de respostas fundamentadas do Gemini e do Grok, em vez de retornar uma lista de resultados classificados.

Configuração

  • Criar uma chave

    Obtenha uma chave de API na Moonshot AI.

  • Armazenar a chave

    Defina KIMI_API_KEY ou MOONSHOT_API_KEY no ambiente do Gateway (para uma instalação do Gateway, adicione-a a ~/.openclaw/.env) ou configure por meio de:

    bash
    openclaw configure --section web
  • Escolher Kimi durante openclaw onboard ou openclaw configure --section web também solicita:

    • a região da API da Moonshot: https://api.moonshot.ai/v1 ou https://api.moonshot.cn/v1
    • o modelo de pesquisa na web (o padrão é kimi-k2.6)

    Configuração

    json5
    {  plugins: {    entries: {      moonshot: {        config: {          webSearch: {            apiKey: "sk-...", // opcional se KIMI_API_KEY ou MOONSHOT_API_KEY estiver definida            baseUrl: "https://api.moonshot.ai/v1",            model: "kimi-k2.6",          },        },      },    },  },  tools: {    web: {      search: {        provider: "kimi",      },    },  },}

    tools.web.search.provider é detectado automaticamente com base nas chaves de API disponíveis quando omitido; defina-o explicitamente como kimi se houver várias credenciais de pesquisa configuradas.

    A forma equivalente com escopo em tools.web.search.kimi (apiKey, baseUrl, model) também funciona; ambas as estruturas são mescladas na mesma configuração resolvida.

    Padrões: quando omitido, baseUrl usa https://api.moonshot.ai/v1 por padrão e model usa kimi-k2.6 por padrão.

    Se o tráfego de chat usar o host da China (models.providers.moonshot.baseUrl: https://api.moonshot.cn/v1), o web_search do Kimi reutilizará esse host automaticamente quando seu próprio baseUrl não estiver definido, para que chaves .cn não acessem acidentalmente o endpoint internacional (que retorna HTTP 401 para essas chaves). Defina um baseUrl explícito para o Kimi a fim de substituir essa herança.

    Requisito de fundamentação

    O OpenClaw só retorna um resultado de web_search do Kimi depois que a resposta da Moonshot inclui evidências nativas de fundamentação em pesquisa na web, como a reprodução de uma chamada à ferramenta $web_search, search_results ou URLs de citações. Se o Kimi responder diretamente sem fundamentação (por exemplo, "Não consigo navegar na internet"), o OpenClaw retornará um erro kimi_web_search_ungrounded em vez de tratar esse texto como resultado de pesquisa. Tente a consulta novamente, mude para um provedor estruturado, como o Brave, ou use web_fetch / a ferramenta de navegador quando você já tiver uma URL de destino.

    Parâmetros da ferramenta

    Parâmetro Compatível
    query Sim
    count Aceito para compatibilidade entre provedores, mas ignorado: o Kimi sempre retorna uma resposta sintetizada, não uma lista com N resultados
    country, language, freshness, date_after, date_before Não

    Relacionados

    Was this useful?
    On this page

    On this page