OpenClaw Penyelesaian isu tetingkap konteks dan had kadar
Bezakan had kadar 429, had konteks terlampaui dan ralat metadata model setempat, kemudian laraskan contextWindow, contextTokens serta maxTokens dengan selamat.
Kenal pasti jenis ralat dahulu
API rate limit reached lazimnya menunjukkan huluan memulangkan 429, had konkurensi atau had kuota; ayat ini sahaja tidak cukup untuk menentukan ia berpunca daripada konfigurasi konteks 16k. Semak kod status dan ralat asal dahulu, kemudian tentukan sama ada perlu mengubah konfigurasi.
| Gejala | Punca yang lebih berkemungkinan | Perkara pertama yang perlu dilakukan |
|---|---|---|
429、rate_limit、quota、too many requests | Had kadar huluan, had konkurensi atau kuota tidak cukup | Kurangkan konkurensi dan cuba lagi sebentar, periksa kuota serta status huluan |
context_length_exceeded, permintaan terlalu besar, input terlampaui | Input bersama output simpanan melebihi had model atau gateway | Pendekkan perbualan, dayakan pemampatan, kemudian semak konfigurasi konteks |
| OpenClaw tetingkap gesaan setempat terlalu kecil | Metadata model tersuai hilang atau konfigurasi lama tertinggal | Semak contextWindow, contextTokens, maxTokens |
| Hanya satu model gagal | Penghalaan model atau isu parameter model tersebut | Cuba model lain dengan Key dan Base URL yang sama untuk permintaan minimum |
Lokasi Model Window pada halaman tetapan OpenClaw. Nama medan tertentu a…
Apakah yang diwakili oleh setiap medan
contextWindow: Metadata tetingkap konteks asli model.contextTokens: Had input sebenar yang dibenarkan oleh OpenClaw, boleh lebih kecil daripada tetingkap asal.maxTokens: Had Token output maksimum untuk satu respons, bukan jumlah saiz konteks.
Jangan mengisi 1M secara sembarangan demi "mendapatkan konteks yang lebih besar". Nilai yang diisi mesti serentak mematuhi keupayaan model, had penghalaan semasa LLM API Gateway dan versi klien.
Lokasi konfigurasi
Konfigurasi utama biasanya terletak di:
~/.openclaw/openclaw.jsonApabila dikonfigurasi secara berasingan mengikut Agent, biasanya terletak di:
~/.openclaw/agents/<agentId>/agent/models.jsonJika OPENCLAW_AGENT_DIR ditetapkan, sila cari konfigurasi Agent yang sepadan dalam direktori tersebut.
Contoh pengubahsuaian selamat
Nilai di bawah hanya menunjukkan hubungan antara medan, bukan had sebenar semua model. Sila sahkan nilai dalam senarai model tapak dan penerangan penghalaan semasa:
{
models: {
mode: "merge",
providers: {
guishu: {
baseUrl: "https://api.llm-token.cn/v1",
apiKey: "YOUR_API_KEY",
api: "openai-completions",
models: [
{
id: "YOUR_MODEL_ID",
name: "YOUR_MODEL_ID",
contextWindow: 128000,
contextTokens: 96000,
maxTokens: 8192,
input: ["text"]
}
]
}
}
}
}Peruntukkan sebahagian tetingkap untuk gesaan sistem, hasil alatan dan output model. Jika huluan hanya membenarkan input atau output yang lebih kecil, terus turunkan nilainya; jangan hanya mengikut nilai promosi vendor model.
Urutan pengubahsuaian dan pengesahan
- Sandarkan fail konfigurasi semasa, jangan terus menimpa salinan tunggal.
- Ubah hanya entri provider dan model semasa, kekalkan konfigurasi lain.
- Jalankan
openclaw models list, sahkan model dikenali. - Jalankan
openclaw models set guishu/YOUR_MODEL_ID, sahkan provider/model yang dipilih betul. - Mulakan semula gateway:
openclaw gateway restart. - Hantar permintaan ujian yang sangat pendek dahulu, kemudian tambah konteks secara berperingkat.
Jika permintaan pendek juga memulangkan 429, terus membesarkan tetingkap konteks tidak membantu; sebaliknya periksa konkurensi, kuota akaun dan status huluan. Jika hanya permintaan panjang yang gagal, semak panjang input, strategi pemampatan dan tiga medan konteks.
Tangkapan skrin konfigurasi dan log mungkin mengandungi Key API. Sebelum menyerahkannya kepada sokongan, sila sorokkan Key sepenuhnya dan simpan hanya masa ralat, kod status, ID model dan ID permintaan.