English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Tools

Ollama 網頁搜尋

OpenClaw 支援 Ollama 網頁搜尋 作為內建的 web_search provider。它使用 Ollama 的網頁搜尋 API，並回傳包含標題、URL 和摘要片段的結構化結果。

對於本機或自行託管的 Ollama，此設定預設不需要 API 金鑰。它需要：

  • OpenClaw 可連線到的 Ollama 主機
  • ollama signin

若要直接使用託管搜尋，請將 Ollama provider base URL 設為 https://ollama.com，並提供真正的 OLLAMA_API_KEY。

設定

  • 啟動 Ollama

    確認 Ollama 已安裝並正在執行。

  • 登入

    執行：

    ollama signin

  • 選擇 Ollama 網頁搜尋

    執行：

    openclaw configure --section web

    然後選取 Ollama 網頁搜尋 作為 provider。

    • 如果你已使用 Ollama 作為模型，Ollama 網頁搜尋會重用相同的已設定主機。

    設定檔

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

    可選的 Ollama 主機覆寫：

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

    如果你已將 Ollama 設定為模型 provider，網頁搜尋 provider 可以改為重用該主機：

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

    Ollama 模型 provider 使用 baseUrl 作為標準鍵。為了相容 OpenAI SDK 風格的設定範例，網頁搜尋 provider 也會接受 models.providers.ollama 上的 baseURL。

    如果未明確設定 Ollama base URL，OpenClaw 會使用 http://127.0.0.1:11434。

    如果你的 Ollama 主機需要 bearer 驗證，OpenClaw 會重用 models.providers.ollama.apiKey（或相符的 env 後援 provider 驗證）來向該已設定主機發出請求。

    直接託管的 Ollama 網頁搜尋：

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

    注意事項

    • 此 provider 不需要網頁搜尋專用的 API 金鑰欄位。
    • 如果 Ollama 主機受驗證保護，OpenClaw 會在存在時重用一般 Ollama provider 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，而不會將該 env 金鑰傳送到本機主機。
    • 如果 Ollama 無法連線或尚未登入，OpenClaw 會在設定期間警告，但不會阻止選取。
    • 當未設定較高優先順序且具認證的 provider 時，執行階段自動偵測可以退回使用 Ollama 網頁搜尋。
    • 本機 Ollama daemon 主機使用本機 Proxy 端點 /api/experimental/web_search，該端點會簽署並轉送至 Ollama Cloud。
    • https://ollama.com 主機會直接使用公開託管端點 /api/web_search，並搭配 bearer API 金鑰驗證。

    相關