วิธีแก้ปัญหาหน้าต่างบริบท 16k ของ OpenClaw

วิธีแก้ปัญหาหน้าต่างบริบท 16k ของ OpenClaw

หน้าต่างบริบทของโมเดลใน OpenClaw ไม่ได้กำหนดตายตัวที่ 16k แต่ขึ้นอยู่กับการกำหนดค่าในเครื่องเป็นหลัก โปรดตรวจสอบ ~/.openclaw/openclaw.json หรือ ~/.openclaw/agents/<agentId>/agent/models.json แล้วเปลี่ยนค่า contextWindow และ maxTokens ของโมเดลที่เกี่ยวข้องให้ตรงกับค่าที่โมเดลรองรับจริง ตัวอย่างเช่น MiniMax-M2.5 สามารถตั้งค่า contextWindow: 196608 และ maxTokens: 8192 ได้ หลังแก้ไขแล้วให้รีสตาร์ต OpenClaw ทั้งเอกสารอ้างอิงการกำหนดค่าอย่างเป็นทางการและตัวอย่างของ MiniMax รองรับรูปแบบนี้

ต้นเหตุที่แท้จริงคือ มีการตั้งค่า contextWindow เป็น 16000 หรือต่ำกว่านั้นในผู้ให้บริการหรือโมเดลที่กำหนดเอง โดย OpenClaw อาศัยค่าการกำหนดค่าเหล่านี้อย่างมาก หากโมเดลรองรับหน้าต่างบริบทที่ใหญ่กว่าจริง ก็ควรเพิ่มค่านี้ มิฉะนั้นอาจพบข้อผิดพลาด API rate limit reached พื้นที่บริบทไม่เพียงพอ หรือการทำงานผิดปกติระหว่างการสนทนาที่ยาว เอกสารอ้างอิงการกำหนดค่าอย่างเป็นทางการระบุว่าไฟล์การกำหนดค่าหลักของ OpenClaw คือ ~/.openclaw/openclaw.json และยังสามารถวางไฟล์ models.json แยกไว้ในไดเรกทอรีของ agent ได้ เมื่อจับคู่โมเดล OpenClaw จะเลือกใช้ค่า contextWindow และ maxTokens ที่สูงกว่าระหว่างการกำหนดค่าแบบระบุชัดเจนกับ catalog ภายใน

แท็บ “Settings” ในหน้าการกำหนดค่าของ OpenClaw โดยมีกรอบสีแดงเน้น “Settin…

วิธีแก้ไขการกำหนดค่าหน้าต่างบริบทของ OpenClaw

1. อาการที่พบ

หากตั้งค่าหน้าต่างบริบทในการกำหนดค่าโมเดลแบบกำหนดเองหรือโมเดลจากเกตเวย์ของบุคคลที่สามไว้ต่ำเกินไป เช่น:

"contextWindow": 16000,
"maxTokens": 4096

อาจพบปัญหาต่อไปนี้:

• การสนทนาที่ยาวล้มเหลวได้ง่าย
• เกิดข้อผิดพลาดระหว่างเรียกใช้เครื่องมือบ่อยขึ้น
• หน้าเว็บแสดงข้อความ API rate limit reached
• แม้โมเดลจะรองรับหน้าต่างบริบทที่ใหญ่กว่า แต่ OpenClaw ยังคงประมวลผลตามค่าที่ต่ำกว่า

เอกสารอย่างเป็นทางการของ OpenClaw อธิบายว่าสามารถกำหนดค่า contextWindow และ maxTokens อย่างชัดเจนในการกำหนดค่าได้ ไฟล์การกำหนดค่าหลักอยู่ที่ ~/.openclaw/openclaw.json และสามารถใช้ไฟล์ models.json แยกในไดเรกทอรีของ agent เพื่อแทนที่การตั้งค่าเหล่านี้ได้เช่นกัน

2. ตำแหน่งไฟล์การกำหนดค่า

1) ไฟล์การกำหนดค่าหลัก

ไฟล์การกำหนดค่าหลักเริ่มต้นของ OpenClaw คือ:

~/.openclaw/openclaw.json

ตำแหน่งนี้ระบุไว้ในเอกสารอย่างเป็นทางการ

2) การกำหนดค่าโมเดลของ Agent

หากกำหนดค่าโมเดลแยกตาม agent โดยทั่วไปไฟล์จะอยู่ที่:

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

เอกสารอย่างเป็นทางการระบุว่าสามารถเพิ่มผู้ให้บริการแบบกำหนดเองไว้ภายใต้ models.providers หรือกำหนดไว้ใน ~/.openclaw/agents/<agentId>/agent/models.json ได้

3) ไดเรกทอรีรากของ Agent แบบกำหนดเอง

หากตั้งค่าตัวแปรสภาพแวดล้อมต่อไปนี้ไว้:

