Auf dieser Seite

Auf dieser Seite

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.baseUrl → models.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?