skills.rest
dingdyan
dingdyanCOMMUNITY
Explore all skills by this author →
GitHub

bluebubbles

Route BlueBubbles webhooks and send REST messages through Clawdbot.

Updated Apr 5, 2026
Search Tags:#rest api#webhook#bluebubbles#message routing#media attachments#plugin runtime#health probe
One-click install
npx skills add https://github.com/dingdyan/openclaw-workspace-v2 --skill bluebubbles-dingdyan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bluebubbles
Source: https://github.com/dingdyan/openclaw-workspace-v2/tree/main/skills/bluebubbles
Command: npx skills add https://github.com/dingdyan/openclaw-workspace-v2 --skill bluebubbles-dingdyan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill removes the friction of integrating the BlueBubbles messaging ecosystem with Clawdbot by providing both inbound webhook handling and outbound REST/probe helpers, so messages and health checks can flow reliably without manual wiring.

Core Features & Use Cases

  • Webhook inbound routing: Accepts BlueBubbles JSON webhooks, normalizes sender/chat identifiers defensively across payload variants, skips self-originated messages, and forwards events into the Clawdbot reply pipeline via the plugin runtime.
  • Outbound message delivery & readiness checks: Sends text messages and performs probe/health checks using shared REST plumbing with request timeouts for dependable operations.
  • Chat context & media handling: Resolves chat GUIDs for targets, supports typing/read acknowledgements, and handles inbound attachments/stickers with media placeholders when text is empty.

Quick Start

Use the bluebubbles skill to enable BlueBubbles channel integration by configuring channels.bluebubbles.serverUrl, channels.bluebubbles.password, and channels.bluebubbles.webhookPath, then trigger a message send or webhook event to verify end-to-end delivery.

Frequently Asked Questions about bluebubbles

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

FAQPage Schema
How do I handle inbound BlueBubbles webhooks and route messages to a bot?▼

To handle inbound BlueBubbles webhooks, you register an HTTP handler that accepts JSON payloads, normalizes sender and chat identifiers defensively, skips self-originated messages, and forwards events into the bot reply pipeline via the plugin runtime.

What is the best way to send outbound messages and perform health checks for BlueBubbles integration?▼

The best way to send outbound messages and perform health checks is using shared REST URL construction with timeout fetch helpers, ensuring dependable delivery and server readiness probing without manual wiring.

How does BlueBubbles integration handle inbound media attachments and stickers?▼

BlueBubbles integration handles inbound media attachments and stickers by applying media placeholders when text is empty, ensuring attachment payloads are normalized and routed correctly through the channel workflow.

Do I need to configure a server URL and password to connect BlueBubbles channels?▼

Yes, you need to configure channels.bluebubbles.serverUrl, channels.bluebubbles.password, and channels.bluebubbles.webhookPath to enable BlueBubbles channel integration and verify end-to-end message delivery.

Can I resolve chat GUIDs and send typing or read acknowledgements through BlueBubbles REST APIs?▼

Yes, you can resolve chat GUIDs for target recipients and support typing or read acknowledgements by leveraging the outbound REST plumbing and payload normalization provided within the messaging integration workflow.

Why are my self-originated messages being skipped in the BlueBubbles webhook routing pipeline?▼

Self-originated messages are skipped defensively during payload normalization to prevent echo loops in the webhook routing pipeline, ensuring the bot only processes and forwards external inbound events.

Related Skills

Explore More Software Engineering Skills→
douglasjsdouglasjs

bluebubbles

Develop and operate the BlueBubbles external channel plugin for Clawdbot with REST and webhook support.

Community
Intermediate
ycechungAIycechungAI
1

Add Discord Channel

Integrate Discord as a communication channel for NanoClaw using discord.js.

Community
Intermediate
hlbbbbbbbhlbbbbbbb
6

bluebubbles

Develop and maintain the BlueBubbles external channel plugin for Clawdbot.

Community
Advanced
JoeyJoziahJoeyJoziah

bluebubbles

Build and update the BlueBubbles external channel plugin for Clawdbot.

Community
Advanced