Zum Hauptinhalt springen
OpenClaw unterstützt Ollama Web Search als gebündelten web_search-Provider. Er verwendet Ollamas Websuche-API und gibt strukturierte Ergebnisse mit Titeln, URLs und Snippets zurück. Für lokales oder selbst gehostetes Ollama benötigt diese Einrichtung standardmäßig keinen API-Schlüssel. Erforderlich sind jedoch:
  • ein Ollama-Host, der von OpenClaw aus erreichbar ist
  • ollama signin
Für direkte gehostete Suche setzen Sie die Basis-URL des Ollama-Providers auf https://ollama.com und geben Sie einen echten OLLAMA_API_KEY an.

Einrichtung

1

Ollama starten

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

Anmelden

Führen Sie aus:
ollama signin
3

Ollama Web Search auswählen

Führen Sie aus:
openclaw configure --section web
Wählen Sie anschließend Ollama Web Search als Provider aus.
Wenn Sie Ollama bereits für Modelle verwenden, nutzt Ollama Web Search denselben konfigurierten Host wieder.

Konfiguration

{
  tools: {
    web: {
      search: {
        provider: "ollama",
      },
    },
  },
}
Optionales Überschreiben des Ollama-Hosts:
{
  plugins: {
    entries: {
      ollama: {
        config: {
          webSearch: {
            baseUrl: "http://ollama-host:11434",
          },
        },
      },
    },
  },
}
Wenn Sie Ollama bereits als Modell-Provider konfigurieren, kann der Websuche-Provider stattdessen diesen Host wiederverwenden:
{
  models: {
    providers: {
      ollama: {
        baseUrl: "http://ollama-host:11434",
      },
    },
  },
}
Der Ollama-Modell-Provider verwendet baseUrl als kanonischen Schlüssel. Der Websuche-Provider berücksichtigt außerdem baseURL unter models.providers.ollama, um mit Konfigurationsbeispielen im Stil des OpenAI SDK kompatibel zu sein. Wenn keine explizite Ollama-Basis-URL festgelegt ist, verwendet OpenClaw http://127.0.0.1:11434. Wenn Ihr Ollama-Host Bearer-Authentifizierung erwartet, verwendet OpenClaw models.providers.ollama.apiKey (oder die passende env-gestützte Provider-Authentifizierung) für Anfragen an diesen konfigurierten Host wieder. Direkte gehostete Ollama Web Search:
{
  models: {
    providers: {
      ollama: {
        baseUrl: "https://ollama.com",
        apiKey: "OLLAMA_API_KEY",
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "ollama",
      },
    },
  },
}

Hinweise

  • Für diesen Provider ist kein eigenes API-Schlüsselfeld für die Websuche erforderlich.
  • Wenn der Ollama-Host durch Authentifizierung geschützt ist, verwendet OpenClaw den normalen Ollama Provider-API-Schlüssel wieder, sofern vorhanden.
  • Wenn baseUrl https://ollama.com ist, ruft OpenClaw https://ollama.com/api/web_search direkt auf und sendet den konfigurierten Ollama API-Schlüssel als Bearer-Authentifizierung.
  • Wenn der konfigurierte Host keine Websuche bereitstellt und OLLAMA_API_KEY gesetzt ist, kann OpenClaw auf https://ollama.com/api/web_search zurückfallen, ohne diesen env-Schlüssel an den lokalen Host zu senden.
  • OpenClaw warnt während der Einrichtung, wenn Ollama nicht erreichbar oder nicht angemeldet ist, blockiert die Auswahl jedoch nicht.
  • OpenClaw wählt Ollama Web Search nicht automatisch aus, wenn kein höher priorisierter Provider mit Zugangsdaten konfiguriert ist; wählen Sie ihn explizit mit tools.web.search.provider: "ollama".
  • Lokale Ollama-Daemon-Hosts verwenden den lokalen Proxy-Endpunkt /api/experimental/web_search, der signiert und an Ollama Cloud weiterleitet.
  • https://ollama.com-Hosts verwenden den öffentlichen gehosteten Endpunkt /api/web_search direkt mit Bearer-Authentifizierung per API-Schlüssel.

Verwandte Themen