Ollama 웹 검색

OpenClaw는 번들 web_search 제공자로 Ollama Web Search를 지원합니다. 이 제공자는 Ollama의 웹 검색 API를 사용하며 제목, URL, 스니펫이 포함된 구조화된 결과를 반환합니다. 로컬 또는 자체 호스팅 Ollama의 경우, 이 설정은 기본적으로 API 키가 필요하지 않습니다. 다만 다음이 필요합니다.

OpenClaw에서 연결할 수 있는 Ollama 호스트
ollama signin

직접 호스팅 검색을 사용하려면 Ollama 제공자 기본 URL을 https://ollama.com으로 설정하고 실제 OLLAMA_API_KEY를 제공하세요.

설정

Ollama 시작

Ollama가 설치되어 실행 중인지 확인하세요.

로그인

실행:

ollama signin

Ollama Web Search 선택

실행:

openclaw configure --section web

그런 다음 제공자로 Ollama Web Search를 선택하세요.

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

구성

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

선택적 Ollama 호스트 재정의:

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

Ollama를 모델 제공자로 이미 구성한 경우, 웹 검색 제공자는 대신 해당 호스트를 재사용할 수 있습니다.

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

Ollama 모델 제공자는 baseUrl을 표준 키로 사용합니다. 웹 검색 제공자는 OpenAI SDK 스타일 구성 예제와의 호환성을 위해 models.providers.ollama의 baseURL도 지원합니다. 명시적인 Ollama 기본 URL이 설정되지 않은 경우 OpenClaw는 http://127.0.0.1:11434를 사용합니다. Ollama 호스트에 bearer 인증이 필요한 경우, OpenClaw는 해당 구성된 호스트로 보내는 요청에 models.providers.ollama.apiKey(또는 일치하는 환경 변수 기반 제공자 인증)를 재사용합니다. 직접 호스팅 Ollama Web Search:

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

참고

이 제공자에는 웹 검색 전용 API 키 필드가 필요하지 않습니다.
Ollama 호스트가 인증으로 보호되는 경우, OpenClaw는 일반 Ollama 제공자 API 키가 있으면 이를 재사용합니다.
baseUrl이 https://ollama.com이면 OpenClaw는 https://ollama.com/api/web_search를 직접 호출하고 구성된 Ollama API 키를 bearer 인증으로 보냅니다.
구성된 호스트가 웹 검색을 노출하지 않고 OLLAMA_API_KEY가 설정되어 있으면, OpenClaw는 해당 환경 변수 키를 로컬 호스트로 보내지 않고 https://ollama.com/api/web_search로 대체할 수 있습니다.
OpenClaw는 설정 중 Ollama에 연결할 수 없거나 로그인되어 있지 않으면 경고하지만, 선택을 차단하지는 않습니다.
런타임 자동 감지는 더 높은 우선순위의 자격 증명 제공자가 구성되어 있지 않을 때 Ollama Web Search로 대체할 수 있습니다.
로컬 Ollama 데몬 호스트는 로컬 프록시 엔드포인트 /api/experimental/web_search를 사용하며, 이 엔드포인트는 서명한 뒤 Ollama Cloud로 전달합니다.
https://ollama.com 호스트는 bearer API 키 인증으로 공개 호스팅 엔드포인트 /api/web_search를 직접 사용합니다.

Overview

Plugins

Bundled plugin guides

Building plugins

Skills

Automation

Tools

Agent coordination