Menyelesaikan Isu Tetingkap Konteks 16k OpenClaw

Menyelesaikan isu tetingkap konteks 16k OpenClaw

Tetingkap konteks model OpenClaw tidak semestinya 16k; nilainya bergantung pada konfigurasi setempat. Semak ~/.openclaw/openclaw.json atau ~/.openclaw/agents/<agentId>/agent/models.json, kemudian ubah contextWindow dan maxTokens mengikut nilai sebenar yang disokong oleh model. Contohnya, MiniMax-M2.5 boleh menggunakan contextWindow: 196608 dan maxTokens: 8192. Buka semula OpenClaw selepas membuat perubahan.

Puncanya ialah contextWindow ditetapkan kepada 16000 atau lebih rendah bagi penyedia atau model tersuai. OpenClaw bergantung pada nilai dalam konfigurasi ini. Jika model menyokong tetingkap konteks yang lebih besar, naikkan nilainya; jika tidak, perbualan panjang boleh menyebabkan ralat had API, konteks tidak mencukupi atau tingkah laku yang tidak stabil. Fail konfigurasi utama OpenClaw ialah ~/.openclaw/openclaw.json. Fail models.json yang berasingan juga boleh berada dalam direktori Agent. Apabila konfigurasi digabungkan, OpenClaw menggunakan nilai contextWindow dan maxTokens yang lebih tinggi antara konfigurasi eksplisit dengan katalog terbina dalam.

Halaman konfigurasi web OpenClaw dengan Settings ditandai dalam navigasi…

Cara mengemas kini tetapan konteks OpenClaw

1. Gejala

Jika tetingkap konteks dalam konfigurasi model gateway tersuai atau pihak ketiga ditetapkan terlalu rendah, contohnya:

"contextWindow": 16000,
"maxTokens": 4096

Anda mungkin menghadapi masalah berikut:

• Perbualan panjang mudah gagal
• Panggilan alat menghasilkan ralat lebih kerap
• Antara muka memaparkan mesej bahawa had kadar API telah dicapai
• OpenClaw terus menggunakan nilai yang lebih rendah walaupun model menyokong tetingkap konteks yang lebih besar

Dokumentasi rasmi OpenClaw menerangkan bahawa contextWindow dan maxTokens boleh ditetapkan secara eksplisit dalam konfigurasi. Fail konfigurasi utama terletak di ~/.openclaw/openclaw.json, dan fail models.json yang berasingan dalam direktori Agent juga boleh mengatasi tetapan tersebut.

2. Lokasi fail konfigurasi

1) Fail konfigurasi utama

Fail konfigurasi utama lalai OpenClaw ialah:

~/.openclaw/openclaw.json

Lokasi ini dinyatakan dalam dokumentasi rasmi.

2) Konfigurasi model per Agent

Jika model dikonfigurasi secara berasingan untuk setiap agen, laluan biasanya:

~/.openclaw/agents/<agentId>/agent/models.json

Dokumentasi rasmi menyatakan bahawa penyedia tersuai boleh ditambahkan di bawah models.providers atau ditakrifkan dalam ~/.openclaw/agents/<agentId>/agent/models.json.

3) Direktori akar Agent tersuai

Jika anda telah menetapkan pembolehubah persekitaran berikut:

OPENCLAW_AGENT_DIR

Pemboleh ubah persekitaran ini mengatasi lokasi direktori konfigurasi Agent. Dokumentasi rasmi turut menyatakan bahawa OPENCLAW_AGENT_DIR atau PI_CODING_AGENT_DIR boleh menukar direktori akar konfigurasi Agent.

3. Cara mengubah nilai

Pilihan A: Ubah konfigurasi utama

openclaw.json

Buka:

~/.openclaw/openclaw.json

Cari konfigurasi untuk penyedia model semasa anda, sebagai contoh:

{
  models: {
    mode: "merge",
    providers: {
      minimax: {
        baseUrl: "https://api.minimax.io/anthropic",
        api: "anthropic-messages",
        apiKey: "你的 API Key",
        models: [
          {
            id: "MiniMax-M2.5",
            name: "MiniMax-M2.5",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 196608,
            maxTokens: 8192
          }
        ]
      }
    }
  }
}

Contoh rasmi MiniMax-M2.5 menggunakan contextWindow: 196608 dan maxTokens: 8192.

Pilihan B: Kemas kini fail peringkat Agent

models.json

Buka:

~/.openclaw/agents/<agentId>/agent/models.json

Ubah nilai bagi model berkaitan daripada:

"contextWindow": 16000,
"maxTokens": 4096

kepada nilai yang lebih sesuai, contohnya:

"contextWindow": 196608,
"maxTokens": 8192

4. Nilai yang disyorkan

Jangan tetapkan nilai sesuka hati. Menetapkan 1000000 hanya kerana anda mahukan tetingkap konteks 1M tidak bermakna model benar-benar menyokongnya.

Panduan yang disyorkan

• contextWindow: Gunakan saiz tetingkap konteks yang benar-benar disokong oleh model
• maxTokens: Gunakan panjang output maksimum yang benar-benar disokong oleh model
• Jika anda menggunakan API Gateway, semak had sebenar yang dibenarkan oleh gateway, bukan hanya had penyedia asal

Contoh MiniMax-M2.5

Contoh dalam dokumentasi rasmi OpenClaw menggunakan:

"contextWindow": 196608,
"maxTokens": 8192

5. Selepas mengemas kini konfigurasi

Simpan konfigurasi, kemudian mulakan semula OpenClaw atau proses gateway yang berkaitan.

Perintah biasa termasuk:

openclaw models list
openclaw models set minimax/MiniMax-M2.5

Dokumentasi rasmi turut menyediakan arahan ini untuk menyemak dan menukar model.

Jika OpenClaw berjalan sebagai perkhidmatan, mulakan semula perkhidmatan berkaitan juga, contohnya:

openclaw gateway restart

Sebagai alternatif, mulakan semula perkhidmatan systemd, proses pm2 atau bekas Docker anda.

6. Nota tambahan

Rujukan konfigurasi rasmi OpenClaw turut menyatakan bahawa:

• Penyedia tersuai boleh ditakrifkan terus di bawah models.providers.
• contextWindow dan maxTokens boleh ditetapkan secara jelas
• Bagi model yang sepadan, OpenClaw menggunakan nilai yang lebih tinggi antara konfigurasi eksplisit dengan katalog terbina dalam
• Untuk menggantikan sepenuhnya models.json dengan konfigurasi anda sendiri, gunakan models.mode: "replace".

Dokumentasi rasmi semasa turut menyatakan bahawa jika medan ini tidak diisi bagi penyedia tersuai, nilai lalainya ialah contextWindow: 200000 dan maxTokens: 8192. Jika klien masih memaparkan 16k atau 4k, itu tidak semestinya bermakna OpenClaw kini hanya menyokong 16k. Kemungkinan besar, konfigurasi model setempat telah ditetapkan terlalu rendah secara manual atau konfigurasi lama masih digunakan.