Tìm kiếm trên web

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.

​

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 trong tools.web.search.openaiCodex
• Chỉ kích hoạt cho các mô hình hỗ trợ Codex (openai-codex/* hoặc các nhà cung cấp dùng api: "openai-codex-responses")
• web_search được quản lý vẫn áp dụng cho các mô hình không phải Codex
• mode: "cached" là thiết lập mặc định và được khuyến nghị
• tools.web.search.enabled: false tắt cả tìm kiếm được quản lý và tìm kiếm gốc

{
  tools: {
    web: {
      search: {
        enabled: true,
        openaiCodex: {
          enabled: true,
          mode: "cached",
          allowedDomains: ["example.com"],
          contextSize: "high",
          userLocation: {
            country: "US",
            city: "New York",
            timezone: "America/New_York",
          },
        },
      },
    },
  },
}

​

Thiết lập tìm kiếm web

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 hoặc plugins.entries.minimax.config.webSearch.apiKey (thứ tự 15)
3. Gemini — GEMINI_API_KEY hoặc plugins.entries.google.config.webSearch.apiKey (thứ tự 20)
4. Grok — 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 (thứ tự 65)
9. Tavily — TAVILY_API_KEY hoặc plugins.entries.tavily.config.webSearch.apiKey (thứ tự 70)

10. DuckDuckGo — phương án dự phòng HTML không cần khóa, không cần tài khoản hoặc khóa API (thứ tự 100)
11. Ollama Web Search — phương án dự phòng không cần khóa thông qua máy chủ Ollama cục bộ đã cấu hình của bạn khi máy chủ có thể truy cập và đã đăng nhập bằng ollama signin; có thể tái sử dụng xác thực bearer của nhà cung cấp Ollama khi máy chủ cần, và có thể gọi tìm kiếm trực tiếp https://ollama.com khi được cấu hình với OLLAMA_API_KEY (thứ tự 110)
12. 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 nhà cung cấp web-fetch sẵn sàng đầu tiên từ thông tin xác thực có sẵn
• hiện nay nhà cung cấp web-fetch đi kèm là Firecrawl, được cấu hình trong plugins.entries.firecrawl.config.webFetch.*

• khu vực API Moonshot (https://api.moonshot.ai/v1 hoặc https://api.moonshot.cn/v1)
• mô hình tìm kiếm web 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",
            inlineCitations: false,
            maxTurns: 2,
            timeoutSeconds: 30,
            cacheTtlMinutes: 15,
          },
          webSearch: {
            apiKey: "xai-...", // optional if XAI_API_KEY is set
          },
        },
      },
    },
  },
}

​

Tham số x_search

​

Ví dụ 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

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