Clawd-Docs v2.0 — Smart Documentation Access

Clawd-Docs v2.0 — умный доступ к документации

Этот навык предоставляет интеллектуальный доступ к документации ClawdBot, используя многоуровневую систему поиска и кэширования для повышения эффективности и снижения затрат.

В основе лежат три ключевых механизма:

• Локальный поисковый индекс — мгновенный поиск по ключевым словам (0 токенов)
• Кэшированные сниппеты — заранее подготовленные ответы на популярные вопросы (~300–500 токенов)
• Получение по запросу — загрузка полной страницы при необходимости (~8–12k токенов)
• Отслеживание актуальности — TTL для разных типов страниц

Такой подход позволяет обслуживать до 80–90% запросов без обращения к сети, значительно снижая расход токенов и ускоряя работу. :

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

Шаг 1: Сначала проверьте Golden Snippets

Перед тем как выполнять любые сетевые запросы, проверьте наличие готовых сниппетов:

ls ~/clawd/data/docs-snippets/

Доступные сниппеты (всегда проверяйте кэш в первую очередь):

• telegram-setup.md — настройка Telegram
• telegram-allowfrom.md — контроль доступа
• oauth-troubleshoot.md — ошибки OAuth и токенов
• update-procedure.md — обновление ClawdBot
• restart-gateway.md — перезапуск шлюза
• config-basics.md — базовая конфигурация
• config-providers.md — подключение провайдеров
• memory-search.md — память и векторный поиск

Чтобы прочитать сниппет:

cat ~/clawd/data/docs-snippets/telegram-setup.md

Шаг 2: Используйте поисковый индекс

Если нужного сниппета нет, проверьте индекс:

~/clawd/data/docs-index.json

Примеры сопоставления ключевых слов:

• «telegram» → channels/telegram
• «oauth» → concepts/oauth, gateway/troubleshooting
• «update» → install/updating
• «config» → gateway/configuration

Шаг 3: Проверьте кэш полной страницы

Перед загрузкой страницы убедитесь, что она уже не сохранена локально:

ls ~/clawd/data/docs-cache/ | grep "concepts_memory"

Если файл найден — откройте его напрямую (без затрат токенов).

Шаг 4: Загрузка страницы при необходимости

Если данных нет в кэше, используйте встроенный инструмент:

web_fetch({
 url: "https://docs.clawd.bot/{path}",
 extractMode: "markdown"
})

Пример:

web_fetch({
 url: "https://docs.clawd.bot/tools/skills",
 extractMode: "markdown"
})

Преимущества web_fetch:

• Стоимость: $0 (бесплатно)
• Скорость: ~400 мс
• Формат: чистый Markdown

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

Система использует трёхуровневую архитектуру:

• Сначала проверяются локальные сниппеты
• Затем используется индекс для поиска нужной страницы
• И только при необходимости выполняется загрузка из сети

Такой подход минимизирует задержки и делает доступ к документации максимально быстрым и экономичным.

Итог

Clawd-Docs v2.0 — это оптимизированный способ работы с документацией, который сочетает скорость локального поиска и гибкость динамической загрузки. Основной принцип прост: сначала кэш, затем поиск, и только потом сеть.

Именно это делает систему эффективной, масштабируемой и практически бесплатной для большинства сценариев использования. :