Ollama 网络搜索

OpenClaw 支持将 Ollama Web Search 作为内置的 web_search 提供商， 返回来自 Ollama web-search API 的标题、URL 和摘要。

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

设置¶

如果你已经使用 Ollama 来运行模型，Ollama Web Search 会复用同一个 已配置的主机。

本地 Ollama¶

1. 启动 Ollama

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

2. 登录

ollama signin

3. 选择 Ollama Web Search

openclaw configure --section web

选择 Ollama Web Search 作为提供商。

托管 Ollama¶

1. 创建 Ollama API 密钥 并在 Gateway 环境中设置 OLLAMA_API_KEY。
2. 将 models.providers.ollama.baseUrl 设置为 https://ollama.com；参见 配置。这是共享的 Ollama 模型提供商主机，因此它也会 将你的 Ollama 模型 流量发送到 https://ollama.com，而不是本地守护进程。如果只想迁移网络搜索，请设置 plugins.entries.ollama.config.webSearch.baseUrl 为 https://ollama.com 并让 models.providers.ollama.baseUrl 指向你的本地主机。
3. 运行 openclaw configure --section web 并选择 Ollama Web Search。

托管搜索不需要本地 Ollama 守护进程或 ollama signin。

配置¶

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

可选的主机覆盖，仅作用于网络搜索：

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

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

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

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

直接托管 Ollama Web Search（无本地 Ollama）：

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

models.providers.ollama.apiKey 可以接受字面量密钥字符串或 SecretRef 对象。单独的 "OLLAMA_API_KEY" 字符串会作为密钥本身发送， 而不是从环境中读取。

认证和请求路由¶

• 不存在网络搜索专用的 API 密钥字段；当配置的主机受认证保护时，提供商会复用 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 会直接使用 API 密钥作为 bearer 认证调用 https://ollama.com/api/web_search。
• 否则，OpenClaw 首先调用本地代理端点 /api/experimental/web_search（它会签名并转发到 Ollama Cloud），然后回退到同一主机上的 /api/web_search。如果两者都失败 且设置了 OLLAMA_API_KEY，它会使用该密钥对 https://ollama.com/api/web_search 重试一次——而不会将其发送到 本地主机。
• 如果本地 Ollama 主机不可达或未 登录，或者托管搜索没有 API 密钥，OpenClaw 会在设置期间发出警告。这些警告不会阻止 选择该提供商。

相关¶

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