Перейти к основному содержанию
OpenClaw поддерживает Ollama Web Search как встроенный провайдер web_search. Он использует API веб-поиска Ollama и возвращает структурированные результаты с заголовками, URL и фрагментами. Для локальной или самостоятельно размещенной Ollama эта настройка по умолчанию не требует API-ключа. Для нее требуется:
  • хост Ollama, доступный из OpenClaw
  • ollama signin
Для прямого размещенного поиска задайте базовый URL провайдера Ollama как https://ollama.com и укажите настоящий OLLAMA_API_KEY.

Настройка

1

Запустите Ollama

Убедитесь, что Ollama установлена и запущена.
2

Войдите

Выполните:
ollama signin
3

Выберите 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 как канонический ключ. Провайдер веб-поиска также учитывает baseURL в models.providers.ollama для совместимости с примерами конфигурации в стиле OpenAI SDK. Если явный базовый URL Ollama не задан, OpenClaw использует http://127.0.0.1:11434. Если ваш хост Ollama ожидает bearer-аутентификацию, OpenClaw повторно использует models.providers.ollama.apiKey (или соответствующую аутентификацию провайдера на основе env) для запросов к этому настроенному хосту. Прямой размещенный Ollama Web Search:
{
  models: {
    providers: {
      ollama: {
        baseUrl: "https://ollama.com",
        apiKey: "OLLAMA_API_KEY",
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "ollama",
      },
    },
  },
}

Примечания

  • Для этого провайдера не требуется отдельное поле API-ключа для веб-поиска.
  • Если хост Ollama защищен аутентификацией, OpenClaw повторно использует обычный API-ключ провайдера Ollama, когда он присутствует.
  • Если baseUrl равно https://ollama.com, OpenClaw напрямую вызывает https://ollama.com/api/web_search и отправляет настроенный API-ключ Ollama как bearer-аутентификацию.
  • Если настроенный хост не предоставляет веб-поиск и задан OLLAMA_API_KEY, OpenClaw может вернуться к https://ollama.com/api/web_search без отправки этого env-ключа на локальный хост.
  • OpenClaw предупреждает во время настройки, если Ollama недоступна или вход не выполнен, но не блокирует выбор.
  • OpenClaw не выбирает Ollama Web Search автоматически, когда не настроен провайдер с учетными данными с более высоким приоритетом; выберите его явно через tools.web.search.provider: "ollama".
  • Хосты локального демона Ollama используют локальную прокси-точку /api/experimental/web_search, которая подписывает запросы и пересылает их в Ollama Cloud.
  • Хосты https://ollama.com используют публичную размещенную точку /api/web_search напрямую с bearer-аутентификацией по API-ключу.

Связанные материалы

  • Обзор Web Search — все провайдеры и автообнаружение
  • Ollama — настройка моделей Ollama и облачный/локальный режимы