Tools

Kimi-Suche

Kimi ist ein web_search-Provider, der auf der nativen Websuche von Moonshot basiert. Moonshot synthetisiert eine Antwort mit Inline-Quellenangaben, ähnlich den auf Grounding basierenden Antwort-Providern von Gemini und Grok, statt eine sortierte Ergebnisliste zurückzugeben.

Einrichtung

Schlüssel erstellen

Rufen Sie einen API-Schlüssel von Moonshot AI ab.

Schlüssel speichern

Legen Sie KIMI_API_KEY oder MOONSHOT_API_KEY in der Gateway-Umgebung fest (fügen Sie ihn bei einer Gateway-Installation zu ~/.openclaw/.env hinzu), oder konfigurieren Sie ihn über:

bash

openclaw configure --section web

Wenn Sie während openclaw onboard oder openclaw configure --section web Kimi auswählen, werden Sie außerdem zu Folgendem aufgefordert:

die Moonshot-API-Region: https://api.moonshot.ai/v1 oder https://api.moonshot.cn/v1
das Websuchmodell (standardmäßig kimi-k2.6)

Konfiguration

json5

{  plugins: {    entries: {      moonshot: {        config: {          webSearch: {            apiKey: "sk-...", // optional, wenn KIMI_API_KEY oder MOONSHOT_API_KEY festgelegt ist            baseUrl: "https://api.moonshot.ai/v1",            model: "kimi-k2.6",          },        },      },    },  },  tools: {    web: {      search: {        provider: "kimi",      },    },  },}

tools.web.search.provider wird bei Auslassung automatisch anhand der verfügbaren API-Schlüssel erkannt; legen Sie es explizit auf kimi fest, wenn mehrere Suchzugangsdaten konfiguriert sind.

Konfigurieren Sie Kimi-spezifische Werte für apiKey, baseUrl und model unter plugins.entries.moonshot.config.webSearch.

Standardwerte: baseUrl verwendet bei Auslassung standardmäßig https://api.moonshot.ai/v1, model verwendet standardmäßig kimi-k2.6.

Wenn der Chat-Datenverkehr den China-Host verwendet (models.providers.moonshot.baseUrl: https://api.moonshot.cn/v1), verwendet Kimi web_search diesen Host automatisch ebenfalls, wenn das eigene baseUrl nicht festgelegt ist, damit .cn-Schlüssel nicht versehentlich den internationalen Endpunkt ansprechen (der für diese Schlüssel HTTP 401 zurückgibt). Legen Sie ein explizites Kimi-baseUrl fest, um diese Vererbung außer Kraft zu setzen.

Grounding-Anforderung

OpenClaw gibt ein Kimi-web_search-Ergebnis erst zurück, nachdem die Antwort von Moonshot native Grounding-Nachweise der Websuche enthält, etwa eine Wiedergabe des $web_search-Tool-Aufrufs, search_results oder Quellen-URLs. Wenn Kimi direkt und ohne Grounding antwortet (zum Beispiel „Ich kann nicht im Internet suchen“), gibt OpenClaw stattdessen einen kimi_web_search_ungrounded-Fehler zurück, anstatt diesen Text als Suchergebnis zu behandeln. Versuchen Sie die Abfrage erneut, wechseln Sie zu einem strukturierten Provider wie Brave oder verwenden Sie web_fetch beziehungsweise das Browser-Tool, wenn Sie bereits über eine Ziel-URL verfügen.

Tool-Parameter

Parameter	Unterstützt
`query`	Ja
`count`	Wird zur Provider-übergreifenden Kompatibilität akzeptiert, aber ignoriert: Kimi gibt immer eine synthetisierte Antwort statt einer Liste mit N Ergebnissen zurück
`country`, `language`, `freshness`, `date_after`, `date_before`	Nein