Tools

Grok 搜尋

OpenClaw 支援將 Grok 作為 web_search 提供者，使用以網路資訊為依據的 xAI 回應，根據即時搜尋結果產生附有引用來源的 AI 綜合答案。

Grok 網路搜尋會優先使用現有的 xAI OAuth 登入（若有）。如果沒有 OAuth 設定檔，同一把 xAI API 金鑰也可供內建的 x_search 工具搜尋 X（前稱 Twitter）貼文，以及供 code_execution 工具使用。將金鑰儲存在 plugins.entries.xai.config.webSearch.apiKey，也可讓 OpenClaw 將其重複用作隨附 xAI 模型提供者的備援。

若要取得貼文層級的 X 指標（轉發、回覆、書籤、瀏覽次數），請使用 x_search 並提供確切的貼文 URL 或狀態 ID，而非寬泛的搜尋查詢。

新手設定與配置

在 openclaw onboard 或 openclaw configure --section web 期間選擇 Grok，可讓 OpenClaw 重複使用現有的 xAI OAuth 設定檔，而不會提示輸入另一把網路搜尋金鑰。沒有 OAuth 時，則會退回使用 xAI API 金鑰設定。

接著，OpenClaw 會提供後續步驟，讓你使用同一組 xAI 憑證啟用 x_search。此後續步驟：

僅在你選擇 Grok 作為 web_search 提供者後顯示
並非另一個獨立的頂層網路搜尋提供者選項
可選擇在同一流程中設定 x_search 模型

你可以略過此步驟，稍後再於設定中啟用或變更 x_search。

登入或取得 API 金鑰

使用 xAI OAuth

如果你已在新手設定或模型驗證期間登入 xAI，請選擇 Grok 作為 web_search 提供者。不需要另一把 API 金鑰：

bash

openclaw onboard --auth-choice xai-oauthopenclaw config set tools.web.search.provider grok

使用 API 金鑰備援

當 OAuth 無法使用，或你刻意想使用由金鑰支援的網路搜尋設定時，請從 xAI 取得 API 金鑰。

儲存金鑰

在閘道環境中設定 XAI_API_KEY，或透過以下指令進行配置：

bash

openclaw configure --section web

設定

json5

{  plugins: {    entries: {      xai: {        config: {          webSearch: {            apiKey: "xai-...", // 若可使用 xAI OAuth 或 XAI_API_KEY，則為選填            baseUrl: "https://api.x.ai/v1", // 選填的 Responses API Proxy／基底 URL 覆寫值          },        },      },    },  },  tools: {    web: {      search: {        provider: "grok",      },    },  },}

憑證替代方案：openclaw models auth login --provider xai --method oauth、閘道環境中的 XAI_API_KEY，或 plugins.entries.xai.config.webSearch.apiKey。若為閘道安裝，請將環境變數放在 ~/.openclaw/.env 中。

運作方式

Grok 使用以網路資訊為依據的 xAI 回應，綜合產生含行內引用來源的答案，類似 Gemini 的 Google 搜尋依據機制。

支援的參數

Grok 搜尋支援 query。為了與共用 web_search 相容，亦接受 count，但 Grok 一律傳回一個附有引用來源的綜合答案，而非包含 N 筆結果的清單。不支援提供者專屬的篩選條件。

Grok 預設逾時時間為 60 秒，因為以網路資訊為依據的 xAI Responses 搜尋可能比共用 web_search 的預設時間執行得更久。可使用 tools.web.search.timeoutSeconds 覆寫此設定。

基底 URL 覆寫

設定 plugins.entries.xai.config.webSearch.baseUrl，可透過營運者 Proxy 或與 xAI 相容的 Responses 端點路由 Grok 網路搜尋。OpenClaw 移除結尾斜線後，會向 <baseUrl>/responses 傳送 POST 要求。除非設定了 plugins.entries.xai.config.xSearch.baseUrl，否則 x_search 會退回使用相同的 webSearch.baseUrl。