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

设置

1

启动 Ollama

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

登录

3

选择 Ollama Web 搜索

选择 Ollama Web 搜索 作为提供商。
如果你已使用 Ollama 运行模型,Ollama Web 搜索会复用同一 已配置的主机。
OpenClaw 绝不会优先于具有更高优先级且已配置凭据的提供商, 自动选择 Ollama Web 搜索;你必须使用 tools.web.search.provider: "ollama" 显式选择它。

配置

可选的主机覆盖,仅适用于 Web 搜索:
或者复用已为 Ollama 模型提供商配置的主机:
models.providers.ollama.baseUrl 是规范键;为兼容 OpenAI SDK 风格的 配置示例,Web 搜索提供商也接受其中的 baseURL。 如果未设置任何值,OpenClaw 默认使用 http://127.0.0.1:11434 直接使用托管式 Ollama Web 搜索(不使用本地 Ollama):

身份验证和请求路由

  • 不存在 Web 搜索专用的 API key 字段;当配置的主机受身份验证保护时,提供商会复用 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 key 用作 bearer 身份验证凭据。
  • 否则,OpenClaw 会先调用本地代理端点 /api/experimental/web_search(该端点会签名并转发至 Ollama Cloud),然后回退到同一主机上的 /api/web_search。如果两者均失败 且已设置 OLLAMA_API_KEY,则会使用该 key 对 https://ollama.com/api/web_search 重试一次,而不会将其发送给 本地主机。
  • 如果 Ollama 无法访问或尚未登录,OpenClaw 会在设置期间发出警告,但 不会阻止选择该提供商。

相关内容