# Ollama Web 搜索

> 通过本地 Ollama 主机或托管的 Ollama API 使用 Ollama Web 搜索

- 网址：https://funcoding.ai/agents/openclaw/tools/ollama-search/
- 来源：OpenClaw 官方文档原文（中文），MIT 许可，同步于 2026-10-11
- 官方原文：https://docs.openclaw.ai/zh-CN/tools/ollama-search

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

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

## 设置

**启动 Ollama**

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

**登录**

```bash
ollama signin
```

**选择 Ollama Web 搜索**

```bash
openclaw configure --section web
```

选择 **Ollama Web 搜索** 作为提供商。

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

<div class="callout callout-note">

OpenClaw 绝不会优先于具有更高优先级且已配置凭据的提供商，
自动选择 Ollama Web 搜索；你必须使用
`tools.web.search.provider: "ollama"` 显式选择它。

</div>

## 配置

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

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

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

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

```json5
{
  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）：

```json5
{
  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 搜索概览](https://funcoding.ai/agents/openclaw/tools/web/) -- 所有提供商和自动检测
- [Ollama](https://funcoding.ai/agents/openclaw/providers/ollama/) -- Ollama 模型设置以及云端/本地模式