Bluebubbles

Bluebubbles — это навык OpenClaw, предназначенный для создания или обновления внешнего канального плагина BlueBubbles для Clawdbot. Он реализуется в виде расширения с поддержкой REST-запросов (отправка/проверка) и входящих webhook-событий.

Назначение навыка

Этот навык используется для работы с каналом BlueBubbles внутри экосистемы OpenClaw. Он помогает разработчикам интегрировать обмен сообщениями, обработку событий и взаимодействие с API BlueBubbles через плагин Clawdbot. :

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

• При разработке или обновлении плагина канала BlueBubbles
• При настройке внешнего коннектора для обмена сообщениями
• При работе с webhook-обработкой и REST-интеграцией

Установка

npx clawhub@latest install kevin19830331/bluebubbles

После установки необходимо изучить файл SKILL.md, чтобы понять условия активации и сценарии использования навыка.

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

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

Структура плагина

• Основной пакет: extensions/bluebubbles/
• Реализация канала: src/channel.ts
• Обработка webhook: src/monitor.ts
• REST-утилиты: src/send.ts и src/probe.ts
• Runtime-мост: src/runtime.ts
• Каталог для онбординга: catalog.ts

Внутренние функции

• probeBlueBubbles — проверка доступности сервера
• sendMessageBlueBubbles — отправка сообщений
• resolveChatGuidForTarget — поиск чата
• sendBlueBubblesReaction — реакции (tapbacks)
• sendBlueBubblesTyping — индикатор набора текста
• downloadBlueBubblesAttachment — загрузка вложений

Webhook и обработка событий

• BlueBubbles отправляет JSON-события на HTTP-сервер
• Необходимо нормализовать ID отправителя и чата
• Игнорируются сообщения, отправленные самим пользователем
• События передаются в основной pipeline через runtime API
• Для медиа используется формат

Конфигурация

• channels.bluebubbles.serverUrl — адрес сервера
• channels.bluebubbles.password — пароль API
• channels.bluebubbles.webhookPath — путь webhook
• channels.bluebubbles.actions.reactions — управление реакциями

Рекомендации и советы

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

Обработка ошибок

• Если подходящий раздел не найден — уточните задачу
• При ошибке установки проверьте сеть и права доступа
• Если функциональность отсутствует — используйте fallback-решение

В целом, Bluebubbles — это специализированный инструмент для интеграции канала сообщений BlueBubbles в OpenClaw, обеспечивающий гибкую работу с событиями, API и пользовательскими взаимодействиями в рамках агентной архитектуры. :