# Kimi 搜索

> 通过 Moonshot Web 搜索进行 Kimi Web 搜索

- 网址：https://funcoding.ai/agents/openclaw/tools/kimi-search/
- 来源：OpenClaw 官方文档原文（中文），MIT 许可，同步于 2026-10-11
- 官方原文：https://docs.openclaw.ai/zh-CN/tools/kimi-search

---
Kimi 是由 Moonshot 原生 Web 搜索支持的 `web_search` 提供商。与 Gemini 和 Grok 的
基于依据生成响应的提供商类似，Moonshot 会综合生成一个带内联引用的回答，
而不是返回按相关性排序的结果列表。

## 设置

**创建密钥**

从 [Moonshot AI](https://platform.moonshot.cn/) 获取 API key。

**存储密钥**

在 Gateway 网关环境中设置 `KIMI_API_KEY` 或 `MOONSHOT_API_KEY`（对于
Gateway 网关安装，请将其添加到 `~/.openclaw/.env`），或通过以下命令配置：

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

在 `openclaw onboard` 或 `openclaw configure --section web` 期间选择 **Kimi**
还会提示设置：

- Moonshot API 区域：`https://api.moonshot.ai/v1` 或 `https://api.moonshot.cn/v1`
- Web 搜索模型（默认为 `kimi-k2.6`）

## 配置

```json5
{
  plugins: {
    entries: {
      moonshot: {
        config: {
          webSearch: {
            apiKey: "sk-...", // 如果已设置 KIMI_API_KEY 或 MOONSHOT_API_KEY，则可选
            baseUrl: "https://api.moonshot.ai/v1",
            model: "kimi-k2.6",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "kimi",
      },
    },
  },
}
```

省略 `tools.web.search.provider` 时，系统会根据可用的 API key 自动检测；
如果配置了多个搜索凭据，请将其显式设置为 `kimi`。

在 `plugins.entries.moonshot.config.webSearch` 下配置 Kimi 专用的 `apiKey`、`baseUrl` 和 `model` 值。

默认值：省略 `baseUrl` 时默认为 `https://api.moonshot.ai/v1`，`model`
默认为 `kimi-k2.6`。

如果聊天流量使用中国区主机（`models.providers.moonshot.baseUrl`：
`https://api.moonshot.cn/v1`），当 Kimi 自身的 `baseUrl` 未设置时，
其 `web_search` 会自动复用该主机，以免 `.cn` 密钥意外请求
国际端点（这些密钥请求该端点时会返回 HTTP 401）。设置显式的
Kimi `baseUrl` 可覆盖此继承行为。

## 依据要求

只有在 Moonshot 的响应包含原生 Web 搜索依据证据（例如 `$web_search` 工具调用
重放、`search_results` 或引用 URL）后，OpenClaw 才会返回 Kimi
`web_search` 结果。如果 Kimi 在没有依据的情况下直接回答
（例如“我无法浏览互联网”），OpenClaw 会返回 `kimi_web_search_ungrounded` 错误，
而不会将该文本视为搜索结果。请重试查询、切换到 Brave 等结构化提供商，
或者在已有目标 URL 时使用 `web_fetch` / 浏览器工具。

## 工具参数

| 参数                                                            | 支持情况                                                                                                  |
| --------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| `query`                                              | 是                                                                                                       |
| `count`                                              | 为实现跨提供商兼容而接受，但会忽略：Kimi 始终返回一个综合生成的回答，而不是包含 N 个结果的列表 |
| `country`、`language`、`freshness`、`date_after`、`date_before` | 否                                                                                                       |

## 相关内容

- [Web 搜索概览](https://funcoding.ai/agents/openclaw/tools/web/) - 所有提供商和自动检测
- [Moonshot AI](https://funcoding.ai/agents/openclaw/providers/moonshot/) - Moonshot 模型和 Kimi Coding 提供商文档
- [Gemini 搜索](https://funcoding.ai/agents/openclaw/tools/gemini-search/) - 通过 Google 依据综合生成的 AI 回答
- [Grok 搜索](https://funcoding.ai/agents/openclaw/tools/grok-search/) - 通过 xAI 依据综合生成的 AI 回答