ClawTrace

Что такое ClawTrace?

ClawTrace обеспечивает observability для агентов OpenClaw. Он помогает понять, что произошло во время запусков агента — что провалилось, где выросли затраты и что изменить дальше, — чтобы повысить надежность и снизить расходы.

Продукт сочетает обзоры на уровне запусков и детальные трассировки вызовов LLM, использования инструментов и делегирования подагентам. Также включает «Tracy» — интерактивного агента, который анализирует live-данные запусков и дает контекстные рекомендации.

Ключевые возможности

• Интерактивная трассировка выполнения (дерево трассировок с payloads): Осматривайте каждый вызов LLM, использование инструментов и делегирование подагентам в запуске, чтобы точно найти, где возникли проблемы.
• Видимость затрат по запускам и шагам: Видьте, как меняются расходы в запуске агента, и детализируйте всплески затрат по шагам, чтобы выявить утечки бюджета.
• Диагностика сбоев и выявление вероятных root cause: Трассируйте нестабильное поведение и выделяйте вероятные причины вместе с предложенными действиями для улучшения.
• Маппинг связей на уровне графа (call graph): Визуализируйте, как связаны агенты, инструменты и модели по всей траектории.
• Вью таймлайна с bottleneck и параллелизмом: Используйте таймлайн в стиле Gantt для выявления bottleneck и понимания параллелизма по шагам.
• Дашборды траекторий для мониторинга: Просматривайте все траектории с метриками, ежедневными трендами, использованием токенов и drilldown по запускам.
• Агент-«доктор» «Tracy» для guided анализа: Спрашивайте, почему провалился запуск, где bottleneck или как снизить затраты; Tracy адаптируется к просмотренной странице/контексту.
• Ответы на live-данных: Ответы генерируются из live-данных, а не из устаревших дашбордов или отложенной отчетности.
• Follow-up в разговоре: Tracy помнит разговор и может углубиться с последующими вопросами.

Как использовать ClawTrace

1. Установите плагин ClawTrace на агента OpenClaw: openclaw plugins install @epsilla/clawtrace.
2. Аутентифицируйтесь с помощью observe key: openclaw clawtrace setup.
3. Перезапустите gateway: openclaw gateway restart.
4. Запускайте агента как обычно: траектории стримятся в ClawTrace автоматически, где можно инспектировать трассировки, spans, токены и затраты в реальном времени.
5. Используйте Tracy для диагностики и рекомендаций: Задавайте вопросы о сбоях, bottleneck или снижении затрат, затем уточняйте анализ follow-up.

Кейсы использования

• Отладка нестабильного агента OpenClaw: Когда поведение становится непредсказуемым, используйте трассировки выполнения и навигацию по дереву трассировок, чтобы найти вероятный root cause и просмотреть действия для повышения надежности.
• Расследование всплеска затрат: Если затраты растут неожиданно, инспектируйте расходы по запускам и шагам агента, чтобы выявить шаги, вызывающие рост использования токенов или расходов.
• Устранение неэффективных циклов: Когда агенты зацикливаются, используйте таймлайн и call graph, чтобы найти, где застревает прогресс, и что скорректировать в траектории.
• Сравнение улучшений после изменений: Используйте Tracy для оценки запуска после изменений, таких как переход на дешевые модели при возможности или скриптинг повторяемых шагов для стабильности запусков.
• Операционный мониторинг по множеству траекторий: Используйте дашборд траекторий для обзора ежедневных трендов, использования токенов и drilldown по запускам, чтобы ловить recurring проблемы по деплоям.

FAQ

• ClawTrace работает с агентами OpenClaw? Да. Сайт описывает ClawTrace специально как «observability для агентов OpenClaw», включая устанавливаемый плагин и стриминг траекторий.

• Что анализирует Tracy? Tracy анализирует контекст запуска/траектории, который вы просматриваете, и отвечает на вопросы, почему провалился запуск, где bottleneck и как снизить затраты. Использует live-данные.

• Как отображаются трассировки и детали затрат в ClawTrace? ClawTrace предоставляет интерактивное дерево трассировок с payloads для вызовов LLM, использования инструментов и делегирования подагентам, плюс вью для расходов по запускам и шагам агента.

• Нужно ли настраивать интеграцию перед использованием? Да. Базовый workflow — установка плагина, аутентификация с observe key и перезапуск gateway OpenClaw.

• Как данные остаются актуальными? Сайт указывает, что ответы Tracy приходят из live-данных, без устаревших дашбордов или отложенных отчетов.

Альтернативы

• Универсальные инструменты observability/telemetry для LLM: Они предоставляют логи, трейсы и метрики токенов/стоимости для вызовов LLM, но могут не предлагать специфичные для OpenClaw представления траекторий, такие как связи графа вызовов и диагностику в стиле Tracy.
• Open-source фреймворки трассировки для LLM-воркфлоу: Если у вас уже есть пайплайн трассировки, вы можете создать кастомные дашборды и отладочные представления для шагов агента и вызовов инструментов, но потеряете готовый воркфлоу «провал запуска → вероятная причина → следующие исправления».
• Дашборды мониторинга и аналитики воркфлоу: Для команд, сосредоточенных на операционных метриках (задержки, пропускная способность, уровень ошибок), аналитические инструменты помогают выявлять проблемы, но могут не предоставлять трейсы выполнения на уровне шагов с видимостью payload и интерактивным drilldown траекторий.