nyrn
/
openclaw
mirror of https://github.com/openclaw/openclaw.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
openclaw/docs/tools/kimi-search.md

2.8 KiB
Raw Blame History

summary read_when title
Kimi web search via Moonshot web search
You want to use Kimi for web_search
You need a KIMI_API_KEY or MOONSHOT_API_KEY
Kimi Search

Kimi Search

OpenClaw supports Kimi as a web_search provider, using Moonshot web search to produce AI-synthesized answers with citations.

Get an API key

Get an API key from [Moonshot AI](https://platform.moonshot.cn/). Set `KIMI_API_KEY` or `MOONSHOT_API_KEY` in the Gateway environment, or configure via: 
```bash
openclaw configure --section web
```

When you choose Kimi during openclaw onboard or openclaw configure --section web, OpenClaw can also ask for:

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

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.5",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "kimi",
      },
    },
  },
}

If you use the China API host for chat (models.providers.moonshot.baseUrl: https://api.moonshot.cn/v1), OpenClaw reuses that same host for Kimi web_search when tools.web.search.kimi.baseUrl is omitted, so keys from platform.moonshot.cn do not hit the international endpoint by mistake (which often returns HTTP 401). Override with tools.web.search.kimi.baseUrl when you need a different search base URL.

Environment alternative: set KIMI_API_KEY or MOONSHOT_API_KEY in the Gateway environment. For a gateway install, put it in ~/.openclaw/.env.

If you omit baseUrl, OpenClaw defaults to https://api.moonshot.ai/v1. If you omit model, OpenClaw defaults to kimi-k2.5.

How it works

Kimi uses Moonshot web search to synthesize answers with inline citations, similar to Gemini and Grok's grounded response approach.

Supported parameters

Kimi search supports query.

count is accepted for shared web_search compatibility, but Kimi still returns one synthesized answer with citations rather than an N-result list.

Provider-specific filters are not currently supported.

Related