Pencarian web Ollama

OpenClaw mendukung Ollama Web Search sebagai penyedia web_search bawaan, yang mengembalikan judul, URL, dan cuplikan dari API pencarian web Ollama.

Ollama lokal/yang dihos sendiri secara default tidak memerlukan kunci API; diperlukan host Ollama yang dapat dijangkau serta ollama signin. Pencarian yang dihos langsung (tanpa Ollama lokal) memerlukan baseUrl: "https://ollama.com" dan OLLAMA_API_KEY yang valid.

Penyiapan

ollama signin

openclaw configure --section web

Jika Anda sudah menggunakan Ollama untuk model, Ollama Web Search menggunakan kembali host terkonfigurasi yang sama.

Konfigurasi

{  tools: {    web: {      search: {        provider: "ollama",      },    },  },}

Penggantian host opsional, yang hanya berlaku untuk pencarian web:

{  plugins: {    entries: {      ollama: {        config: {          webSearch: {            baseUrl: "http://ollama-host:11434",          },        },      },    },  },}

Atau gunakan kembali host yang sudah dikonfigurasi untuk penyedia model Ollama:

{  models: {    providers: {      ollama: {        baseUrl: "http://ollama-host:11434",      },    },  },}

models.providers.ollama.baseUrl adalah kunci kanonis; penyedia pencarian web juga menerima baseURL di sana untuk kompatibilitas dengan contoh konfigurasi bergaya OpenAI SDK. Jika tidak ada yang ditetapkan, OpenClaw secara default menggunakan http://127.0.0.1:11434.

Ollama Web Search yang dihos langsung (tanpa Ollama lokal):

{  models: {    providers: {      ollama: {        baseUrl: "https://ollama.com",        apiKey: "OLLAMA_API_KEY",      },    },  },  tools: {    web: {      search: {        provider: "ollama",      },    },  },}

Autentikasi dan perutean permintaan

• Tidak ada bidang kunci API khusus pencarian web; penyedia menggunakan kembali models.providers.ollama.apiKey (atau autentikasi penyedia berbasis variabel lingkungan yang cocok) saat host terkonfigurasi dilindungi autentikasi.
• Urutan resolusi host: plugins.entries.ollama.config.webSearch.baseUrl → models.providers.ollama.baseUrl (atau baseURL) → http://127.0.0.1:11434.
• Jika host yang dihasilkan adalah https://ollama.com, OpenClaw memanggil https://ollama.com/api/web_search secara langsung dengan kunci API sebagai autentikasi bearer.
• Jika tidak, OpenClaw terlebih dahulu memanggil titik akhir proksi lokal /api/experimental/web_search (yang menandatangani dan meneruskan permintaan ke Ollama Cloud), lalu beralih ke /api/web_search pada host yang sama jika gagal. Jika keduanya gagal dan OLLAMA_API_KEY ditetapkan, OpenClaw mencoba kembali satu kali ke https://ollama.com/api/web_search dengan kunci tersebut — tanpa mengirimkannya ke host lokal.
• OpenClaw menampilkan peringatan selama penyiapan jika Ollama tidak dapat dijangkau atau belum digunakan untuk masuk, tetapi tidak mencegah pemilihan penyedia.

Terkait

• Ringkasan Pencarian Web -- semua penyedia dan deteksi otomatis
• Ollama -- penyiapan model Ollama serta mode cloud/lokal