Ollama 網頁搜尋

OpenClaw 支援 Ollama Web Search 作為內建的 web_search 提供者， 可從 Ollama 的網頁搜尋 API 傳回標題、URL 與摘要。

本機／自行託管的 Ollama 預設不需要 API 金鑰；但必須有可連線的 Ollama 主機以及 ollama signin。直接使用託管搜尋（不使用本機 Ollama）則需要 baseUrl: "https://ollama.com" 與有效的 OLLAMA_API_KEY。

​

設定

1. 啟動 Ollama

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

2. 登入

   ollama signin
   
3. 選擇 Ollama Web Search

   openclaw configure --section web
   

   選擇 Ollama Web Search 作為提供者。

如果你已使用 Ollama 執行模型，Ollama Web Search 會重複使用相同的 已設定主機。

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 是標準鍵；為了與 OpenAI SDK 風格的 設定範例相容，網頁搜尋提供者也接受此處的 baseURL。 若未設定任何值，OpenClaw 預設使用 http://127.0.0.1:11434。

直接使用託管的 Ollama Web Search（不使用本機 Ollama）：

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

​

驗證與請求路由

• 沒有網頁搜尋專用的 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 會直接呼叫 https://ollama.com/api/web_search，並使用 API 金鑰進行 Bearer 驗證。
• 否則，OpenClaw 會先呼叫本機代理端點 /api/experimental/web_search（由其簽署請求並轉送至 Ollama Cloud），再改用同一主機上的 /api/web_search。如果兩者都失敗 且已設定 OLLAMA_API_KEY，則會使用該金鑰對 https://ollama.com/api/web_search 重試一次，且不會將該金鑰傳送至 本機主機。
• 如果 Ollama 無法連線或尚未登入，OpenClaw 會在設定期間發出警告，但 不會阻止選擇該提供者。

​

相關資訊

• 網頁搜尋概覽 — 所有提供者與自動偵測
• Ollama — Ollama 模型設定以及雲端／本機模式