> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Kimi 검색

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

## API 키 받기

<Steps>
  <Step title="키 만들기">
    [Moonshot AI](https://platform.moonshot.cn/)에서 API 키를 받습니다.
  </Step>

  <Step title="키 저장하기">
    Gateway 환경에서 `KIMI_API_KEY` 또는 `MOONSHOT_API_KEY`를 설정하거나, 다음으로 구성합니다.

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw configure --section web
    ```
  </Step>
</Steps>

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

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

## 구성

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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](https://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개 결과 목록이 아니라 인용이 포함된 하나의 합성 답변을 반환합니다.

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

## 관련 항목

* [웹 검색 개요](/ko/tools/web) -- 모든 제공자 및 자동 감지
* [Moonshot AI](/ko/providers/moonshot) -- Moonshot 모델 + Kimi Coding 제공자 문서
* [Gemini 검색](/ko/tools/gemini-search) -- Google 그라운딩을 통한 AI 합성 답변
* [Grok 검색](/ko/tools/grok-search) -- xAI 그라운딩을 통한 AI 합성 답변