Ollama Web 搜索

OpenClaw 支持将 Ollama Web 搜索 作为内置的 web_search 提供商， 通过 Ollama 的 Web 搜索 API 返回标题、URL 和摘要。

本地/自托管 Ollama 默认不需要 API key；它需要可访问的 Ollama 主机以及 ollama signin。直接使用托管搜索（不使用本地 Ollama）需要 baseUrl: "https://ollama.com" 和真实的 OLLAMA_API_KEY。

设置

ollama signin

openclaw configure --section web

如果你已使用 Ollama 运行模型，Ollama Web 搜索会复用同一 已配置的主机。

配置

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

可选的主机覆盖，仅适用于 Web 搜索：

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

或者复用已为 Ollama 模型提供商配置的主机：

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

models.providers.ollama.baseUrl 是规范键；为兼容 OpenAI SDK 风格的 配置示例，Web 搜索提供商也接受其中的 baseURL。 如果未设置任何值，OpenClaw 默认使用 http://127.0.0.1:11434。

直接使用托管式 Ollama Web 搜索（不使用本地 Ollama）：

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

身份验证和请求路由

• 不存在 Web 搜索专用的 API key 字段；当配置的主机受身份验证保护时，提供商会复用 models.providers.ollama.apiKey（或由匹配环境变量支持的提供商身份验证）。
• 主机解析顺序：plugins.entries.ollama.config.webSearch.baseUrl → models.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 会在设置期间发出警告，但 不会阻止选择该提供商。

相关内容

• Web 搜索概览 -- 所有提供商和自动检测
• Ollama -- Ollama 模型设置以及云端/本地模式