Tìm kiếm trên web

​

Bắt đầu nhanh

openclaw configure --section web

await web_search({ query: "OpenClaw plugin SDK" });

await x_search({ query: "dinner recipes" });

​

Chọn nhà cung cấp

​

So sánh nhà cung cấp

​

Tự động phát hiện

​

Tìm kiếm web OpenAI gốc

​

Tìm kiếm web Codex gốc

• Cấu hình tìm kiếm gốc trong tools.web.search.openaiCodex
• Đặt tools.web.search.provider: "codex" để cấp phát Codex Hosted Search làm nhà cung cấp web_search được quản lý cho mọi mô hình cha. Mỗi lệnh gọi chạy một lượt máy chủ ứng dụng Codex tạm thời có giới hạn và thất bại nếu Codex không phát ra một mục webSearch được lưu trữ.
• mode: "cached" là tùy chọn mặc định, nhưng Codex phân giải nó thành quyền truy cập bên ngoài trực tiếp cho các lượt máy chủ ứng dụng không bị hạn chế; đặt "live" để yêu cầu quyền truy cập trực tiếp rõ ràng
• Đặt tools.web.search.provider thành một nhà cung cấp được quản lý như brave để dùng web_search được quản lý của OpenClaw thay thế
• Đặt tools.web.search.openaiCodex.enabled: false để không dùng tìm kiếm do Codex lưu trữ; các nhà cung cấp được quản lý khác vẫn khả dụng
• Việc hạn chế bề mặt công cụ Codex gốc cũng giữ cho web_search được quản lý khả dụng
• Khi đặt allowedDomains, phương án dự phòng được quản lý tự động sẽ thất bại đóng nếu tìm kiếm được lưu trữ không khả dụng, để danh sách cho phép gốc không thể bị vượt qua
• Các lượt chạy chỉ dùng LLM với công cụ bị tắt sẽ tắt cả tìm kiếm gốc lẫn tìm kiếm được quản lý
• tools.web.search.enabled: false tắt cả tìm kiếm được quản lý lẫn tìm kiếm gốc

{
  tools: {
    web: {
      search: {
        enabled: true,
        // Optional: use Codex Hosted Search from non-Codex parent models too.
        provider: "codex",
        openaiCodex: {
          enabled: true,
          mode: "cached",
          allowedDomains: ["example.com"],
          contextSize: "high",
          userLocation: {
            country: "US",
            city: "New York",
            timezone: "America/New_York",
          },
        },
      },
    },
  },
}

​

An toàn mạng

​

Thiết lập web search

1. Brave — BRAVE_API_KEY hoặc plugins.entries.brave.config.webSearch.apiKey (thứ tự 10)
2. MiniMax Search — MINIMAX_CODE_PLAN_KEY / MINIMAX_CODING_API_KEY / MINIMAX_OAUTH_TOKEN / MINIMAX_API_KEY hoặc plugins.entries.minimax.config.webSearch.apiKey (thứ tự 15)
3. Gemini — plugins.entries.google.config.webSearch.apiKey, GEMINI_API_KEY, hoặc models.providers.google.apiKey (thứ tự 20)
4. Grok — xAI OAuth, XAI_API_KEY, hoặc plugins.entries.xai.config.webSearch.apiKey (thứ tự 30)
5. Kimi — KIMI_API_KEY / MOONSHOT_API_KEY hoặc plugins.entries.moonshot.config.webSearch.apiKey (thứ tự 40)
6. Perplexity — PERPLEXITY_API_KEY / OPENROUTER_API_KEY hoặc plugins.entries.perplexity.config.webSearch.apiKey (thứ tự 50)
7. Firecrawl — FIRECRAWL_API_KEY hoặc plugins.entries.firecrawl.config.webSearch.apiKey (thứ tự 60)
8. Exa — EXA_API_KEY hoặc plugins.entries.exa.config.webSearch.apiKey; tùy chọn plugins.entries.exa.config.webSearch.baseUrl ghi đè endpoint Exa (thứ tự 65)
9. Tavily — TAVILY_API_KEY hoặc plugins.entries.tavily.config.webSearch.apiKey (thứ tự 70)
10. Parallel — API Parallel Search trả phí qua PARALLEL_API_KEY hoặc plugins.entries.parallel.config.webSearch.apiKey; tùy chọn plugins.entries.parallel.config.webSearch.baseUrl ghi đè endpoint (thứ tự 75)

