跳轉到主要內容

Documentation Index

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

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

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 金鑰

1

建立金鑰

從 xAI 取得 API 金鑰。
2

儲存金鑰

在 Gateway 環境中設定 XAI_API_KEY，或透過下列方式設定：
openclaw configure --section web

​
設定

{
  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 備用值。

​
相關