Ollama 웹 검색

OpenClaw는 번들 web_search 제공자로 Ollama Web Search를 지원하며, Ollama의 웹 검색 API에서 제목, URL 및 요약문을 반환합니다.

로컬/자체 호스팅 Ollama는 기본적으로 API 키가 필요하지 않지만, 연결 가능한 Ollama 호스트와 ollama signin이 필요합니다. 로컬 Ollama 없이 호스팅 검색을 직접 사용하려면 baseUrl: "https://ollama.com"과 실제 OLLAMA_API_KEY가 필요합니다.

설정

ollama signin

openclaw configure --section web

이미 모델에 Ollama를 사용하고 있다면 Ollama Web Search는 동일하게 구성된 호스트를 재사용합니다.

구성

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

웹 검색에만 적용되는 선택적 호스트 재정의:

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

또는 Ollama 모델 제공자에 이미 구성된 호스트를 재사용합니다.

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

models.providers.ollama.baseUrl이 표준 키입니다. 웹 검색 제공자는 OpenAI SDK 방식의 구성 예시와의 호환성을 위해 해당 위치에서 baseURL도 허용합니다. 아무것도 설정하지 않으면 OpenClaw는 http://127.0.0.1:11434를 기본값으로 사용합니다.

호스팅된 Ollama Web Search 직접 사용(로컬 Ollama 없음):

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

인증 및 요청 라우팅

• 웹 검색 전용 API 키 필드는 없습니다. 구성된 호스트가 인증으로 보호되는 경우 제공자는 models.providers.ollama.apiKey(또는 일치하는 환경 변수 기반 제공자 인증)를 재사용합니다.
• 호스트 확인 순서: plugins.entries.ollama.config.webSearch.baseUrl → models.providers.ollama.baseUrl(또는 baseURL) → http://127.0.0.1:11434.
• 확인된 호스트가 https://ollama.com이면 OpenClaw는 API 키를 Bearer 인증으로 사용하여 https://ollama.com/api/web_search를 직접 호출합니다.
• 그렇지 않으면 OpenClaw는 먼저 로컬 프록시 엔드포인트 /api/experimental/web_search를 호출합니다. 이 엔드포인트는 요청에 서명한 후 Ollama Cloud로 전달하며, 실패하면 동일한 호스트의 /api/web_search로 대체합니다. 둘 다 실패하고 OLLAMA_API_KEY가 설정되어 있으면 해당 키로 https://ollama.com/api/web_search에 한 번 다시 시도하며, 키를 로컬 호스트에는 전송하지 않습니다.
• 설정 중 Ollama에 연결할 수 없거나 로그인되어 있지 않으면 OpenClaw가 경고하지만, 제공자 선택을 차단하지는 않습니다.

관련 문서

• 웹 검색 개요 -- 모든 제공자 및 자동 감지
• Ollama -- Ollama 모델 설정 및 클라우드/로컬 모드