OpenClaw dengan Ollama

Ollama adalah jalur termudah dalam dokumentasi untuk mendapatkan model lokal, dan halamannya dibuka dengan peringatan, bukan sambutan: OpenClaw berbicara dengan API native Ollama, dan mengarahkannya ke URL yang kompatibel dengan OpenAI akan merusak pemanggilan alat. Tiga mode didukung: cloud plus lokal melalui host yang sudah login, cloud saja terhadap layanan milik Ollama sendiri, dan lokal saja. Berikut apa yang ditemukan onboarding dan apa yang tidak mau diasumsikannya, aturan autentikasi per jenis host, daftar pemecahan masalah, dan aturan tentang model kecil yang tidak hilang hanya karena modelnya gratis.

Jangan gunakan URL /v1 yang kompatibel dengan OpenAI (http://host:11434/v1). URL itu merusak pemanggilan alat, dan model dapat mengeluarkan JSON tool-call mentah sebagai teks biasa.

Penyiapan

• Onboarding: pilih Ollama, lalu pilih sebuah mode. Pada penyiapan terpandu yang baru, OpenClaw memeriksa host default atau yang dikonfigurasi, dan penemuan otomatis hanya mempertimbangkan model yang sudah dimuat di memori, dengan dukungan alat dan konteks minimal 16K yang sudah terkonfirmasi; model yang terinstal tetapi menganggur bukan kandidat, rute memerlukan completion sungguhan sebelum disimpan, dan penemuan tidak pernah melakukan pull atau memuat apa pun.
• Mode cloud saja meminta kunci API dan menyarankan default yang di-hosting; cloud plus lokal dan lokal saja meminta base URL dan memeriksa model yang terinstal, dan jika tidak ditemukan model yang mampu menggunakan alat, penyiapan dapat meminta izin untuk melakukan pull model yang direkomendasikan. Model yang diiklankan sebagai khusus embedding tidak dapat menjadi default chat.
• Manual: instal Ollama, lakukan pull sebuah model, login di host yang sama untuk akses cloud hibrida, setel kredensial (nilai apa pun untuk host lokal atau LAN, dan kunci sungguhan untuk layanan Ollama), lalu setel referensi model sebagai ollama, garis miring, nama model.

Aturan autentikasi

Host loopback, jaringan privat, dot-local, dan hostname polos tidak memerlukan bearer token sungguhan; OpenClaw menggunakan penanda lokal untuknya. Host remote publik dan layanan Ollama memerlukan kredensial sungguhan, dan dokumentasi lebih menyarankan ID penyedia cloud khusus untuk penggunaan hosted secara langsung agar perutean cloud tetap terpisah dari penyedia lokal. Kunci yang hanya ada di variabel lingkungan diperlakukan sebagai konvensi cloud dan tidak dikirim ke host lokal secara default, dan autentikasi bearer untuk embedding memori dibatasi pada host tempat autentikasi itu dideklarasikan.

Pemecahan masalah

• Crash loop WSL2: installer Linux resmi membuat layanan dengan restart always; pada penyiapan CUDA, layanan itu dapat memuat model saat boot, mengunci memori host, membuat VM dihentikan oleh Windows, lalu restart tanpa henti. Nonaktifkan layanan tersebut, matikan automatic memory reclaim di konfigurasi WSL, atau jalankan Ollama secara manual dengan keep-alive yang singkat.
• Tidak terdeteksi: pastikan Ollama berjalan dan berada dalam cakupan model agen; penemuan localhost secara ambient memerlukan variabel kunci atau profil autentikasi, dan daftar model manual yang tidak kosong akan melewati penemuan sepenuhnya.
• Tidak ada model: lakukan pull satu model atau definisikan secara eksplisit. Connection refused: periksa prosesnya dan restart. JSON alat tercetak sebagai teks: URL yang kompatibel dengan OpenAI, kesalahan yang disebut di awal halaman.

Model gratis untuk OpenClaw menempatkan Ollama di samping LM Studio, llama.cpp, dan backend lainnya, dan instalasi OpenClaw di Windows adalah tempat penyiapan WSL2 dimulai.

Aturan yang tetap berlaku

FAQ model menyebutkannya sekaligus dengan quick start Ollama: model yang lebih kecil dan terkuantisasi berat lebih rentan terhadap injeksi prompt, gunakan model besar untuk bot apa pun yang memiliki akses alat, dan jika Anda tetap menggunakan model kecil, aktifkan sandboxing dan daftar izin alat yang ketat. OpenClaw dan injeksi prompt menjelaskan serangannya, dan penjelasan sandboxing OpenClaw membahas cara membatasi dampaknya.

Di Diali

Di Diali tidak ada Ollama yang perlu diinstal: model tersedia di katalog terkelola dan dibayar dari kredit yang sudah termasuk. OpenClaw yang di-hosting di Diali adalah asistennya, dan model dan penyedia OpenClaw mencantumkan apa saja yang dicakup katalog.

• API native, tidak pernah URL yang kompatibel dengan OpenAI.
• Penemuan hanya melihat model yang sudah dimuat; penyiapan tidak melakukan pull apa pun tanpa bertanya.
• Host lokal memerlukan penanda, host remote memerlukan kunci, model kecil memerlukan sandbox.