概述

Ollama Web Search 是 OpenClaw 内置的 web_search 提供商,通过本地 Ollama 实例或托管 Ollama API 提供结构化搜索结果。本地模式无需 API Key,只需 ollama signin。

核心功能

  • 本地模式:通过本地 Ollama daemon 的 /api/experimental/web_search 端点(签名转发到 Ollama Cloud)
  • 托管模式:直接调用 https://ollama.com/api/web_search(需要 OLLAMA_API_KEY)
  • 复用已配置的 Ollama 模型提供商 host
  • 自动检测优先级:order 110(DuckDuckGo 之后)
  • 若本地 host 不支持 web search 且设置了 OLLAMA_API_KEY,自动回退到托管端点

配置/使用

本地模式(无需 API Key):

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

托管模式:

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

注意事项

  • 本地模式需要先运行 ollama signin
  • 默认 host:http://127.0.0.1:11434
  • 若 Ollama host 需要 bearer auth,OpenClaw 复用 models.providers.ollama.apiKey
  • 设置时若 Ollama 不可达或未登录,OpenClaw 会警告但不阻止选择

相关页面

  • concepts/tool-web — Web 搜索工具总览与提供商对比
  • concepts/tool-duckduckgo-search — DuckDuckGo(另一个免费回退提供商)
  • concepts/tool-searxng-search — SearXNG(自托管元搜索)