2026_OPENCLAW
MCP_SKILLS_
GATEWAY_
TOKEN_RUNBOOK.

После MCP и кастомных Skills контекст забивают описания инструментов, а шлюз держит устаревший снимок. Разбираем приоритет путей, перезагрузку Gateway, бюджет токенов схем, OAuth/PATH под launchd и чеклист для 24/7 на удалённом Mac с Metal. См. onboard и шлюз, Docker прод, ошибки.

Инструменты разработчика

1. Суть проблемы: MCP и Skills — не «два файла»

(1) Непрозрачный порядок загрузки: без ясного приоритета между /skills в workspace, пользовательскими каталогами и встроенными Skills вы правите диск, а агент читает старую копию.(2) Снимки Gateway в памяти: в ряде сборок метаданные навыков остаются в RAM; неполный перезапуск скрывает изменения на диске.(3) Объём схем MCP: несколько серверов разом вставляют огромные описания инструментов и заполняют окна 16k–32k до пользовательского текста.(4) PATH демона: задания launchd наследуют урезанный PATH, шимы nvm/fnm из login-shell исчезают. На удалённом Mac 24/7 это сложнее заметить без параллельно открытого терминала.

2. Приоритет каталогов Skills

Поставщики могут менять строки путей между релизами. Таблица отражает обычную логику «верх перекрывает низ». Всегда сверяйте абсолютные пути с документацией вашей версии и логами Gateway.

Слой (высокий→низкий)НазначениеПроверка
Workspace /skills или skills внутри репозиторияКомандные сценарии, автоматизация проектаcwd шлюза совпадает с ожидаемым workspace
Пользовательские skillsЛичные экспериментыОшибка отступа YAML может полностью проигнорировать файл
Встроенные по умолчаниюБазовые возможности продуктаПосле обновления читать changelog

3. MCP: минимальный замкнутый контур и бюджет токенов

Сначала подключите ровно один MCP-сервер: аутентификация, health-check и минимальный вызов инструмента. Затем добавляйте остальные, измеряя длину сериализованных определений. Когда system+tools приближается к потолку, сужайте профили по каналам, переносите инструменты в субагенты или меняйте модель—вместо наращивания серверов и обвинения «слабой» модели.

4. Пятиступенчатая проверка

Шаг 1: зафиксировать в логах корень workspace и диапазон сканирования Skills.Шаг 2: вставить заметную строку в один SKILL, полностью перезапустить Gateway, убедиться, что агент её цитирует.Шаг 3: отключить все MCP, включить один, снять базовую метрику токенов tools, затем включать по одному.Шаг 4: через launchctl print сравнить окружение демона и интерактивную оболочку.Шаг 5: в staging принудительно истечь OAuth и проверить, громко или тихо падает ошибка.

# Пример health (порт подставьте свой) curl -sS http://127.0.0.1:18789/health 2>/dev/null || echo "adjust-endpoint"

5. Матрица симптомов после перезапуска

СимптомВероятная причинаДействие
Правки SKILL не видныПобеждает другой каталогЛогировать путь поиска; grep уникальной метки
Число инструментов «плавает»MCP падает без шумаПовысить debug; включать серверы по одному
Инструмент пропадает эпизодическиИстёк токен / сломан refresh в демонеПовторная авторизация; refresh в том же окружении, что Gateway
Контекст полон при коротком запросеСтопка крупных схемУрезать MCP; дробить сессии; сменить модель

Ориентиры (эксплуатация, не маркетинг):

  • На моделях класса 16k суммарно 10k+ токенов на нефильтрованные описания MCP — обычная картина.
  • Для постоянного хостинга прописывайте в plist абсолютные пути к интерпретаторам.
  • Каждый новый публичный канал (IM, webhook) требует повторного аудита доступных инструментов.

6. Углубление: управление инструментами — это прод-операции

MCP превращает интеграции в композируемую платформу, но одновременно раздувает потребление контекста и поверхность прав. В отличие от классических микросервисов, LLM может перепланировать инструменты каждый ход; если политические фильтры отстают от регистрации схем, вы платите дважды — токенами и риском. Mac на Apple Silicon хорошо держит тихий Gateway, однако unified memory чувствует многоканальные и длинные сессии: это не та же нагрузка, что «ещё пара вкладок», потому что определения инструментов долго висят на system-стороне промпта.

Оставляя быстрые итерации на ноутбуке, а боевой Gateway+MCP — на выделенной машине, вы разводите частоту изменений и радиус отказа. Ноутбук удобен для экспериментов, но смешивает сон, личные приложения и нестабильный uplink с SLA команды.

Когда стабильный uplink, гигиена демонов и круглосуточный надзор становятся узким местом, размещение OpenClaw на удалённых Mac-узлах MACGPU сохраняет стек macOS/Metal и делает PATH/uptime предсказуемее; почасовая оплата удобна для канареек до фиксированной мощности. Это инженерное решение по размещению для графики и постоянных AI-пайплайнов, а не рекламный тезис: выделенный удалённый узел обычно проще сопровождать, чем ежедневный ноутбук.