bluebubbles

Build and maintain the BlueBubbles channel plugin for Moltbot.

Updated Jan 29, 2026
One-click install
npx skills add https://github.com/DharambirAgrawal/Personal-Assistant --skill bluebubbles-dharambiragrawal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bluebubbles
Source: https://github.com/DharambirAgrawal/Personal-Assistant/tree/main/skills/bluebubbles
Command: npx skills add https://github.com/DharambirAgrawal/Personal-Assistant --skill bluebubbles-dharambiragrawal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a structured integration path to build and maintain the BlueBubbles channel plugin for Moltbot, enabling reliable messaging, webhooks, and REST interactions with the BlueBubbles ecosystem.

Core Features & Use Cases

  • Extension package: extensions/bluebubbles/ (entry: index.ts)
  • Channel implementation: extensions/bluebubbles/src/channel.ts
  • Webhook handling: extensions/bluebubbles/src/monitor.ts (register via api.registerHttpHandler)
  • REST helpers: extensions/bluebubbles/src/send.ts + extensions/bluebubbles/src/probe.ts
  • Runtime bridge: extensions/bluebubbles/src/runtime.ts (set via api.runtime)
  • Catalog entry for onboarding: src/channels/plugins/catalog.ts

Quick Start

Determine the BlueBubbles plugin needs and initialize the extension layout, then configure gateway routes and runtime integration to enable REST, webhooks, and channel messaging.

Frequently Asked Questions about bluebubbles

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

FAQPage Schema
How do I build a channel plugin for Moltbot?

To build a channel plugin for Moltbot, initialize the extension layout under extensions/bluebubbles, place source files in src, and register the channel with the gateway runtime and plugin SDK to enable reliable messaging and REST interactions.

How do I handle inbound webhooks for a BlueBubbles channel?

Inbound webhooks for a BlueBubbles channel are handled by registering an HTTP handler via api.registerHttpHandler in the monitor.ts file. This routes incoming BlueBubbles ecosystem events directly into the Moltbot gateway runtime.

What is the file structure for a Moltbot extension package?

A Moltbot extension package requires an entry point at extensions/bluebubbles/index.ts. Channel logic goes in src/channel.ts, webhook handling in src/monitor.ts, and REST helpers in src/send.ts and src/probe.ts, alongside a runtime bridge file.

Does the BlueBubbles plugin support REST API messaging?

Yes, the BlueBubbles plugin supports REST API messaging through dedicated helpers in send.ts and probe.ts. These files manage outbound message delivery and endpoint probing within the Moltbot gateway runtime.

How do I register a custom channel in the Moltbot gateway?

To register a custom channel in the Moltbot gateway, configure the runtime bridge via api.runtime in runtime.ts and add an entry to the onboarding catalog in src/channels/plugins/catalog.ts. This properly links the channel to the SDK.

Do I need specific dependencies to develop a BlueBubbles webhook integration?

No external dependencies are required to develop the BlueBubbles webhook integration. The Skill relies entirely on the internal Moltbot plugin SDK and gateway runtime to handle HTTP requests and route REST messages.