2026 OpenClaw контекст репозитория и Skills
AGENTS.md, bootstrap-инъекция и чеклист настройки memory_search

Около 24 минут чтения · MACCOME

Команды, у которых уже работает Gateway, упираются не в то, что «модель спит», а в то, что AGENTS.md, Skills и bootstrap-инъекция раздувают контекст, а memory_search и ежедневные memory/*.md смешиваются непредсказуемо—сложно понять, какой слой сжигает бюджет. Статья даёт шесть инженерных точек трения, матрицу promptMode и bootstrap, три метрики контекста, согласуемые с логами, минимальный образец AGENTS.md и шестишаговый runbook настройки. Читайте вместе с руководством по установке на несколько платформ, разбором doctor после установки, маршрутизацией провайдера и отказоустойчивостью, разбором сети Docker и настройкой каналов—там не запускается и не подключается; здесь работает, но контекст не под контролем.

Шесть способов, как «агент репозитория» сходит с рельсов за две недели

OpenClaw в 2026 году обычно при старте внедряет пакет файлов репозитория (например AGENTS.md, Skills, границы идентичности и инструментов) и делит память на bootstrap и поиск по требованию. Без договорённости о том, что относится к bootstrap, а что к memory_search, каждый ход несёт огромный статический префикс, длиннее цепочки инструментов, растут стоимость и задержка. Отслеживайте шесть пунктов ниже рядом с еженедельными оценками токенов, долей сбоев инструментов и средним числом ходов.

  1. AGENTS.md не перестаёт расти: история продукта, дорожные карты и операционные руководства в одном файле инжектируются при bootstrap и облагают каждый ход; разделите «всегда нужно» и «получить по запросу».
  2. В папке Skills нет стратегии индексации: пересекающиеся Skills заставляют модели колебаться между инструментами; поддерживайте гранулярность Skill и примечания о взаимном исключении.
  3. promptMode вечно full: субагенты и пакетные задачи всё ещё несут максимальный системный промпт; переводите подходящие нагрузки на minimal или none по документации.
  4. Файлы memory как база данных: вставка огромных логов в memory/*.md и сканирование через memory_search повышает IO и стоимость эмбеддингов; краткие выводы в репозитории, сырой текст снаружи.
  5. Путаница контекста с маршрутизацией провайдера: при взрыве контекста команды сначала меняют модели; сначала ужмите bootstrap и циклы инструментов, затем используйте статью про провайдера для failover.
  6. Общие репозитории без полей владения: кто правит AGENTS, кто одобряет PR по Skills, кто подрезает memory—без ответов ноутбуки и удалённые Mac расходятся.

Согласуйте эти шесть пунктов с разделением в статье про Docker между здоровым Gateway и сбоями на уровне модели, чтобы быстрее видеть проблему политики контекста или сети/провайдера.

Матрица: promptMode, bootstrap и memory по требованию

Используйте таблицу на ревью: цель — предсказуемый потолок токенов на форму задачи, а не красивый текст. Точные ключи зависят от версии OpenClaw.

ИзмерениеBootstrap (старт)memory_search / memory_get (по требованию)
Типичное содержимоеAGENTS.md, краткие сводки Skills, идентичность и границы инструментовДатированные заметки, журналы решений, длинные приложения
Вид при сбоеКаждый ход медленный, дорогой, шумный префиксПропуски попаданий, слишком широкие попадания, повторные чтения
Рычаги настройкиСуммарный потолок символов, поэтапная инъекция, promptModeГранулярность индекса, именование, политика суммаризации
promptModefull внедряет больше всего; minimal подходит субагентам, которые могут опускать разделыНе заменяет bootstrap; не прячьте критические границы только в memory
Совместная работаНужны код-ревью и версионированиеНужны поля аудита (автор, срок действия)
Удалённый MacБольшие клоны в облаке—следите за задержкой синхронизации и правамиЧастые записи могут гоняться с ноутбуками

Три метрики контекста для панели Grafana или заметки дежурного

Собирайте из логов и грубых оценок токенов; числа — заглушки, замените своими базовыми значениями.

  1. Bootstrap Effective Load (BEL): эквивалентный вес символов статических префиксов до первого пользовательского сообщения в сессии; если BEL держится выше порога, разбивайте файлы и ужимайте потолки вроде agents.defaults.bootstrapTotalMaxChars (имя меняется по релизам—следуйте официальной документации).
  2. Tool Loop Index (TLI): подряд идущие вызовы инструментов без прогресса в одной задаче; рост TLI обычно сигнализирует о неясных Skills или шумном контексте, а не о HTTP 429.
  3. Memory Retrieval Hit Rate (MRH): доля результатов memory_search, которые модель реально использует (выборочная проверка или подтверждение). Низкий MRH — долг по индексу или сводкам; высокий MRH при высоком BEL часто означает дублирование содержимого.

Мультимодельная маршрутизация и динамическая оценка контекста будут развиваться в 2025–2026 годах, но шум со стороны репозитория по-прежнему ограничивает качество—держите BEL, TLI и MRH на доске.

Для нетехнических коллег BEL похож на «страницы из справочника сотрудника, которые перечитывают перед каждым разговором», а TLI — на «сколько раз один и тот же вопрос эскалируется без прогресса»; увеличение модели без исправления этого лишь печатает ту же толстую брошюру на более дорогой бумаге.

markdown
# AGENTS.md (example: only eternal boundaries; details live in Skills or memory)
## Repository role
- This repo is the xxx service; default branch main; release cadence in docs/release.md.

## Tooling boundaries
- Do not change CI secrets or production configs without review; DB migrations need two-person sign-off.

## OpenClaw conventions
- Skills directory: .openclaw/skills/ (example—use your layout)
- Long decisions: memory/YYYY-MM-decisions.md with a one-line summary at the top.
warning

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

Шестишаговый runbook: от «запускается» к «можем сопровождать»

  1. Зафиксировать версии и документы: записать версии OpenClaw и Gateway; открыть апстрим-доки по системному промпту, bootstrap и memory—не опираться на слухи.
  2. Инвентаризация источников инъекции: перечислить bootstrap-файлы и Skills, пометить обязательное, опциональное или перенос в memory.
  3. Задать потолок BEL: согласовать жёсткий предел и откат; при перерасходе бюджета сначала убирать повторы, а не добавлять модели.
  4. Откалибровать promptMode: перевести субагентов и пакеты на minimal или эквивалент и логировать задержку, успех и стоимость до и после.
  5. Нормализовать memory: длинный текст превратить в сводку и указатель; сырые логи архивировать в холодное хранилище вне горячего пути поиска.
  6. Слойная ревью с провайдером и Docker: если TLI остаётся высоким, переходить к статьям про провайдера и Docker—не расширять пул моделей, пока контекст не очищен.

Gateway, модели и контекст репозитория: порядок причинности

Прерывистые таймауты соблазняют менять модели или добавлять GPU; без BEL и TLI вы смешиваете шумные промпты и нестабильную инфраструктуру. Как в статье про Docker: сначала Gateway и каналы, затем провайдер, затем промпты репозитория—тот же слоёный разбор, что и в статье про каналы, с бюджетом контекста наверху.

Добавьте к каждому инциденту минимальный набор из четырёх полей для воспроизведения: (1) активный promptMode и диапазон BEL, (2) ссылка на последний merge request по AGENTS/Skills, (3) запрос memory_search и число попаданий, (4) фрагменты логов Gateway рядом с вызовами инструментов. С этими четырьмя полями большинство «таинственных замедлений» снимается меньше чем за тридцать минут. Для субагентов или параллельных задач логируйте потолки по веткам в той же тетради—агрегаты только по основной сессии вводят в заблуждение.

Почему «у меня на ноутбуке работало» не масштабируется на команду

На личных машинах гигантские промпты и случайные секреты смешаны в глобальной конфигурации—сложно аудировать. Переход в CI или на общие удалённые Mac добавляет права и задержку синхронизации, поэтому AGENTS и memory расходятся незаметно. Явная политика контекста вместе с выделенными удалёнными средами превращает агентные процессы в проверяемые и передаваемые активы.

Эфемерные облачные десктопы могут запускать OpenClaw, но долгий аптайм, фиксированные пути и низкий дрейф toolchain выгоднее на выделенных физических удалённых Mac—особенно если Gateway делит хост или регион с крупным монорепозиторием, а IO диска становится узким местом вместе с контекстом. MACCOME эксплуатирует узлы Mac mini M4 и M4 Pro в Сингапуре, Японии, Корее, Гонконге и на побережьях США с гибкими условиями аренды для постоянно включённого Gateway и больших клонов; согласуйте публичные страницы тарифов со строкой BEL, зафиксируйте политику каталогов, затем итерируйте Skills.

Пилот: неделю держите BEL в целевом диапазоне команды перед покупкой более крупных моделей или каналов—крупные модели редко устраняют шум репозитория.

Вопросы и ответы

С какой статьи начать при проблемах установки?

Сначала руководство по установке на несколько платформ, затем разбор doctor; в этой статье не повторяются проверки портов и зависимостей.

Где темы сети и моделей?

См. разбор сети Docker для доступности из CLI и маршрутизацию провайдера для цепочек моделей.

Тарифы аренды и помощь?

Откройте тарифы аренды Mac mini и центр помощи.