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 |
| Сбоит только одна модель | Проблема маршрутизации модели или её параметров | С тем же Key и Base URL отправить минимальный запрос через другую модель |
OpenClaw На изображении показано расположение поля Model Window на стран…
Что обозначают три поля
contextWindow: метаданные о нативном окне контекста модели.contextTokens: OpenClaw фактический предел входных данных, разрешённый для использования; может быть меньше нативного окна.maxTokens: максимальный предел выходных токенов одного ответа, а не общий размер контекста.
Не вводите произвольные 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"]
}
]
}
}
}
}Оставляйте часть окна под системный промпт, результаты инструментов и вывод модели. Если вышестоящий сервис допускает только меньший вход или выход, продолжайте уменьшать значения — нельзя просто подставлять рекламируемые производителем цифры.
Порядок изменения и проверки
- Создайте резервную копию текущего файла конфигурации и не перезаписывайте единственную копию напрямую.
- Изменяйте только текущую запись provider и модели, остальную конфигурацию сохраните.
- Выполните
openclaw models listи убедитесь, что модель распознана. - Выполните
openclaw models set guishu/YOUR_MODEL_IDи убедитесь, что выбран правильный provider/model. - Перезапустите шлюз:
openclaw gateway restart. - Сначала отправьте очень короткий тестовый запрос, затем постепенно увеличивайте контекст.
Если короткий запрос тоже возвращает 429, дальнейшее увеличение окна контекста не поможет — переходите к проверке конкурентности, квоты аккаунта и состояния вышестоящего сервиса. Если сбоят только длинные запросы, проверяйте длину входных данных, стратегию сжатия и три поля контекста.
Скриншоты конфигурации и логи могут содержать API Key. Перед отправкой в поддержку закройте полный Key, оставляя только время ошибки, код состояния, ID модели и ID запроса.