OPENCLAW_AGENT_DIR

ตัวแปรสภาพแวดล้อมนี้จะแทนที่ไดเรกทอรีการกำหนดค่าของ agent เอกสารอย่างเป็นทางการยังระบุว่าสามารถใช้ OPENCLAW_AGENT_DIR หรือ PI_CODING_AGENT_DIR เพื่อเปลี่ยนไดเรกทอรีรากของการกำหนดค่า agent ได้

3. วิธีแก้ไขค่า

ตัวเลือก A: แก้ไขการกำหนดค่าหลัก

openclaw.json

เปิดไฟล์:

~/.openclaw/openclaw.json

ค้นหาการกำหนดค่าของผู้ให้บริการโมเดลที่ใช้งานอยู่ เช่น:

{
  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
          }
        ]
      }
    }
  }
}

ตัวอย่าง MiniMax-M2.5 อย่างเป็นทางการใช้ค่า contextWindow: 196608 และ maxTokens: 8192

ตัวเลือก B: แก้ไขไฟล์ระดับ Agent

models.json

เปิดไฟล์:

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

เปลี่ยนค่าของโมเดลที่เกี่ยวข้องจาก:

"contextWindow": 16000,
"maxTokens": 4096

เป็นค่าที่เหมาะสมกว่า เช่น:

"contextWindow": 196608,
"maxTokens": 8192

4. ค่าที่แนะนำ

อย่ากำหนดค่าตามใจชอบ การตั้งค่าเป็น 1000000 เพียงเพราะต้องการหน้าต่างบริบทขนาด 1M ไม่ได้ทำให้โมเดลรองรับค่านั้นจริง

หลักเกณฑ์ที่แนะนำ

• contextWindow: ใช้ขนาดหน้าต่างบริบทที่โมเดลรองรับจริง
• maxTokens: ใช้ความยาวเอาต์พุตสูงสุดที่โมเดลรองรับจริง
• หากใช้แพลตฟอร์มตัวกลาง ให้ตรวจสอบ ขีดจำกัดที่แพลตฟอร์มตัวกลางอนุญาตจริง ไม่ใช่อ้างอิงเฉพาะขีดจำกัดที่ผู้ให้บริการต้นทางโฆษณาไว้

ตัวอย่าง MiniMax-M2.5

ตัวอย่างอย่างเป็นทางการของ OpenClaw แนะนำ:

"contextWindow": 196608,
"maxTokens": 8192

5. สิ่งที่ต้องทำหลังแก้ไขการกำหนดค่า

บันทึกการกำหนดค่า แล้วรีสตาร์ต OpenClaw หรือโปรเซสเกตเวย์ที่เกี่ยวข้อง

คำสั่งที่ใช้บ่อย ได้แก่:

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

เอกสารอย่างเป็นทางการยังระบุคำสั่งทั้งสองนี้ไว้สำหรับตรวจสอบและสลับโมเดล

หากใช้งาน OpenClaw ในรูปแบบบริการ ให้รีสตาร์ตบริการที่เกี่ยวข้องด้วย เช่น:

openclaw gateway restart

หรือรีสตาร์ตบริการ systemd โปรเซส pm2 หรือคอนเทนเนอร์ Docker ของคุณ

6. หมายเหตุเพิ่มเติม

เอกสารอ้างอิงการกำหนดค่าอย่างเป็นทางการของ OpenClaw ยังระบุว่า:

• สามารถกำหนดผู้ให้บริการแบบกำหนดเองไว้ภายใต้ models.providers ได้โดยตรง
• สามารถตั้งค่า contextWindow และ maxTokens อย่างชัดเจนได้
• สำหรับโมเดลที่ตรงกัน OpenClaw จะเลือกใช้ค่าที่สูงกว่าระหว่างการกำหนดค่าแบบระบุชัดเจนกับ catalog ภายใน
• หากต้องการแทนที่ models.json ด้วยการกำหนดค่าของคุณเองทั้งหมด ให้ใช้ models.mode: "replace"

เอกสารอย่างเป็นทางการฉบับปัจจุบันยังระบุว่า หากละเว้นฟิลด์เหล่านี้สำหรับผู้ให้บริการแบบกำหนดเอง ค่าเริ่มต้นคือ contextWindow: 200000 และ maxTokens: 8192 ดังนั้นหากลูกค้ายังคงพบค่า 16k หรือ 4k ก็ไม่ได้หมายความว่าปัจจุบัน OpenClaw กำหนดค่าเริ่มต้นไว้เพียง 16k แต่มีแนวโน้มว่า การกำหนดค่าโมเดลในเครื่องถูกตั้งไว้ต่ำเกินไปด้วยตนเอง หรือยังมีการกำหนดค่าเก่าหลงเหลืออยู่