Skip to main content
OpenClaw 支持 Ollama Web Search 作为内置的 web_search 提供商, 可返回来自 Ollama web-search API 的标题、URL 和摘要。 本地/自托管的 Ollama 默认不需要 API 密钥;它只需要一个可访问的 Ollama 主机以及 ollama signin。直接使用托管搜索(无需本地 Ollama)则需要 baseUrl: "https://ollama.com" 和一个真实的 OLLAMA_API_KEY

设置

1

启动 Ollama

确保 Ollama 已安装并正在运行。
2

登录

3

选择 Ollama Web Search

选择 Ollama Web Search 作为提供程序。
如果你已经将 Ollama 用于模型,Ollama Web Search 会复用同一个 已配置的主机。
OpenClaw 从不会自动优先选择 Ollama Web Search 而覆盖更高优先级的 带凭据提供程序;你必须使用 tools.web.search.provider: "ollama" 显式选择它。

配置

仅针对 Web 搜索的可选主机覆盖:
或者复用已为 Ollama 模型提供程序配置的主机:
models.providers.ollama.baseUrl 是规范键;为了与 OpenAI SDK 风格的配置示例兼容,web-search 提供程序也接受这里的 baseURL。如果未设置任何内容,OpenClaw 默认使用 http://127.0.0.1:11434 直接使用托管的 Ollama Web Search(不使用本地 Ollama):

认证与请求路由

  • 不存在专门用于 Web 搜索的 API 密钥字段;当配置的主机受身份验证保护时,提供方会复用 models.providers.ollama.apiKey(或对应的环境变量注入提供方认证)。
  • 主机解析顺序:plugins.entries.ollama.config.webSearch.baseUrlmodels.providers.ollama.baseUrl(或 baseURL)→ http://127.0.0.1:11434
  • 如果解析后的主机是 https://ollama.com,OpenClaw 会直接调用 https://ollama.com/api/web_search,并将 API 密钥作为 bearer 认证。
  • 否则 OpenClaw 会先调用本地代理端点 /api/experimental/web_search(该端点会签名并转发到 Ollama Cloud),然后回退到同一主机上的 /api/web_search。如果两者都失败 且已设置 OLLAMA_API_KEY,它会使用该密钥重试一次 https://ollama.com/api/web_search——不会将其发送到本地主机。
  • 如果 Ollama 无法访问或未登录,OpenClaw 会在设置过程中发出警告,但 不会阻止选择该提供方。

相关