Ollama web search

기준일: 2026-07-26
난이도: 중급
공식 기준: Ollama web search

개요

이 페이지는 OpenClaw Ollama web search 도구(파라미터, 권한, 설정, CLI)를 공식 문서 기준으로 정리합니다.

공식 요약: Ollama Web Search via a local Ollama host or the hosted Ollama API

도구 가시성은 profile / allow·deny policy / sandbox / channel 권한에 따라 달라집니다. 최신 스키마는 항상 공식 문서를 우선합니다.

공식 문서 기반 상세

아래는 공식 tools/ollama-search 문서를 정리한 내용입니다. 코드 블록, 파라미터 이름, 기본값은 원문 그대로입니다.

OpenClaw supports Ollama Web Search as a bundled web_search provider, returning titles, URLs, and snippets from Ollama's web-search API.

Local/self-hosted Ollama needs no API key by default; it requires a reachable Ollama host plus ollama signin. Direct hosted search (no local Ollama) needs baseUrl: "https://ollama.com" and a real OLLAMA_API_KEY.

설정

Start Ollama

Make sure Ollama is installed and running.

Sign in

```bash
ollama signin
```

Choose Ollama Web Search

```bash
openclaw configure --section web
```

Select **Ollama Web Search** as the provider.

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

OpenClaw never auto-selects Ollama Web Search over a higher-priority credentialed provider; you must choose it explicitly with tools.web.search.provider: "ollama".

Config

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

Optional host override, scoped to web search only:

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

Or reuse the host already configured for the Ollama model provider:

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

models.providers.ollama.baseUrl is the canonical key; the web-search provider also accepts baseURL there for compatibility with OpenAI SDK-style config examples. If nothing is set, OpenClaw defaults to http://127.0.0.1:11434.

Direct hosted Ollama Web Search (no local Ollama):

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

Auth and request routing

• No web-search-specific API key field exists; the provider reuses models.providers.ollama.apiKey (or the matching env-backed provider auth) when the configured host is auth-protected.
• Host resolution order: plugins.entries.ollama.config.webSearch.baseUrl → models.providers.ollama.baseUrl (or baseURL) → http://127.0.0.1:11434.
• If the resolved host is https://ollama.com, OpenClaw calls https://ollama.com/api/web_search directly with the API key as bearer auth.
• Otherwise OpenClaw calls the local proxy endpoint /api/experimental/web_search first (which signs and forwards to Ollama Cloud), then falls back to /api/web_search on the same host. If both fail and OLLAMA_API_KEY is set, it retries once against https://ollama.com/api/web_search with that key — without sending it to the local host.
• OpenClaw warns during setup if Ollama is unreachable or not signed in, but does not block selecting the provider.

관련 문서

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

검증 체크리스트

• 해당 tool이 활성 profile/policy에서 허용되는지 확인
• sandbox / elevated / host 실행 경로 정책을 이해했는지 확인
• 채널·에이전트 권한과 충돌하지 않는지 확인
• 공식 CLI/--help와 문서 옵션이 버전과 맞는지 확인

관련

• Tools 목록 인덱스
• 공식: Tools overview, Tools and custom providers