bluebubbles

Build and update the BlueBubbles external channel plugin for Clawdbot.

Updated Aug 13, 2025
One-click install
npx skills add https://github.com/JoeyJoziah/investment-analysis-platform --skill bluebubbles-joeyjoziah
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bluebubbles
Source: https://github.com/JoeyJoziah/investment-analysis-platform/tree/main/.claude/skills/bluebubbles
Command: npx skills add https://github.com/JoeyJoziah/investment-analysis-platform --skill bluebubbles-joeyjoziah

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you build or update the BlueBubbles external channel plugin for Clawdbot so message delivery, inbound webhooks, and runtime integration stay consistent and maintainable.

Core Features & Use Cases

  • Extension Packaging: Organize the BlueBubbles plugin entry point and channel modules in the expected extension layout.
  • Messaging Workflows: Implement sending, probing, reactions, typing indicators, and read receipts through the plugin's internal helper functions.
  • Webhook Handling: Normalize inbound webhook payloads, ignore self-sent messages, and route events into the core reply pipeline.
  • Media and Attachment Support: Handle attachments and stickers with placeholder text and media paths for inbound context.
  • Configuration and Onboarding: Wire the plugin into the catalog and respect the configured BlueBubbles server URL, password, webhook path, and action gating.
  • Use Case: A developer can use this Skill to add a new BlueBubbles deployment, repair webhook delivery, or update message actions without rewriting the surrounding Clawdbot integration.

Quick Start

Ask me to update the BlueBubbles plugin for your Clawdbot project, and I will adjust the channel, webhook, send, probe, runtime, and catalog integration in the expected locations.

Frequently Asked Questions about bluebubbles

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a messaging channel plugin for BlueBubbles?

To build a BlueBubbles messaging channel plugin, you organize the extension entry point and channel modules in the expected layout, then wire REST API plumbing for message delivery, probing, and typing indicators.

How do I handle inbound webhooks for a BlueBubbles integration?

Handling inbound BlueBubbles webhooks requires normalizing payload data, filtering self-sent messages, and routing events into the core reply pipeline. This Skill applies defensive ID normalization to process those events reliably.

What's the best way to add typing indicators and reactions to a messaging plugin?

Adding typing indicators and reactions to a messaging plugin involves calling internal helper functions mapped to the channel's REST API. This Skill implements those message actions using configuration-driven runtime bridging.

Does this BlueBubbles plugin support media attachments and stickers?

Yes, the BlueBubbles plugin supports media attachments and stickers by generating placeholder text and mapping media paths for inbound context. This ensures attachment data routes correctly through the Clawdbot reply pipeline.

What configuration do I need to start using the BlueBubbles REST API for message delivery?

You need a configured BlueBubbles server URL, password, and webhook path to use the REST API for message delivery. This Skill reads that configuration to gate actions and register the channel in the catalog.

Why are my self-sent messages looping back through the webhook?

Self-sent messages loop back when inbound webhook payloads lack self-message filtering. This Skill applies defensive ID normalization and self-message filtering to ignore those echoes and prevent duplicate processing.