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 用作持有者身份验证凭据。
• 否则，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 模型设置以及云端/本地模式