Kimi 검색

Kimi는 Moonshot의 네이티브 웹 검색을 기반으로 하는 web_search 제공자입니다. 순위가 매겨진 결과 목록을 반환하는 대신, Gemini 및 Grok의 근거 기반 응답 제공자와 유사하게 Moonshot이 인라인 인용이 포함된 하나의 답변을 종합합니다.

설정

openclaw configure --section web

openclaw onboard 또는 openclaw configure --section web에서 Kimi를 선택하면 다음 항목도 입력하라는 메시지가 표시됩니다.

• Moonshot API 리전: https://api.moonshot.ai/v1 또는 https://api.moonshot.cn/v1
• 웹 검색 모델(기본값: kimi-k2.6)

구성

{  plugins: {    entries: {      moonshot: {        config: {          webSearch: {            apiKey: "sk-...", // KIMI_API_KEY 또는 MOONSHOT_API_KEY가 설정된 경우 선택 사항            baseUrl: "https://api.moonshot.ai/v1",            model: "kimi-k2.6",          },        },      },    },  },  tools: {    web: {      search: {        provider: "kimi",      },    },  },}

tools.web.search.provider를 생략하면 사용 가능한 API 키를 기반으로 자동 감지됩니다. 여러 검색 자격 증명이 구성된 경우에는 kimi로 명시적으로 설정하세요.

tools.web.search.kimi 아래에 배치하는 동등한 범위 지정 형식(apiKey, baseUrl, model)도 사용할 수 있습니다. 두 형식은 동일한 최종 구성으로 병합됩니다.

기본값: baseUrl을 생략하면 기본값은 https://api.moonshot.ai/v1이며, model의 기본값은 kimi-k2.6입니다.

채팅 트래픽이 중국 호스트(models.providers.moonshot.baseUrl: https://api.moonshot.cn/v1)를 사용하는 경우, Kimi web_search는 자체 baseUrl이 설정되지 않았을 때 해당 호스트를 자동으로 재사용합니다. 따라서 .cn 키가 실수로 국제 엔드포인트에 요청을 보내는 일을 방지합니다. 국제 엔드포인트는 이러한 키에 HTTP 401을 반환합니다. 이 상속을 재정의하려면 Kimi baseUrl을 명시적으로 설정하세요.

근거 요구 사항

OpenClaw는 Moonshot의 응답에 $web_search 도구 호출 재현, search_results 또는 인용 URL과 같은 네이티브 웹 검색 근거가 포함된 경우에만 Kimi web_search 결과를 반환합니다. Kimi가 근거 없이 직접 답변하는 경우(예: "인터넷을 탐색할 수 없습니다") OpenClaw는 해당 텍스트를 검색 결과로 처리하는 대신 kimi_web_search_ungrounded 오류를 반환합니다. 쿼리를 다시 시도하거나, Brave와 같은 구조화된 제공자로 전환하거나, 대상 URL을 이미 알고 있다면 web_fetch 또는 브라우저 도구를 사용하세요.

도구 매개변수

관련 문서

• 웹 검색 개요 - 모든 제공자 및 자동 감지
• Moonshot AI - Moonshot 모델 및 Kimi Coding 제공자 문서
• Gemini 검색 - Google 근거를 통한 AI 종합 답변
• Grok 검색 - xAI 근거를 통한 AI 종합 답변