Решение проблемы контекстного окна 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 в каталоге агента. При сопоставлении моделей для contextWindow / maxTokens выбирается большее значение из конфигурации и встроенного каталога.

На изображении показана вкладка «Settings» страницы конфигурации OpenCla…

Настройка контекста в OpenClaw

I. Проявление проблемы

Если при подключении пользовательской или сторонней прокси-модели в OpenClaw указать в её конфигурации слишком маленькое контекстное окно, например:

"contextWindow": 16000,
"maxTokens": 4096

могут возникнуть следующие проблемы:

• сбои в длинных диалогах
• более частые ошибки при вызове инструментов
• сообщение API rate limit reached на странице
• OpenClaw использует меньшее значение, хотя модель поддерживает более широкий контекст

В официальной документации OpenClaw указано, что contextWindow и maxTokens модели можно задать явно в конфигурации. Основной конфигурационный файл расположен по пути ~/.openclaw/openclaw.json; отдельные настройки также можно переопределить с помощью models.json в каталоге агента.

II. Расположение конфигурационных файлов

1) Путь к основному конфигурационному файлу

Основной конфигурационный файл OpenClaw по умолчанию:

~/.openclaw/openclaw.json

Это прямо указано в официальной документации.

2) Путь к конфигурации модели агента

Если модель настраивается отдельно для каждого агента, обычно используется следующий путь:

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

В официальной документации указано, что пользовательского провайдера можно добавить в models.providers или прописать в ~/.openclaw/agents/<agentId>/agent/models.json.

3) Если корневой каталог пользовательского агента был изменён

Если задана переменная окружения:

OPENCLAW_AGENT_DIR

она переопределяет каталог конфигурации агента. В официальной документации также указано, что корневой каталог конфигурации агента можно изменить через OPENCLAW_AGENT_DIR (или PI_CODING_AGENT_DIR).

III. Как изменить настройки

Вариант 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 для MiniMax-M2.5 указаны именно contextWindow: 196608 и maxTokens: 8192.

Вариант B: изменить файл в каталоге агента

models.json

Откройте:

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

Замените для соответствующей модели:

"contextWindow": 16000,
"maxTokens": 4096

на более подходящие значения, например:

"contextWindow": 196608,
"maxTokens": 8192

IV. Какие значения указывать

Не задавайте их произвольно. Нельзя просто написать 1000000, потому что вам хочется контекст 1M: вселенная устроена иначе.

Рекомендуемые принципы

• contextWindow: укажите фактически поддерживаемое моделью значение
• maxTokens: укажите фактический максимальный объём вывода модели
• при использовании прокси-платформы учитывайте реальный лимит, разрешённый прокси, а не только заявленные производителем характеристики

Пример MiniMax-M2.5

Официальный пример OpenClaw рекомендует:

"contextWindow": 196608,
"maxTokens": 8192

V. Что делать после изменения

После сохранения конфигурации перезапустите OpenClaw или соответствующий процесс gateway.

Часто используемые команды:

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

В официальной документации эти две команды также приведены для проверки и переключения моделей.

Если OpenClaw запущен как служба, необходимо перезапустить соответствующую службу, например:

openclaw gateway restart

либо перезапустить собственный контейнер systemd / pm2 / docker.

VI. Дополнительные сведения

В официальном справочнике по конфигурации OpenClaw также указано:

• пользовательского провайдера можно прописать непосредственно в models.providers
• contextWindow / maxTokens можно задать явно
• при сопоставлении моделей выбирается большее значение между явной конфигурацией и встроенным каталогом
• чтобы полностью заменить models.json собственной конфигурацией, можно использовать models.mode: "replace".

Кроме того, сейчас в официальной документации указано: если для пользовательских провайдеров эти поля не заданы, по умолчанию используются contextWindow: 200000 и maxTokens: 8192. Поэтому если у клиента по-прежнему 16k или 4k, причина, скорее всего, не в том, что «OpenClaw сейчас по умолчанию поддерживает только 16k», а в том, что в локальной конфигурации модели вручную установлено меньшее значение либо сохранилась старая конфигурация.