Tools

Ollama-Websuche

OpenClaw unterstützt Ollama Web Search als gebündelten web_search-Provider, der Titel, URLs und Textausschnitte von Ollamas Websuch-API zurückgibt.

Lokales/selbst gehostetes Ollama benötigt standardmäßig keinen API-Schlüssel; erforderlich sind ein erreichbarer Ollama-Host sowie ollama signin. Die direkte gehostete Suche (ohne lokales Ollama) benötigt baseUrl: "https://ollama.com" und einen echten OLLAMA_API_KEY.

Einrichtung

  • Ollama starten

    Stellen Sie sicher, dass Ollama installiert ist und ausgeführt wird.

  • Anmelden

    bash
    ollama signin
  • Ollama Web Search auswählen

    bash
    openclaw configure --section web

    Wählen Sie Ollama Web Search als Provider aus.

  • Wenn Sie Ollama bereits für Modelle verwenden, nutzt Ollama Web Search denselben konfigurierten Host.

    Konfiguration

    json5
    {  tools: {    web: {      search: {        provider: "ollama",      },    },  },}

    Optionale Host-Überschreibung, die nur für die Websuche gilt:

    json5
    {  plugins: {    entries: {      ollama: {        config: {          webSearch: {            baseUrl: "http://ollama-host:11434",          },        },      },    },  },}

    Alternativ können Sie den bereits für den Ollama-Modell-Provider konfigurierten Host wiederverwenden:

    json5
    {  models: {    providers: {      ollama: {        baseUrl: "http://ollama-host:11434",      },    },  },}

    models.providers.ollama.baseUrl ist der kanonische Schlüssel; der Websuch- Provider akzeptiert dort aus Kompatibilitätsgründen mit Konfigurationsbeispielen im Stil des OpenAI SDK auch baseURL. Wenn nichts festgelegt ist, verwendet OpenClaw standardmäßig http://127.0.0.1:11434.

    Direkte gehostete Ollama Web Search (ohne lokales Ollama):

    json5
    {  models: {    providers: {      ollama: {        baseUrl: "https://ollama.com",        apiKey: "OLLAMA_API_KEY",      },    },  },  tools: {    web: {      search: {        provider: "ollama",      },    },  },}

    Authentifizierung und Anfrage-Routing

    • Es gibt kein Websuch-spezifisches Feld für den API-Schlüssel; der Provider verwendet models.providers.ollama.apiKey (oder die entsprechende umgebungsvariablengestützte Provider-Authentifizierung), wenn der konfigurierte Host durch Authentifizierung geschützt ist.
    • Reihenfolge der Host-Auflösung: plugins.entries.ollama.config.webSearch.baseUrlmodels.providers.ollama.baseUrl (oder baseURL) → http://127.0.0.1:11434.
    • Wenn der aufgelöste Host https://ollama.com ist, ruft OpenClaw https://ollama.com/api/web_search direkt auf und verwendet den API-Schlüssel für die Bearer- Authentifizierung.
    • Andernfalls ruft OpenClaw zunächst den lokalen Proxy-Endpunkt /api/experimental/web_search auf (der die Anfrage signiert und an Ollama Cloud weiterleitet) und greift dann auf /api/web_search auf demselben Host zurück. Wenn beide fehlschlagen und OLLAMA_API_KEY festgelegt ist, wird die Anfrage einmal mit diesem Schlüssel an https://ollama.com/api/web_search wiederholt — ohne ihn an den lokalen Host zu senden.
    • OpenClaw warnt während der Einrichtung, wenn Ollama nicht erreichbar oder nicht angemeldet ist, verhindert jedoch nicht die Auswahl des Providers.

    Verwandte Themen

    Was this useful?
    On this page

    On this page