Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw 支持 Ollama Web 搜索 作为内置的 web_search 提供商。它使用 Ollama 的网页搜索 API，并返回包含标题、URL 和摘要的结构化结果。 对于本地或自托管的 Ollama，此设置默认不需要 API 密钥。但它确实需要：
  • 一个可从 OpenClaw 访问到的 Ollama 主机
  • ollama signin
对于直接使用托管搜索，请将 Ollama 提供商的基础 URL 设置为 https://ollama.com，并提供真实的 OLLAMA_API_KEY。

​
设置

1

启动 Ollama

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

登录

运行：
ollama signin
3

选择 Ollama Web 搜索

运行：
openclaw configure --section web
然后选择 Ollama Web 搜索 作为提供商。
如果你已经将 Ollama 用于模型，Ollama Web 搜索会复用同一个已配置的主机。

​
配置

{
  tools: {
    web: {
      search: {
        provider: "ollama",
      },
    },
  },
}
可选的 Ollama 主机覆盖： 
{
  plugins: {
    entries: {
      ollama: {
        config: {
          webSearch: {
            baseUrl: "http://ollama-host:11434",
          },
        },
      },
    },
  },
}
如果你已经将 Ollama 配置为模型提供商，则网页搜索提供商也可以改为复用该主机： 
{
  models: {
    providers: {
      ollama: {
        baseUrl: "http://ollama-host:11434",
      },
    },
  },
}
Ollama 模型提供商使用 baseUrl 作为规范键名。为了兼容 OpenAI SDK 风格的配置示例，网页搜索提供商也支持在 models.providers.ollama 上使用 baseURL。 如果未显式设置 Ollama 基础 URL，OpenClaw 会使用 http://127.0.0.1:11434。 如果你的 Ollama 主机需要 bearer 认证，OpenClaw 会将 models.providers.ollama.apiKey（或对应由环境变量支持的提供商认证）复用于对该已配置主机的请求。 直接使用托管的 Ollama Web 搜索： 
{
  models: {
    providers: {
      ollama: {
        baseUrl: "https://ollama.com",
        apiKey: "OLLAMA_API_KEY",
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "ollama",
      },
    },
  },
}

​
说明

  • 此提供商不需要专用的网页搜索 API 密钥字段。
  • 如果 Ollama 主机受认证保护，OpenClaw 会在存在时复用常规 Ollama 提供商 API 密钥。
  • 如果 baseUrl 是 https://ollama.com，OpenClaw 会直接调用 https://ollama.com/api/web_search，并将已配置的 Ollama API 密钥作为 bearer 认证发送。
  • 如果已配置的主机未暴露网页搜索，而设置了 OLLAMA_API_KEY，OpenClaw 可以回退到 https://ollama.com/api/web_search，同时不会将该环境变量密钥发送到本地主机。
  • 如果 Ollama 无法访问或尚未登录，OpenClaw 会在设置期间发出警告，但不会阻止选择。
  • 当未配置更高优先级的、带凭证的提供商时，运行时自动检测可以回退到 Ollama Web 搜索。
  • 本地 Ollama 守护进程主机使用本地代理端点 /api/experimental/web_search，该端点会签名并转发到 Ollama Cloud。
  • https://ollama.com 主机则直接使用公共托管端点 /api/web_search，并采用 bearer API 密钥认证。

​
相关内容