bluebubbles

Build or update the BlueBubbles external channel plugin for OpenClaw.

5|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/kcns008/clusterclaw --skill bluebubbles-kcns008
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bluebubbles
Source: https://github.com/kcns008/clusterclaw/tree/main/skills/bluebubbles
Command: npx skills add https://github.com/kcns008/clusterclaw --skill bluebubbles-kcns008

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you build and maintain the BlueBubbles external channel plugin so OpenClaw can send messages, receive webhooks, and handle iMessage-style channel workflows reliably.

Core Features & Use Cases

  • Plugin implementation: Work across the channel package, runtime bridge, webhook monitor, and REST helpers that make up the BlueBubbles integration.
  • Inbound and outbound messaging: Normalize incoming webhook payloads, ignore self-sent events, and route messages into the core reply pipeline while supporting send, probe, reaction, typing, and read actions.
  • Media and chat handling: Manage attachments, sticker placeholders, chat lookup, and channel configuration details needed for stable real-world deployments.

Quick Start

Update the BlueBubbles channel by implementing the required webhook, send, and runtime changes for your target integration scenario.

Frequently Asked Questions about bluebubbles

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

FAQPage Schema
How do I integrate BlueBubbles webhooks with OpenClaw for iMessage messaging?

BlueBubbles webhook integration ingests incoming payloads, ignores self-sent events, and routes messages into the OpenClaw reply pipeline. You build the channel plugin, runtime bridge, and webhook monitor to enable reliable inbound and outbound iMessage delivery.

Does the BlueBubbles channel plugin support attachments and media path handling?

The BlueBubbles channel plugin supports attachment handling and media path management for stable real-world deployments. It processes incoming media, manages sticker placeholders, and performs chat lookup to ensure reliable attachment delivery within the OpenClaw messaging workflow.

Can I send typing indicators and read receipts through a BlueBubbles integration?

BlueBubbles integration supports send, probe, reaction, typing, and read actions. You implement outbound message delivery through REST helpers and the runtime bridge to dispatch these iMessage-style events from OpenClaw to the BlueBubbles server.

What is required to configure channel onboarding for a BlueBubbles messaging plugin?

BlueBubbles channel onboarding requires correct channel configuration, runtime registration, and REST helper usage. You must implement defensive payload normalization and media path handling to ensure reliable plugin operation during real-world webhook-driven message ingestion.

Why are self-sent webhook events ignored in BlueBubbles message ingestion?

Self-sent webhook events are ignored during BlueBubbles message ingestion to prevent feedback loops in the OpenClaw reply pipeline. Defensive payload normalization filters these events so the plugin only routes genuine inbound messages for processing.

What is the best way to build an external channel plugin for BlueBubbles messaging?

Building an external BlueBubbles channel plugin involves implementing the channel package, runtime bridge, webhook monitor, and REST helpers. This approach ensures reliable webhook-driven ingestion, outbound delivery, and attachment handling compared to fragmented custom integrations.