跳转至

Ollama 网络搜索

OpenClaw 支持 Ollama Web Search 作为内置的 web_search 提供商, 返回来自 Ollama 网络搜索 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。

Note

OpenClaw 永远不会自动选择 Ollama Web Search 来替代优先级更高的 已配置凭据的提供商;你必须使用 tools.web.search.provider: "ollama" 显式选择它。

配置

{
  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 会在设置期间发出警告。这些警告不会阻止选择该提供商。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw