Ollama web search

OpenClaw supports Ollama Web Search as a bundled

For local or self-hosted Ollama, this setup does not need an API key by default. It does require:

• an Ollama host that is reachable from OpenClaw
• text

  Copy

  ollama signin

For direct hosted search, set the Ollama provider base URL to

Setup

text
Copy
```bash}
ollama signin
```

text
Copy
```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

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

Optional Ollama host override:

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

If you already configure Ollama as a model provider, the web-search provider can reuse that host instead:

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

The Ollama model provider uses

If no explicit Ollama base URL is set, OpenClaw uses

If your Ollama host expects bearer auth, OpenClaw reuses

Direct hosted Ollama Web Search:

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

Notes

• No web-search-specific API key field is required for this provider.
• If the Ollama host is auth-protected, OpenClaw reuses the normal Ollama provider API key when present.
• If
  text

  Copy

  baseUrl
  is
  text

  Copy

  https://ollama.com
  , OpenClaw calls
  text

  Copy

  https://ollama.com/api/web_search
  directly and sends the configured Ollama API key as bearer auth.
• If the configured host does not expose web search and
  text

  Copy

  OLLAMA_API_KEY
  is set, OpenClaw can fall back to
  text

  Copy

  https://ollama.com/api/web_search
  without sending that env key to the local host.
• 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.
• Local Ollama daemon hosts use the local proxy endpoint
  text

  Copy

  /api/experimental/web_search
  , which signs and forwards to Ollama Cloud.
• text

  Copy

  https://ollama.com
  hosts use the public hosted endpoint
  text

  Copy

  /api/web_search
  directly with bearer API-key auth.

Related

• Web Search overview -- all providers and auto-detection
• Ollama -- Ollama model setup and cloud/local modes