OpenClaw melaporkan permintaan LLM melewati batas waktu

Permintaan model yang melewati batas waktu adalah salah satu error pertama yang ditemui orang setelah mengalihkan OpenClaw ke model lokal, dan halaman pemecahan masalah dalam dokumentasi memberikan daftar penyebab yang pendek. Sebagian besar menyangkut backend lokal: model besar yang dimuat dalam keadaan dingin, jendela konteks yang tidak sanggup ditangani perangkat keras, host yang menjawab curl tetapi tidak menjawab Gateway. Dua menyangkut penyedia yang di-hosting: batas laju yang tampil sebagai 429 dan pemblokiran upstream yang tampil sebagai 403. Berikut masing-masing penyebab beserta perbaikannya, dalam urutan yang disarankan dokumentasi untuk dicoba.

Penyebab lokal

• Model yang masih dingin: model lokal yang besar bisa memerlukan waktu muat pertama yang lama. Tetapkan batas waktu yang lebih panjang khusus untuk penyedia Ollama, dengan contoh dari dokumentasi 300 detik, dan jaga model tetap dimuat di antara giliran dengan parameter keep-alive pada entri model; pengaturan yang sama juga memperpanjang batas waktu koneksi saat host lambat menerima koneksi.
• Jendela konteks terlalu besar: banyak model mengiklankan konteks yang tidak dapat dijalankan perangkat keras dengan nyaman. Batasi anggaran token OpenClaw sekaligus konteks permintaan pada entri model agar latensi token pertama dapat diprediksi.
• Host yang berfungsi dengan curl tetapi tidak dengan OpenClaw: lakukan verifikasi dari mesin dan runtime yang menjalankan Gateway, karena base URL yang menyebut localhost tidak mengarah ke mana pun dari dalam container Docker, URL-nya mungkin membawa sufiks kompatibel OpenAI yang mengubah perilaku, host jarak jauh mungkin memerlukan perubahan firewall atau binding, dan model mungkin berada di daemon laptop, bukan di daemon jarak jauh.

Model lokal yang besar bisa memerlukan waktu muat pertama yang lama.

Backend yang lolos probe tetapi tetap gagal

Halaman pemecahan masalah penyedia memuat kasus backend lokal kompatibel OpenAI yang menjawab permintaan kecil secara langsung tetapi tetap gagal dalam eksekusi agen: transport-nya kemungkinan sudah benar dan backend gagal pada bentuk prompt runtime agen yang lebih besar, dengan Gemma pada sebagian build llama-server sebagai contoh dari dokumentasi. Pesan giliran tidak lengkap tanpa payload berarti backend menyelesaikan permintaan tetapi tidak mengembalikan teks yang terlihat; OpenClaw mencoba ulang giliran seperti itu satu kali. Jika kegagalan berkurang setelah alat dinonaktifkan tetapi tidak hilang, skema alat ikut menjadi beban dan sisanya adalah soal kapasitas backend atau bug.

Penyebab di sisi hosting

• 429 yang menyatakan bahwa penggunaan tambahan (extra usage) diperlukan untuk konteks panjang: model Anthropic yang dipilih memiliki jendela native sejuta token, atau konfigurasi lama masih membawa flag long-context lawas, dan kredensialnya tidak memenuhi syarat. Beralihlah ke jendela standar, gunakan kredensial yang memenuhi syarat atau kunci API, dan konfigurasikan model cadangan agar eksekusi tetap berlanjut.
• 403 generik yang menyatakan permintaan diblokir: tidak selalu masalah OpenClaw; bisa berasal dari CDN, WAF, aturan manajemen bot, atau reverse proxy di depan endpoint kompatibel OpenAI, jadi periksa status, status Gateway, dan log sebelum mengubah konfigurasi.
• URL yang salah: sufiks kompatibel OpenAI pada host Ollama merusak pemanggilan alat dan dapat membuat model mencetak JSON alat sebagai teks; URL native, tanpa sufiks, adalah perbaikannya.

OpenClaw dengan Ollama memuat halaman lengkap tentang model lokal, dan OpenClaw tidak merespons adalah urutan pemeriksaan saat gejalanya berupa diam, bukan batas waktu.

Cara memeriksanya

Setiap penyebab ini dimulai dengan tiga perintah sama yang diulang-ulang dokumentasi: ikuti log, periksa status model, dan baca konfigurasi model. Log OpenClaw menjelaskan di mana file-nya berada dan cara mengikutinya dengan tail.

Di Diali

Di Diali, model di-hosting dan batas waktunya kami yang menyetel, jadi separuh lokal dari daftar ini tidak berlaku; separuh hosting ditangani oleh routing cadangan sebelum balasan hilang. OpenClaw yang di-hosting di Diali adalah asistennya.

• Model dingin: batas waktu penyedia yang lebih panjang dan keep-alive.
• Konteks terlalu banyak: batasi anggaran dan konteks permintaan.
• 429 atau 403 berasal dari penyedia, bukan Gateway.