Коротко
- Рекомендованный список один для всех. Его вручную правят через проверяемые запросы на изменения в
scripts/lib/recommended-models.json. - Провайдер NVIDIA публикует собственную избранную ленту, которая идёт перед глобальными рекомендациями.
- В пикере сначала идут рекомендованные модели провайдера, остальные сворачиваются под All models.
- Каталог v1 не содержит рекомендаций, а записи deprecated, disabled и replaced с ними не совпадают.
Сверено с документацией OpenClaw 2026.10.5, 21 октября 2026.
OpenClaw хранит один глобальный рекомендованный список независимо от провайдера. При публикации каталога он сопоставляется с моделями, которые отдаёт провайдер.
Файл scripts/lib/recommended-models.json содержит только канонические id, от лучших к худшим. Оценок, провайдеров и комментариев в нём нет. Изменения проходят через проверяемые запросы на изменения; автоматические предложения — только отправная точка, источник истины — правка ревьюера.
Откуда берётся список и кто его правит
Сопровождающие OpenClaw ведут список вручную. Ориентир — оценка модели в Arena agent score. При равенстве и пропусках учитывается наблюдаемое использование, но ревьюер может передвинуть любую запись — человеческое решение важнее обоих сигналов.
Канонический id — нейтральное имя без вендора и префикса маршрута: claude-opus-5.5, а не anthropic/claude-opus-5.5. Версии записываются через точку: claude-opus-4.5, glm-5.3. Даты, ревизии и варианты обслуживания вроде -fp8, -free и -batch не добавляют.
Семейство определяют, удалив номер версии из id: gpt-5.6-luna и gpt-6-luna превращаются в gpt-luna; qwen3.8-27b сохраняет размер и превращается в qwen-27b. Публикация прекращается, если нормализация id изменяет запись, обнаружен дубль или список содержит больше 200 записей. Предыдущий размещённый каталог остаётся.
Более новая версия того же семейства считается преемником и занимает позицию предшественника сразу в день запуска. Пока хотя бы один провайдер отдаёт только предшественника, запись сохраняется. Новое семейство, например класс -mini или -pro, ревьюер выбирает вручную.
Варианты -fast, -highspeed и аналогичные сворачиваются в базовую модель. Запись удаляют после устаревания или снятия вендором либо когда каждый провайдер отдаёт преемника.
Чем отличается избранная лента провайдера
Сейчас избранную ленту публикует только NVIDIA. Её адрес: https://assets.ngc.nvidia.com/products/api-catalog/featured-models.json. Идентификаторы сопоставляются по каноническому id, поэтому z-ai/glm-5-3 совпадает с z-ai/glm-5.3.
В recommendedModels провайдера сначала идут избранные модели в порядке ленты и под его id. Затем идут совпадения из глобального списка, которых там ещё нет. Правило одной новейшей модели семейства сокращает только глобальную часть, поэтому избранная модель сохраняется даже при наличии более новой версии того же семейства.
Как каталог сопоставляет модели и что отсекается
При публикации размещённого каталога id моделей провайдера сверяются с рекомендованным списком. Устаревшие, отключённые и заменённые записи не совпадают. Если провайдер отдаёт несколько рекомендованных моделей одного семейства, остаётся только новейшая.
Совпадения попадают в recommendedModels провайдера в порядке глобального списка и под его id. Провайдеры без совпадений не получают рекомендаций; каталог v1 их не содержит.
Как посмотреть у себя
openclaw models list
openclaw models list --agent <agentId>
openclaw models status --json
openclaw models refreshВ пикере рекомендованные модели провайдера идут первыми. Остальные модели сворачиваются под All models.
Где ломается и когда не применять
- Каталог v1 не содержит
recommendedModelsдля провайдера. - Если лента провайдера недоступна, неверна, пуста или не совпадает с обслуживаемыми моделями, провайдер получает только глобальный список.
- Избранный id пропускается, если провайдер не отдаёт модель или отдаёт её только как deprecated, disabled или replaced. Случай записывается в журнал.