Context Manager Skill

Context Manager — это навык для OpenClaw, обеспечивающий интеллектуальное управление контекстом сессий с помощью ИИ. Он использует сам агент для генерации кратких и точных резюме, после чего «сжимает» текущую сессию, перезапуская её с обновлённым контекстом.

Быстрый старт

# Список всех сессий с использованием токенов
~/openclaw/skills/context-manager/compress.sh list

# Проверка статуса конкретной сессии
~/openclaw/skills/context-manager/compress.sh status agent:main:main

# Генерация AI-резюме (без изменений)
~/openclaw/skills/context-manager/compress.sh summarize agent:main:main

# Полное сжатие: резюме + сброс + внедрение (разрушающее действие)
~/openclaw/skills/context-manager/compress.sh summarize agent:main:main --replace

Когда использовать

• Когда использование контекста приближается к 70–80% и выше
• При длительных сессиях с большим объёмом диалога
• Если ответы начинают замедляться или теряют связность
• Проактивно — для поддержания скорости и точности работы агента

Как это работает

• AI-суммаризация: агент получает запрос на резюмирование собственного контекста
• Бэкап: исходный JSONL-файл сессии сохраняется в memory/compressed/
• Сброс: JSONL-файл удаляется (официальный способ сброса)
• Инжекция: сгенерированное резюме вставляется как первое сообщение новой сессии
• Результат: тот же ключ сессии, новый ID и значительно уменьшенный контекст

Ключевая идея: агент полностью «видит» свой контекст, поэтому способен создать максимально точное и полезное резюме.

Основные команды

Команды для работы с сессиями:

• list — список всех сессий с информацией об использовании
• status [KEY] — подробный статус выбранной сессии
• summarize [KEY] — генерация резюме (без изменений)
• summarize [KEY] --replace — резюме + сброс сессии
• compress [KEY] — устаревший метод (не рекомендуется)
• check [KEY] — проверка превышения порога
• check-all — проверка всех сессий

Настройки:

• set-threshold N — установить порог (50–99%, по умолчанию 80)
• set-depth LEVEL — уровень детализации: краткий / сбалансированный / полный
• set-quiet-hours HH — «тихие часы» (например, 23:00–07:00)
• help — справка и примеры

Пример результата

После выполнения полного сжатия:

• 70 000 токенов → 16 000 токенов
• Снижение объёма примерно на 77%
• Сессия продолжает работу без потери ключевого контекста

Файлы, создаваемые при сжатии

• {timestamp}.ai-summary.md — AI-резюме
• {timestamp}.session-backup.jsonl — полный бэкап
• {timestamp}.transcript.md — сырой транскрипт (устаревший)
• {timestamp}.summary.md — резюме через grep (устаревшее)

Как формируется резюме

Агенту предлагается структурировать информацию следующим образом:

• Что было сделано (ключевые задачи)
• Какие решения приняты (и почему)
• Текущее состояние
• Оставшиеся задачи
• Критически важный контекст

Устранение проблем

Резюме пустое:

openclaw agent --session-id $ID -m "..." --json 2>/dev/null

Сессия не сбрасывается:

ls ~/.openclaw/agents/main/sessions/

Восстановление из бэкапа:

cp memory/compressed/{timestamp}.session-backup.jsonl \
~/.openclaw/agents/main/sessions/{sessionId}.jsonl

Просмотр логов:

openclaw logs --limit 50 --json | grep -i "error\|fail"

Рекомендации

• Всегда проверяйте бэкап перед экспериментами
• Тестируйте на второстепенных сессиях
• Сначала запускайте summarize без --replace
• Контролируйте количество токенов через status

Требования

• Установленный openclaw (gateway должен быть запущен)
• jq для работы с JSON
• Доступ к агенту и сессиям OpenClaw