Kimi 검색

OpenClaw는 Moonshot 웹 검색을 사용해 인용이 포함된 AI 합성 답변을 생성하는 web_search 제공자로 Kimi를 지원합니다.

# API 키 받기

openclaw configure --section web

openclaw onboard 또는 openclaw configure --section web 중에 Kimi를 선택하면 OpenClaw가 다음 항목도 요청할 수 있습니다.

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

# 구성

{
  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",
      },
    },
  },
}

채팅에 중국 API 호스트(models.providers.moonshot.baseUrl: https://api.moonshot.cn/v1)를 사용하는 경우, tools.web.search.kimi.baseUrl이 생략되면 OpenClaw는 Kimi web_search에도 동일한 호스트를 재사용하므로 platform.moonshot.cn의 키가 실수로 국제 엔드포인트에 도달하지 않습니다(이 경우 HTTP 401이 자주 반환됨). 다른 검색 기본 URL이 필요할 때는 tools.web.search.kimi.baseUrl로 재정의하세요.

환경 대안: Gateway 환경에서 KIMI_API_KEY 또는 MOONSHOT_API_KEY를 설정합니다. Gateway 설치의 경우 ~/.openclaw/.env에 넣습니다.

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

# 작동 방식

Kimi는 Gemini 및 Grok의 그라운딩된 응답 접근 방식과 유사하게, Moonshot 웹 검색을 사용해 인라인 인용이 포함된 답변을 합성합니다.

OpenClaw는 재생 가능한 $web_search 도구 페이로드, search_results 또는 인용 URL 같은 네이티브 웹 검색 그라운딩 증거가 Moonshot에서 반환된 후에만 Kimi web_search를 성공으로 처리합니다. Kimi가 그라운딩 증거 없이 "I cannot browse the internet" 같은 일반 채팅 답변으로 즉시 중단되면, OpenClaw는 해당 텍스트를 검색 결과로 감싸는 대신 구조화된 kimi_web_search_ungrounded 오류를 반환합니다. 쿼리를 다시 시도하거나, Brave 같은 구조화된 제공자로 전환하거나, 대상 URL이 이미 있는 경우 web_fetch / 브라우저 도구를 사용하세요.

# 지원되는 매개변수

Kimi 검색은 query를 지원합니다.

count는 공유 web_search 호환성을 위해 허용되지만, Kimi는 여전히 N개 결과 목록이 아니라 인용이 포함된 하나의 합성 답변을 반환합니다.

제공자별 필터는 현재 지원되지 않습니다.

# 관련 항목

• 웹 검색 개요 -- 모든 제공자 및 자동 감지
• Moonshot AI -- Moonshot 모델 + Kimi Coding 제공자 문서
• Gemini 검색 -- Google 그라운딩을 통한 AI 합성 답변
• Grok 검색 -- xAI 그라운딩을 통한 AI 합성 답변