Pencarian web

Alat web_search mencari di web menggunakan penyedia yang Anda konfigurasikan dan mengembalikan hasil. Hasil di-cache berdasarkan kueri selama 15 menit (dapat dikonfigurasi).

OpenClaw juga menyertakan x_search untuk postingan X (sebelumnya Twitter) dan web_fetch untuk pengambilan URL ringan. Dalam fase ini, web_fetch tetap lokal sementara web_search dan x_search dapat menggunakan xAI Responses di balik layar.

# Mulai cepat

openclaw configure --section web

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

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

# Memilih penyedia

# Perbandingan penyedia

# Deteksi otomatis

# Pencarian web OpenAI native

Model OpenAI Responses langsung menggunakan alat web_search yang dihosting OpenAI secara otomatis saat pencarian web OpenClaw diaktifkan dan tidak ada penyedia terkelola yang dipatok. Ini adalah perilaku milik penyedia di Plugin OpenAI bawaan dan hanya berlaku untuk lalu lintas API OpenAI native, bukan URL dasar proksi yang kompatibel dengan OpenAI atau rute Azure. Atur tools.web.search.provider ke penyedia lain seperti brave untuk tetap menggunakan alat web_search terkelola bagi model OpenAI, atau atur tools.web.search.enabled: false untuk menonaktifkan pencarian terkelola dan pencarian OpenAI native.

# Pencarian web Codex native

Model berkemampuan Codex secara opsional dapat menggunakan alat web_search Responses native penyedia alih-alih fungsi web_search terkelola OpenClaw.

