跳轉到主要內容

Documentation Index

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

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

OpenClaw 支援 Ollama 網頁搜尋 作為內建的 web_search provider。它使用 Ollama 的網頁搜尋 API，並回傳包含標題、URL 和摘要片段的結構化結果。 對於本機或自行託管的 Ollama，此設定預設不需要 API 金鑰。它需要：
  • OpenClaw 可連線到的 Ollama 主機
  • ollama signin
若要直接使用託管搜尋，請將 Ollama provider base URL 設為 https://ollama.com，並提供真正的 OLLAMA_API_KEY。

​
設定

1

啟動 Ollama

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

登入

執行：
ollama signin
3

選擇 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 金鑰驗證。

​
相關