Files
openclaw/docs/tools/ollama-search.md
Bruce MacDonald 5ec53fff0c feat(ollama): add bundled web search provider (#59318)
Merged via squash.

Prepared head SHA: 1ec105f356
Co-authored-by: BruceMacD <5853428+BruceMacD@users.noreply.github.com>
Co-authored-by: BruceMacD <5853428+BruceMacD@users.noreply.github.com>
Reviewed-by: @BruceMacD
2026-04-03 13:41:24 -07:00

1.9 KiB

summary, read_when, title
summary read_when title
Ollama Web Search via your configured Ollama host
You want to use Ollama for web_search
You want a key-free web_search provider
You need Ollama Web Search setup guidance
Ollama Web Search

Ollama Web Search

OpenClaw supports Ollama Web Search as a bundled web_search provider. It uses Ollama's experimental web-search API and returns structured results with titles, URLs, and snippets.

Unlike the Ollama model provider, this setup does not need an API key. It does require:

  • an Ollama host that is reachable from OpenClaw
  • ollama signin

Setup

Make sure Ollama is installed and running. Run:
```bash
ollama signin
```
Run:
```bash
openclaw configure --section web
```

Then select **Ollama Web Search** as the provider.

If you already use Ollama for models, Ollama Web Search reuses the same configured host.

Config

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

Optional Ollama host override:

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

If no explicit Ollama base URL is set, OpenClaw uses http://127.0.0.1:11434.

Notes

  • No API key field is required for this provider.
  • OpenClaw warns during setup if Ollama is unreachable or not signed in, but it does not block selection.
  • Runtime auto-detect can fall back to Ollama Web Search when no higher-priority credentialed provider is configured.
  • The provider uses Ollama's experimental /api/experimental/web_search endpoint.