OpenClaw การตรวจสอบหน้าต่างบริบทและข้อจำกัดอัตรา
แยกแยะ 429 ข้อจำกัดอัตรา การเกินหน้าต่างบริบท และข้อผิดพลาดเมตาดาตาของโมเดลในเครื่อง จากนั้นปรับ contextWindow contextTokens และ maxTokens อย่างปลอดภัย
ตรวจสอบประเภทข้อผิดพลาดก่อน
API rate limit reached โดยทั่วไปหมายถึงฝั่งต้นทางส่งกลับ 429 ข้อจำกัดการทำงานพร้อมกัน หรือข้อจำกัดของโควตา ไม่สามารถตัดสินจากข้อความนี้เพียงอย่างเดียวว่าเป็นเพราะการตั้งค่า 16k บริบทไม่ถูกต้อง ควรดูรหัสสถานะและข้อผิดพลาดดิบก่อน จากนั้นจึงตัดสินใจว่าจะแก้ไขการกำหนดค่าหรือไม่
| อาการ | สาเหตุที่น่าจะเป็น | สิ่งที่ต้องทำก่อน |
|---|---|---|
429 rate_limit quota too many requests | ฝั่งต้นทางจำกัดอัตรา การทำงานพร้อมกัน หรือโควตาไม่เพียงพอ | ลดการทำงานพร้อมกันและลองใหม่ในภายหลัง ตรวจสอบโควตาและสถานะฝั่งต้นทาง |
context_length_exceeded คำขอใหญ่เกินไป อินพุตเกินขีดจำกัด | อินพุตบวกเอาต์พุตที่สำรองไว้เกินขีดจำกัดของโมเดลหรือเกตเวย์ | ย่นบทสนทนาลง เปิดใช้งานการบีบอัด แล้วตรวจสอบการกำหนดค่าบริบท |
| OpenClaw หน้าต่างในเครื่องเล็กเกินไป | เมตาดาตาของโมเดลแบบกำหนดเองขาดหายไปหรือมีการกำหนดค่าเก่าหลงเหลือ | ตรวจสอบ contextWindow contextTokens maxTokens |
| มีเพียงโมเดลเดียวที่ล้มเหลว | ปัญหาเกี่ยวกับการกำหนดเส้นทางโมเดลหรือพารามิเตอร์ของโมเดลนั้น | ใช้คีย์และ Base URL เดียวกัน เปลี่ยนเป็นโมเดลอื่นเพื่อส่งคำขอขนาดเล็กที่สุด |
OpenClaw ตำแหน่งของ Model Window ในหน้าการตั้งค่า ชื่อของฟิลด์เฉพาะอาจเป…]
สามฟิลด์นี้หมายถึงอะไร
contextWindow: เมตาดาตาของหน้าต่างบริบทดั้งเดิมของโมเดลcontextTokens: OpenClaw ขีดจำกัดสูงสุดที่อนุญาตให้ใช้เป็นอินพุตจริง สามารถน้อยกว่าหน้าต่างดั้งเดิมได้maxTokens: ขีดจำกัดเอาต์พุตสูงสุดของ Token ต่อการตอบสนองครั้งเดียว ไม่ใช่ขนาดบริบททั้งหมด
อย่ากรอก 1M ตามอำเภอใจเพียงเพื่อให้ได้บริบทที่ใหญ่ขึ้น ค่าที่กรอกต้องสอดคล้องกับความสามารถของโมเดล ข้อจำกัดการกำหนดเส้นทางปัจจุบันของ LLM API Gateway และเวอร์ชันของไคลเอนต์พร้อมกัน
ตำแหน่งการกำหนดค่า
การกำหนดค่าหลักมักอยู่ที่:
~/.openclaw/openclaw.jsonเมื่อกำหนดค่าแยกตาม Agent มักอยู่ที่:
~/.openclaw/agents/<agentId>/agent/models.jsonหากตั้งค่า OPENCLAW_AGENT_DIR โปรดไปที่ไดเรกทอรีนั้นเพื่อค้นหาการกำหนดค่าของ Agent ที่เกี่ยวข้อง
ตัวอย่างการแก้ไขอย่างปลอดภัย
ค่าต่อไปนี้ใช้แสดงความสัมพันธ์ของฟิลด์เท่านั้น ไม่ได้หมายถึงขีดจำกัดจริงของทุกโมเดล โปรดตรวจสอบค่าในรายการโมเดลของเว็บไซต์นี้และคำอธิบายการกำหนดเส้นทางปัจจุบันก่อน:
{
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"]
}
]
}
}
}
}สำรองบริเวณหนึ่งของหน้าต่างไว้สำหรับระบบพรอมต์ ผลลัพธ์ของเครื่องมือ และเอาต์พุตของโมเดล หากฝั่งต้นทางอนุญาตเฉพาะอินพุตหรือเอาต์พุตที่เล็กกว่า ควรลดค่าลงต่อไป ไม่ใช่เพียงกรอกตามค่าที่ผู้ผลิตโมเดลโฆษณาไว้
ลำดับการแก้ไขและตรวจสอบ
1 สำรองไฟล์การกำหนดค่าปัจจุบัน อย่าเขียนทับสำเนาเพียงชุดเดียวโดยตรง
2 แก้เฉพาะรายการ provider และโมเดลปัจจุบัน เก็บการกำหนดค่าอื่นไว้
3 รัน openclaw models list เพื่อยืนยันว่าโมเดลถูกจดจำ
4 รัน openclaw models set guishu/YOUR_MODEL_ID เพื่อยืนยันว่าเลือก provider/model ถูกต้อง
5 รีสตาร์ตเกตเวย์: openclaw gateway restart
6 ส่งคำขอทดสอบสั้นๆ หนึ่งรายการก่อน จากนั้นค่อยๆ เพิ่มบริบททีละน้อย
หากคำขอสั้นๆ ก็ส่งกลับ 429 ด้วย การเพิ่มหน้าต่างบริบทให้ใหญ่ขึ้นจะไม่ช่วย ควรเปลี่ยนไปตรวจสอบการทำงานพร้อมกัน โควตาบัญชี และสถานะฝั่งต้นทาง หากมีเฉพาะคำขอยาวที่ล้มเหลว ค่อยตรวจสอบความยาวอินพุต กลยุทธ์การบีบอัด และสามฟิลด์บริบท
ภาพหน้าจอการกำหนดค่าและบันทึกอาจมี API Key ก่อนส่งให้ฝ่ายสนับสนุน โปรดปิดบังคีย์เต็ม ให้เก็บเฉพาะเวลาที่เกิดข้อผิดพลาด รหัสสถานะ รหัสโมเดล และรหัสคำขอไว้