Kimi 搜索
Kimi 是一个由 Moonshot 原生 web 搜索提供支持的 web_search 提供方。与 Gemini 和 Grok 的基于依据的响应提供方类似,Moonshot 会综合生成一个带有行内引用的答案,而不是返回排序后的结果列表。
设置¶
moonshot 插件不随 OpenClaw 一起提供;请先安装它。
1. 安装插件
安装会自动应用于正在运行的 Gateway;否则将在下次启动时生效。参见 应用更改并检查。
2. 创建密钥
从 Moonshot AI 获取 API 密钥。
3. 存储密钥
在 Gateway 环境中设置 KIMI_API_KEY 或 MOONSHOT_API_KEY(对于 gateway 安装,请将其添加到 ~/.openclaw/.env),或通过以下方式配置:
在 openclaw onboard 或 openclaw configure --section web 期间选择 Kimi 还会提示输入:
- Moonshot API 区域:
https://api.moonshot.ai/v1或https://api.moonshot.cn/v1 - web 搜索模型(默认为
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 web_search 在其自身 baseUrl 未设置时会自动复用该主机地址,这样 .cn 密钥不会意外访问国际端点(该端点会为这些密钥返回 HTTP 401)。设置显式的 Kimi baseUrl 可覆盖此继承行为。
依据要求¶
OpenClaw 仅在 Moonshot 的响应包含原生 web 搜索依据证据(例如 $web_search 工具调用回放、search_results 或引用 URL)后,才会返回 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 Search 概览 - 所有提供方与自动检测
- Moonshot AI - Moonshot 模型 + Kimi Coding 提供方文档
- Gemini Search - 通过 Google 依据生成 AI 综合答案
- Grok Search - 通过 xAI 依据生成 AI 综合答案
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw