在 OpenClaw 中配置 Ollama 网页搜索，本地模式无需 API Key，只需 Ollama 运行并执行 ollama signin。托管模式设置 baseUrl 为 https://ollama.com 并配置 OLLAMA_API_KEY。默认使用 http://127.0.0.1:11434，可复用模型 provider 的 host 和 apiKey。配置时若 Ollama 不可达或未登录会出警告，但不阻止选择。

OpenClaw Ollama 网页搜索配置：无需 API Key 的本地与托管模式

OpenClaw 内置 Ollama Web Search 作为 web_search provider，使用 Ollama 的网页搜索 API，返回包含标题、URL 和摘要的结构化结果。

对于本地或自托管 Ollama，此配置默认不需要 API Key，但需要：

• 一个 OpenClaw 可访问的 Ollama 主机
• 运行 ollama signin

对于直接托管搜索，设置 Ollama provider 的 baseUrl 为 https://ollama.com，并提供有效的 OLLAMA_API_KEY。

设置步骤

1. 启动 Ollama
   确保 Ollama 已安装并运行。

2. 登录 Ollama

   ollama signin

3. 选择 Ollama Web Search

   openclaw configure --section web

   然后选择 Ollama Web Search 作为 provider。

如果已在用 Ollama 作为模型 provider，网页搜索会复用同一个配置的 host。

配置

基础配置（只需指定 provider）：

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

可选：覆盖 Ollama 主机地址：

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

如果已经将 Ollama 配置为模型 provider，网页搜索可以复用该地址：

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

Ollama 模型 provider 使用 baseUrl 作为规范键。网页搜索 provider 同样支持 models.providers.ollama 下的 baseURL（兼容 OpenAI SDK 风格配置示例）。

若不设置任何 Ollama base URL，OpenClaw 默认使用 http://127.0.0.1:11434。

如果 Ollama 主机需要 Bearer 认证，OpenClaw 会复用 models.providers.ollama.apiKey（或环境变量对应的 provider 认证）对该主机发起的搜索请求。

直接托管 Ollama Web Search 配置示例：

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

注意事项

• 此 provider 不需要专用的网页搜索 API Key 字段。
• 如果 Ollama 主机有鉴权保护，OpenClaw 会复用普通 Ollama provider 的 API Key（若有）。
• 当 baseUrl 为 https://ollama.com 时，OpenClaw 直接调用 https://ollama.com/api/web_search，并将配置的 Ollama API Key 作为 Bearer 认证发送。
• 如果配置的本地主机未暴露网页搜索且设置了 OLLAMA_API_KEY，OpenClaw 可以回退到 https://ollama.com/api/web_search，不会将该环境密钥发送到本地主机。
• 设置过程中若 Ollama 不可达或未登录，OpenClaw 会发出警告，但不阻止选择。
• 运行时自动检测可回退到 Ollama Web Search（当没有更高优先级的带凭证 provider 配置时）。
• 本地 Ollama 守护进程使用本地代理端点 /api/experimental/web_search，该端点签署请求并转发至 Ollama Cloud。
• https://ollama.com 主机直接使用公开托管端点 /api/web_search，并附带 Bearer API Key 认证。

延伸阅读

• Web Search 总览 – 所有 provider 及其自动检测
• Ollama Provider – Ollama 模型配置及本地/云端模式

常见问题

没有执行 ollama signin 会怎样？

OpenClaw 在配置时会发出警告，但不阻止选择。运行时如果 Ollama 服务可达但未登录，搜索请求可能返回认证错误（例如 401）。建议在配置前先确认 ollama signin 已成功。

怎么配置远程 Ollama 主机（非 localhost）？

在 models.providers.ollama.baseUrl 中指定远程地址，例如 http://192.168.31.8:11434，OpenClaw 会自动复用该地址进行搜索请求。如果远程 Ollama 需要认证，同时设置 models.providers.ollama.apiKey 即可。

如何验证 Ollama 网页搜索配置生效？

在 OpenClaw 中执行任意 web 搜索请求（例如通过智能体发送 search: something）。如果配置正确，应返回包含标题、URL 和摘要的结构化结果。如果返回空或报错，先检查 Ollama 是否运行、是否已登录，以及 OLLAMA_API_KEY（托管模式）是否有效。