Kimi search

기준일: 2026-07-26
난이도: 중급
공식 기준: Kimi search

개요

이 페이지는 OpenClaw Kimi search 도구(파라미터, 권한, 설정, CLI)를 공식 문서 기준으로 정리합니다.

공식 요약: Kimi web search via Moonshot web search

도구 가시성은 profile / allow·deny policy / sandbox / channel 권한에 따라 달라집니다. 최신 스키마는 항상 공식 문서를 우선합니다.

공식 문서 기반 상세

아래는 공식 tools/kimi-search 문서를 정리한 내용입니다. 코드 블록, 파라미터 이름, 기본값은 원문 그대로입니다.

Kimi is a web_search provider backed by Moonshot's native web search. Moonshot synthesizes one answer with inline citations, similar to Gemini and Grok's grounded-response providers, rather than returning a ranked result list.

설정

Create a key

Get an API key from [Moonshot AI](https://platform.moonshot.cn/).

Store the key

Set `KIMI_API_KEY` or `MOONSHOT_API_KEY` in the Gateway environment (for a
gateway install, add it to `~/.openclaw/.env`), or configure via:

```bash
openclaw configure --section web
```

Choosing Kimi during openclaw onboard or openclaw configure --section web also prompts for:

• the Moonshot API region: https://api.moonshot.ai/v1 or https://api.moonshot.cn/v1
• the web-search model (defaults to kimi-k2.6)

Config

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

tools.web.search.provider is auto-detected from available API keys when omitted; set it to kimi explicitly if multiple search credentials are configured.

Configure Kimi-specific apiKey, baseUrl, and model values under plugins.entries.moonshot.config.webSearch.

Defaults: baseUrl defaults to https://api.moonshot.ai/v1 when omitted, model defaults to kimi-k2.6.

If chat traffic uses the China host (models.providers.moonshot.baseUrl: https://api.moonshot.cn/v1), Kimi web_search reuses that host automatically when its own baseUrl is unset, so .cn keys do not accidentally hit the international endpoint (which returns HTTP 401 for those keys). Set an explicit Kimi baseUrl to override this inheritance.

Grounding requirement

OpenClaw only returns a Kimi web_search result after Moonshot's response includes native web-search grounding evidence, such as a $web_search tool-call replay, search_results, or citation URLs. If Kimi answers directly with no grounding (for example "I cannot browse the internet"), OpenClaw returns a kimi_web_search_ungrounded error instead of treating that text as a search result. Retry the query, switch to a structured provider such as Brave, or use web_fetch / the browser tool when you already have a target URL.

Tool parameters

Parameter	Supported
query	Yes
count	Accepted for cross-provider compatibility, but ignored: Kimi always returns one synthesized answer, not an N-result list
country, language, freshness, date_after, date_before	No

관련 문서

• Web Search overview - all providers and auto-detection
• Moonshot AI - Moonshot model + Kimi Coding provider docs
• Gemini Search - AI-synthesized answers via Google grounding
• Grok Search - AI-synthesized answers via xAI grounding

검증 체크리스트

• 해당 tool이 활성 profile/policy에서 허용되는지 확인
• sandbox / elevated / host 실행 경로 정책을 이해했는지 확인
• 채널·에이전트 권한과 충돌하지 않는지 확인
• 공식 CLI/--help와 문서 옵션이 버전과 맞는지 확인

관련

• Tools 목록 인덱스
• 공식: Tools overview, Tools and custom providers