Giải pháp cửa sổ ngữ cảnh 16k của Longxia

Giải pháp cửa sổ ngữ cảnh 16k của Longxia

Kích thước cửa sổ ngữ cảnh của model trong OpenClaw không cố định là 16k, chủ yếu phụ thuộc vào cấu hình cục bộ. Hãy kiểm tra ~/.openclaw/openclaw.json hoặc ~/.openclaw/agents/<agentId>/agent/models.json, rồi sửa contextWindow và maxTokens của model tương ứng thành giá trị model thực tế hỗ trợ. Lấy MiniMax-M2.5 làm ví dụ, có thể đổi thành contextWindow: 196608 và maxTokens: 8192. Sau khi sửa, chỉ cần khởi động lại OpenClaw. Tài liệu tham khảo cấu hình chính thức và ví dụ MiniMax đều hỗ trợ cách viết này.

Về bản chất, tình huống này là: trong provider tùy chỉnh / model tùy chỉnh đã ghi contextWindow thành 16000 (thậm chí thấp hơn), trong khi cửa sổ ngữ cảnh thực tế của OpenClaw phụ thuộc rất nhiều vào cấu hình; nếu model thực sự hỗ trợ ngữ cảnh lớn hơn thì nên tăng giá trị này lên, nếu không rất dễ gặp các vấn đề như API rate limit reached, ngữ cảnh không đủ, hoặc hội thoại dài bị lỗi thất thường. Tài liệu cấu hình chính thức nêu rõ tệp cấu hình chính của OpenClaw là ~/.openclaw/openclaw.json, đồng thời cũng hỗ trợ đặt riêng models.json trong thư mục agent; khi khớp model, contextWindow / maxTokens sẽ lấy giá trị lớn hơn giữa cấu hình và catalog ngầm định.

Hình ảnh hiển thị thẻ “Settings” trong trang cấu hình OpenClaw. Ở thanh…

Hướng dẫn sửa cấu hình ngữ cảnh trong OpenClaw

1. Hiện tượng vấn đề

Nếu khi kết nối model tùy chỉnh hoặc model chuyển tiếp bên thứ ba vào OpenClaw mà cửa sổ ngữ cảnh trong cấu hình model bị đặt quá nhỏ, ví dụ:

"contextWindow": 16000,
"maxTokens": 4096

thì có thể xuất hiện các vấn đề sau:

• Hội thoại dài dễ thất bại
• Khi gọi công cụ dễ báo lỗi hơn
• Trên trang hiển thị API rate limit reached
• Model rõ ràng hỗ trợ ngữ cảnh lớn hơn, nhưng OpenClaw vẫn xử lý theo giá trị nhỏ hơn

Tài liệu chính thức của OpenClaw cho biết contextWindow và maxTokens của model có thể được đặt tường minh trong cấu hình; đường dẫn tệp cấu hình chính là ~/.openclaw/openclaw.json, đồng thời cũng có thể dùng models.json trong thư mục agent để ghi đè riêng.

2. Vị trí tệp cấu hình

1) Đường dẫn tệp cấu hình chính

Tệp cấu hình chính mặc định của OpenClaw:

~/.openclaw/openclaw.json

Tài liệu chính thức đã nêu rõ điểm này.

2) Đường dẫn cấu hình model của Agent

Nếu cấu hình model riêng theo agent, đường dẫn thường là:

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

Tài liệu chính thức ghi rõ: provider tùy chỉnh có thể thêm vào models.providers, hoặc viết trong ~/.openclaw/agents/<agentId>/agent/models.json.

3) Nếu đã thay đổi thư mục gốc Agent tùy chỉnh

Nếu đã đặt biến môi trường:

OPENCLAW_AGENT_DIR

thì thư mục cấu hình agent sẽ bị biến môi trường này ghi đè. Tài liệu chính thức cũng nêu có thể dùng OPENCLAW_AGENT_DIR (hoặc PI_CODING_AGENT_DIR) để thay đổi thư mục gốc cấu hình agent.

3. Cách sửa

Phương án A: sửa cấu hình chính

openclaw.json

Mở:

~/.openclaw/openclaw.json

Tìm cấu hình tương ứng với nhà cung cấp model hiện tại của bạn, ví dụ:

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

Trong ví dụ MiniMax chính thức, cấu hình cho MiniMax-M2.5 chính là contextWindow: 196608 và maxTokens: 8192.

Phương án B: sửa trong agent

models.json

Mở:

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

Đổi trong model tương ứng từ:

"contextWindow": 16000,
"maxTokens": 4096

thành giá trị hợp lý hơn, ví dụ:

"contextWindow": 196608,
"maxTokens": 8192

4. Nên điền thế nào

Phần này không nên điền bừa, đừng kiểu “tôi muốn nó có ngữ cảnh 1M nên ghi luôn 1000000”, thực tế không vận hành như vậy.

Nguyên tắc khuyến nghị

• contextWindow: điền theo giá trị model thực sự hỗ trợ
• maxTokens: điền theo giới hạn đầu ra tối đa thực sự của model
• Nếu bạn đang dùng nền tảng trung chuyển, cần xem giới hạn thực tế mà bên trung chuyển cho phép, không chỉ nhìn vào thông số quảng bá của hãng gốc

Lấy MiniMax-M2.5 làm ví dụ

Ví dụ chính thức của OpenClaw khuyến nghị:

"contextWindow": 196608,
"maxTokens": 8192

5. Sau khi sửa cần làm gì

Sau khi lưu cấu hình, hãy khởi động lại OpenClaw hoặc tiến trình gateway tương ứng.

Các lệnh thường dùng:

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

Tài liệu chính thức cũng cung cấp hai lệnh này để kiểm tra và chuyển model.

Nếu bạn đang chạy theo dạng dịch vụ, còn cần khởi động lại dịch vụ tương ứng, ví dụ:

openclaw gateway restart

hoặc khởi động lại container systemd / pm2 / docker của riêng bạn.

6. Giải thích bổ sung

Tài liệu tham khảo cấu hình chính thức của OpenClaw còn nhắc tới:

• Provider tùy chỉnh có thể viết trực tiếp vào models.providers
• contextWindow / maxTokens hỗ trợ cấu hình tường minh
• Khi khớp model, sẽ lấy giá trị lớn hơn giữa cấu hình tường minh và catalog ngầm định
• Nếu muốn dùng hoàn toàn cấu hình riêng của bạn để ghi đè models.json, có thể dùng models.mode: "replace"

Ngoài ra, tài liệu chính thức hiện ghi rằng: đối với custom providers, nếu bỏ qua các trường này thì mặc định sẽ dùng contextWindow: 200000 và maxTokens: 8192. Vì vậy nếu phía khách hàng vẫn đang là 16k hoặc 4k thì phần lớn không phải do “mặc định hiện tại của OpenClaw chỉ hỗ trợ 16k”, mà là cấu hình model cục bộ của họ đã bị chỉnh tay xuống nhỏ hơn, hoặc còn sót cấu hình cũ.