Skip to main content

​
Kimi Search

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

​
Get an API key

1

Create a key

Get an API key from Moonshot AI.
2

Store the key

Set KIMI_API_KEY or MOONSHOT_API_KEY in the Gateway environment, or configure via:
When you choose Kimi during velaclaw onboard or velaclaw configure --section web, Velaclaw 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

If you use the China API host for chat (models.providers.moonshot.baseUrl: https://api.moonshot.cn/v1), Velaclaw 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 ~/.velaclaw/.env. If you omit baseUrl, Velaclaw defaults to https://api.moonshot.ai/v1. If you omit model, Velaclaw 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.