快速开始

Kimi 搜索

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

设置

  • 创建密钥

    Moonshot AI 获取 API 密钥。

  • 存储密钥

    在 Gateway 网关环境中设置 KIMI_API_KEYMOONSHOT_API_KEY(对于 Gateway 网关安装,请将其添加到 ~/.openclaw/.env),或通过以下命令配置:

    bash
    openclaw configure --section web
  • openclaw onboardopenclaw configure --section web 期间选择 Kimi 时,还会提示输入:

    • Moonshot API 区域:https://api.moonshot.ai/v1https://api.moonshot.cn/v1
    • 网络搜索模型(默认为 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 密钥自动检测;如果配置了多个搜索凭据,请将其显式设置为 kimi

    tools.web.search.kimi 下的等效作用域形式(apiKeybaseUrlmodel)也可使用;两种形式会合并为同一个解析后的配置。

    默认值:省略 baseUrl 时默认为 https://api.moonshot.ai/v1model 默认为 kimi-k2.6

    如果聊天流量使用中国区主机(models.providers.moonshot.baseUrlhttps://api.moonshot.cn/v1),且 Kimi web_search 未设置自己的 baseUrl,则会自动复用该主机,以免 .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 / 浏览器工具。

    工具参数

    参数 支持情况
    query
    count 为实现跨提供商兼容而接受,但会被忽略:Kimi 始终返回一个综合答案,而不是包含 N 个结果的列表
    country, language, freshness, date_after, date_before

    相关内容

    Was this useful?
    On this page

    On this page