11. SearXNG — SEARXNG_BASE_URL hoặc plugins.entries.searxng.config.webSearch.baseUrl (thứ tự 200)

​

Cấu hình

{
  tools: {
    web: {
      search: {
        enabled: true, // default: true
        provider: "brave", // or omit for auto-detection
        maxResults: 5,
        timeoutSeconds: 30,
        cacheTtlMinutes: 15,
      },
    },
  },
}

• chọn bằng tools.web.fetch.provider
• hoặc bỏ qua trường đó và để OpenClaw tự động phát hiện provider web-fetch sẵn sàng đầu tiên từ thông tin xác thực đã cấu hình
• web_fetch không sandbox có thể dùng các provider plugin đã cài đặt khai báo contracts.webFetchProviders; các fetch có sandbox cho phép provider được đóng gói sẵn và cài đặt plugin chính thức đã xác minh, nhưng loại trừ plugin bên ngoài của bên thứ ba
• plugin Firecrawl chính thức cung cấp fallback web-fetch, được cấu hình dưới plugins.entries.firecrawl.config.webFetch.*

• vùng API Moonshot (https://api.moonshot.ai/v1 hoặc https://api.moonshot.cn/v1)
• mô hình web-search Kimi mặc định (mặc định là kimi-k2.6)

​

Lưu trữ khóa API

{
  plugins: {
    entries: {
      brave: {
        config: {
          webSearch: {
            apiKey: "YOUR_KEY", // pragma: allowlist secret
          },
        },
      },
    },
  },
}

export BRAVE_API_KEY="YOUR_KEY"

​

Tham số công cụ

​

x_search

​

Cấu hình x_search

{
  plugins: {
    entries: {
      xai: {
        config: {
          xSearch: {
            enabled: true,
            model: "grok-4-1-fast-non-reasoning",
            baseUrl: "https://api.x.ai/v1", // optional, overrides webSearch.baseUrl
            inlineCitations: false,
            maxTurns: 2,
            timeoutSeconds: 30,
            cacheTtlMinutes: 15,
          },
          webSearch: {
            apiKey: "xai-...", // optional if an xAI auth profile or XAI_API_KEY is set
            baseUrl: "https://api.x.ai/v1", // optional shared xAI Responses base URL
          },
        },
      },
    },
  },
}

​

Tham số x_search

​

Ví dụ về x_search

await x_search({
  query: "dinner recipes",
  allowed_x_handles: ["nytfood"],
  from_date: "2026-03-01",
});

// Per-post stats: use the exact status URL or status ID when possible
await x_search({
  query: "https://x.com/huntharo/status/1905678901234567890",
});

​

Ví dụ

// Basic search
await web_search({ query: "OpenClaw plugin SDK" });

// German-specific search
await web_search({ query: "TV online schauen", country: "DE", language: "de" });

// Recent results (past week)
await web_search({ query: "AI developments", freshness: "week" });

// Date range
await web_search({
  query: "climate research",
  date_after: "2024-01-01",
  date_before: "2024-06-30",
});

// Domain filtering (Perplexity only)
await web_search({
  query: "product reviews",
  domain_filter: ["-reddit.com", "-pinterest.com"],
});

​

Hồ sơ công cụ

{
  tools: {
    allow: ["web_search", "x_search"],
    // or: allow: ["group:web"]  (includes web_search, x_search, and web_fetch)
  },
}

​

Liên quan

• Tìm nạp web — tìm nạp một URL và trích xuất nội dung dễ đọc
• Trình duyệt web — tự động hóa trình duyệt đầy đủ cho các trang dùng nhiều JS
• Tìm kiếm Grok — Grok làm nhà cung cấp web_search
• Tìm kiếm web Ollama — tìm kiếm web không cần khóa thông qua máy chủ Ollama của bạn