Kimi 搜索

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

设置¶

moonshot 插件不随 OpenClaw 附带提供；请先安装它。

1. 安装插件

openclaw plugins install @openclaw/moonshot-provider

安装会自动应用到正在运行的 Gateway；否则将在下次启动时生效。参见 应用更改并检查。

2. 创建密钥

从 Moonshot AI 获取 API 密钥。

3. 存储密钥

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

openclaw configure --section web

在 openclaw onboard 或 openclaw configure --section web 期间选择 Kimi 时，还会提示输入：

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

配置¶

{
  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 时，系统会根据可用的 API 密钥自动检测；如果配置了多个搜索凭据，请显式将其设置为 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 未设置时，Kimi web_search 会自动复用该主机，因此 .cn 密钥不会意外访问国际端点（该端点会对这些密钥返回 HTTP 401）。设置显式的 Kimi baseUrl 可覆盖此继承行为。

依据要求¶

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

工具参数¶

相关¶

• 网络搜索概览 - 所有提供商和自动检测
• Moonshot AI - Moonshot 模型 + Kimi Coding 提供商文档
• Gemini Search - 通过 Google 依据生成的 AI 综合答案
• Grok Search - 通过 xAI 依据生成的 AI 综合答案