• Konfigurasikan di bawah tools.web.search.openaiCodex
• Ini hanya aktif untuk model berkemampuan Codex (openai-codex/* atau penyedia yang menggunakan api: "openai-codex-responses")
• web_search terkelola tetap berlaku untuk model non-Codex
• mode: "cached" adalah pengaturan default dan yang direkomendasikan
• tools.web.search.enabled: false menonaktifkan pencarian terkelola dan native

{
  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",
          },
        },
      },
    },
  },
}

Jika pencarian Codex native diaktifkan tetapi model saat ini tidak berkemampuan Codex, OpenClaw mempertahankan perilaku web_search terkelola normal.

# Keamanan jaringan

Panggilan penyedia web_search terkelola menggunakan jalur fetch terlindungi OpenClaw. Untuk host API penyedia tepercaya, OpenClaw mengizinkan jawaban DNS fake-IP Surge, Clash, dan sing-box dalam 198.18.0.0/15 dan fc00::/7 hanya untuk nama host penyedia tersebut. Tujuan privat, loopback, link-local, dan metadata lainnya tetap diblokir.

Izin otomatis ini tidak berlaku untuk URL web_fetch arbitrer. Untuk web_fetch, aktifkan tools.web.fetch.ssrfPolicy.allowRfc2544BenchmarkRange dan tools.web.fetch.ssrfPolicy.allowIpv6UniqueLocalRange secara eksplisit hanya saat proksi tepercaya Anda memiliki rentang sintetis tersebut.

# Menyiapkan pencarian web

Daftar penyedia dalam dokumentasi dan alur penyiapan bersifat alfabetis. Deteksi otomatis mempertahankan urutan prioritas terpisah.

Jika tidak ada provider yang ditetapkan, OpenClaw memeriksa penyedia dalam urutan ini dan menggunakan penyedia pertama yang siap:

Penyedia yang didukung API terlebih dahulu:

1. Brave -- BRAVE_API_KEY atau plugins.entries.brave.config.webSearch.apiKey (urutan 10)
2. MiniMax Search -- MINIMAX_CODE_PLAN_KEY / MINIMAX_CODING_API_KEY / MINIMAX_OAUTH_TOKEN / MINIMAX_API_KEY atau plugins.entries.minimax.config.webSearch.apiKey (urutan 15)
3. Gemini -- plugins.entries.google.config.webSearch.apiKey, GEMINI_API_KEY, atau models.providers.google.apiKey (urutan 20)
4. Grok -- XAI_API_KEY atau plugins.entries.xai.config.webSearch.apiKey (urutan 30)
5. Kimi -- KIMI_API_KEY / MOONSHOT_API_KEY atau plugins.entries.moonshot.config.webSearch.apiKey (urutan 40)
6. Perplexity -- PERPLEXITY_API_KEY / OPENROUTER_API_KEY atau plugins.entries.perplexity.config.webSearch.apiKey (urutan 50)
7. Firecrawl -- FIRECRAWL_API_KEY atau plugins.entries.firecrawl.config.webSearch.apiKey (urutan 60)
8. Exa -- EXA_API_KEY atau plugins.entries.exa.config.webSearch.apiKey; plugins.entries.exa.config.webSearch.baseUrl opsional menimpa endpoint Exa (urutan 65)
9. Tavily -- TAVILY_API_KEY atau plugins.entries.tavily.config.webSearch.apiKey (urutan 70)

Fallback bebas kunci setelah itu:

10. DuckDuckGo -- fallback HTML bebas kunci tanpa akun atau kunci API (urutan 100)
11. Ollama Web Search -- fallback bebas kunci melalui host Ollama lokal yang Anda konfigurasi saat dapat dijangkau dan sudah masuk dengan ollama signin; dapat menggunakan kembali auth bearer penyedia Ollama saat host membutuhkannya, dan dapat memanggil pencarian langsung https://ollama.com saat dikonfigurasi dengan OLLAMA_API_KEY (urutan 110)
12. SearXNG -- SEARXNG_BASE_URL atau plugins.entries.searxng.config.webSearch.baseUrl (urutan 200)

Jika tidak ada penyedia yang terdeteksi, ini melakukan fallback ke Brave (Anda akan mendapatkan kesalahan kunci hilang yang meminta Anda mengonfigurasikannya).

# Konfigurasi

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

Konfigurasi khusus penyedia (kunci API, URL dasar, mode) berada di bawah plugins.entries.<plugin>.config.webSearch.*. Gemini juga dapat menggunakan kembali models.providers.google.apiKey dan models.providers.google.baseUrl sebagai fallback berprioritas lebih rendah setelah konfigurasi pencarian web khususnya dan GEMINI_API_KEY. Lihat halaman penyedia untuk contoh.

tools.web.search.provider divalidasi terhadap id penyedia pencarian web yang dideklarasikan oleh manifes Plugin bawaan dan terinstal, ditambah Plugin penyedia yang diketahui dapat diinstal. Salah ketik seperti "brvae" akan membuat validasi konfigurasi gagal, bukan diam-diam fallback ke deteksi otomatis. Jika penyedia yang dikonfigurasi dikenal tetapi Plugin pemiliknya tidak tersedia, OpenClaw menjaga startup tetap tangguh dan melaporkan peringatan agar Anda dapat menjalankan openclaw doctor --fix untuk menginstal atau mengaktifkan Plugin tersebut. Perilaku peringatan yang sama berlaku untuk bukti Plugin yang usang, seperti blok plugins.entries.<plugin> yang tersisa setelah menghapus instalasi Plugin pihak ketiga.

Pemilihan penyedia fallback web_fetch terpisah:

• pilih dengan tools.web.fetch.provider
• atau hilangkan bidang tersebut dan biarkan OpenClaw mendeteksi otomatis penyedia web-fetch pertama yang siap dari kredensial yang tersedia
• web_fetch non-sandbox dapat menggunakan penyedia Plugin terinstal yang mendeklarasikan contracts.webFetchProviders; fetch bersandbox tetap hanya bawaan
• saat ini penyedia web-fetch bawaan adalah Firecrawl, dikonfigurasi di bawah plugins.entries.firecrawl.config.webFetch.*

Saat Anda memilih Kimi selama openclaw onboard atau openclaw configure --section web, OpenClaw juga dapat meminta:

• region API Moonshot (https://api.moonshot.ai/v1 atau https://api.moonshot.cn/v1)
• model pencarian web Kimi default (default ke kimi-k2.6)

Untuk x_search, konfigurasikan plugins.entries.xai.config.xSearch.*. Ini menggunakan fallback XAI_API_KEY yang sama seperti pencarian web Grok. Konfigurasi lama tools.web.x_search.* dimigrasikan otomatis oleh openclaw doctor --fix. Saat Anda memilih Grok selama openclaw onboard atau openclaw configure --section web, OpenClaw juga dapat menawarkan penyiapan x_search opsional dengan kunci yang sama. Ini adalah langkah lanjutan terpisah di dalam jalur Grok, bukan pilihan penyedia pencarian web tingkat atas yang terpisah. Jika Anda memilih penyedia lain, OpenClaw tidak menampilkan prompt x_search.

# Menyimpan kunci API

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

export BRAVE_API_KEY="YOUR_KEY"

# Parameter alat

# x_search

x_search mengueri postingan X (sebelumnya Twitter) menggunakan xAI dan mengembalikan jawaban tersintesis AI dengan sitasi. Ini menerima kueri bahasa alami dan filter terstruktur opsional. OpenClaw hanya mengaktifkan alat x_search xAI bawaan pada permintaan yang melayani panggilan alat ini.

# Konfigurasi 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 XAI_API_KEY is set
            baseUrl: "https://api.x.ai/v1", // optional shared xAI Responses base URL
          },
        },
      },
    },
  },
}

x_search memposting ke <baseUrl>/responses saat plugins.entries.xai.config.xSearch.baseUrl diatur. Jika bidang tersebut dihilangkan, ini fallback ke plugins.entries.xai.config.webSearch.baseUrl, lalu tools.web.search.grok.baseUrl lama, dan akhirnya endpoint xAI publik.

# Parameter x_search

# Contoh 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",
});

# Contoh

// 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"],
});

# Profil alat

Jika Anda menggunakan profil alat atau allowlist, tambahkan web_search, x_search, atau group:web:

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

# Terkait

• Web Fetch -- mengambil URL dan mengekstrak konten yang dapat dibaca
• Web Browser -- otomatisasi browser penuh untuk situs berat JS
• Grok Search -- Grok sebagai penyedia web_search
• Ollama Web Search -- pencarian web tanpa kunci melalui host Ollama Anda