Langsung ke konten utama
OpenClaw mendukung Ollama Web Search sebagai penyedia web_search bawaan. Ini menggunakan API pencarian web Ollama dan mengembalikan hasil terstruktur dengan judul, URL, dan cuplikan. Untuk Ollama lokal atau yang di-host sendiri, penyiapan ini secara default tidak memerlukan kunci API. Ini memang memerlukan:
  • host Ollama yang dapat dijangkau dari OpenClaw
  • ollama signin
Untuk pencarian hosted langsung, atur URL dasar penyedia Ollama ke https://ollama.com dan berikan OLLAMA_API_KEY yang valid.

Penyiapan

1

Mulai Ollama

Pastikan Ollama sudah terinstal dan berjalan.
2

Masuk

Jalankan:
ollama signin
3

Pilih Ollama Web Search

Jalankan:
openclaw configure --section web
Lalu pilih Ollama Web Search sebagai penyedia.
Jika Anda sudah menggunakan Ollama untuk model, Ollama Web Search menggunakan kembali host yang sama yang telah dikonfigurasi.

Konfigurasi

{
  tools: {
    web: {
      search: {
        provider: "ollama",
      },
    },
  },
}
Penggantian host Ollama opsional:
{
  plugins: {
    entries: {
      ollama: {
        config: {
          webSearch: {
            baseUrl: "http://ollama-host:11434",
          },
        },
      },
    },
  },
}
Jika Anda sudah mengonfigurasi Ollama sebagai penyedia model, penyedia web-search dapat menggunakan kembali host tersebut:
{
  models: {
    providers: {
      ollama: {
        baseUrl: "http://ollama-host:11434",
      },
    },
  },
}
Penyedia model Ollama menggunakan baseUrl sebagai kunci kanonis. Penyedia web-search juga menghormati baseURL pada models.providers.ollama untuk kompatibilitas dengan contoh konfigurasi bergaya OpenAI SDK. Jika tidak ada URL dasar Ollama eksplisit yang ditetapkan, OpenClaw menggunakan http://127.0.0.1:11434. Jika host Ollama Anda mengharapkan autentikasi bearer, OpenClaw menggunakan kembali models.providers.ollama.apiKey (atau autentikasi penyedia berbasis env yang sesuai) untuk permintaan ke host yang dikonfigurasi tersebut. Ollama Web Search hosted langsung:
{
  models: {
    providers: {
      ollama: {
        baseUrl: "https://ollama.com",
        apiKey: "OLLAMA_API_KEY",
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "ollama",
      },
    },
  },
}

Catatan

  • Tidak diperlukan kolom kunci API khusus web-search untuk penyedia ini.
  • Jika host Ollama dilindungi autentikasi, OpenClaw menggunakan kembali kunci API penyedia Ollama normal jika ada.
  • Jika baseUrl adalah https://ollama.com, OpenClaw memanggil https://ollama.com/api/web_search secara langsung dan mengirim kunci API Ollama yang dikonfigurasi sebagai autentikasi bearer.
  • Jika host yang dikonfigurasi tidak mengekspos pencarian web dan OLLAMA_API_KEY ditetapkan, OpenClaw dapat beralih ke https://ollama.com/api/web_search tanpa mengirim kunci env tersebut ke host lokal.
  • OpenClaw memperingatkan selama penyiapan jika Ollama tidak dapat dijangkau atau belum masuk, tetapi tidak memblokir pemilihan.
  • OpenClaw tidak memilih Ollama Web Search secara otomatis ketika tidak ada penyedia berkredensial berprioritas lebih tinggi yang dikonfigurasi; pilih secara eksplisit dengan tools.web.search.provider: "ollama".
  • Host daemon Ollama lokal menggunakan endpoint proksi lokal /api/experimental/web_search, yang menandatangani dan meneruskan ke Ollama Cloud.
  • Host https://ollama.com menggunakan endpoint hosted publik /api/web_search secara langsung dengan autentikasi kunci API bearer.

Terkait