Tools

Grok 搜尋

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

同一個 xAI API 金鑰也可以驅動內建的 x_search 工具，用於 X （前稱 Twitter）貼文搜尋，以及 code_execution 工具。如果你將金鑰儲存在 plugins.entries.xai.config.webSearch.apiKey，OpenClaw 現在也會將它重複用作隨附 xAI 模型提供者的備用金鑰。

若要取得貼文層級的 X 指標，例如轉貼、回覆、書籤或瀏覽次數，請優先使用 x_search 搭配精確的貼文 URL 或狀態 ID，而不是寬泛的搜尋查詢。

入門與設定

如果你在下列流程中選擇 Grok：

openclaw onboard
openclaw configure --section web

OpenClaw 可以顯示一個獨立的後續步驟，讓你使用同一個 XAI_API_KEY 啟用 x_search。該後續步驟：

只會在你為 web_search 選擇 Grok 後出現
不是另一個頂層的網頁搜尋提供者選項
可以選擇在同一個流程中設定 x_search 模型

如果你略過它，可以稍後在設定中啟用或變更 x_search。

取得 API 金鑰

建立金鑰

從 xAI 取得 API 金鑰。

儲存金鑰

在 Gateway 環境中設定 XAI_API_KEY，或透過下列方式設定：

bash

openclaw configure --section web

設定

json5

{  plugins: {    entries: {      xai: {        config: {          webSearch: {            apiKey: "xai-...", // optional if XAI_API_KEY is set            baseUrl: "https://api.x.ai/v1", // optional Responses API proxy/base URL override          },        },      },    },  },  tools: {    web: {      search: {        provider: "grok",      },    },  },}

環境替代方式： 在 Gateway 環境中設定 XAI_API_KEY。若是 Gateway 安裝，請將它放在 ~/.openclaw/.env。

運作方式

Grok 使用 xAI 以網頁為依據的回應來綜合產生帶有行內引用的答案，類似 Gemini 的 Google Search grounding 方法。

支援的參數

Grok 搜尋支援 query。

count 會被接受以相容共用的 web_search，但 Grok 仍會回傳一個帶有引用的綜合答案，而不是 N 筆結果清單。

目前不支援提供者專屬篩選器。

Grok 使用提供者專屬的 60 秒預設逾時，因為 xAI Responses 以網頁為依據的搜尋可能比共用的 web_search 預設值執行更久。設定 tools.web.search.timeoutSeconds 可覆寫它。

基礎 URL 覆寫

當 Grok 網頁搜尋應透過操作員 Proxy 或 xAI 相容的 Responses 端點路由時，設定 plugins.entries.xai.config.webSearch.baseUrl。OpenClaw 會在移除尾端斜線後發送到 <baseUrl>/responses。除非已設定 plugins.entries.xai.config.xSearch.baseUrl，否則 x_search 會使用相同的 webSearch.baseUrl 備用值。