Xpersona
B

Bluebubbles

CLAWHUB · Unverified

Build or update the BlueBubbles external channel plugin for Clawdbot (extension package, REST send/probe, webhook inbound). Skill: Bluebubbles Owner: kevin19830331 Summary: Build or update the BlueBubbles external channel plugin for Clawdbot (extension package, REST send/probe, webhook inbound). Tags: latest:1.0.0 Version history: v1.0.0 | 2026-01-26T05:27:11.570Z | auto - Initial release. Archive index: Archive v1.0.0: 3 files, 2457 bytes Files: skill-card.md (1961b), SKILL.md (2298b), _meta.json (130b) File v1.0.0:SKILL.md --- name: blu

62
Rank
84
Safety
14k
Downloads

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 14.2K downloads reported by the source. Last updated 11/16/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Install and run

Setup complexity: low.

clawhub skill install s17dkvz405bq7vzp69ap94dvhh8841rq:bluebubbles
  1. Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
  2. Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-kevin19830331-bluebubbles-ebubbles-2/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

4,856 characters of source documentation, loaded on request.

Extracted files

3 files captured from the source.

SKILL.md

---
name: bluebubbles
description: Build or update the BlueBubbles external channel plugin for Clawdbot (extension package, REST send/probe, webhook inbound).
---

# BlueBubbles plugin

Use this skill when working on the BlueBubbles channel plugin.

## Layout
- 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`.

## Internal helpers (use these, not raw API calls)
- `probeBlueBubbles` in `extensions/bluebubbles/src/probe.ts` for health checks.
- `sendMessageBlueBubbles` in `extensions/bluebubbles/src/send.ts` for text delivery.
- `resolveChatGuidForTarget` in `extensions/bluebubbles/src/send.ts` for chat lookup.
- `sendBlueBubblesReaction` in `extensions/bluebubbles/src/reactions.ts` for tapbacks.
- `sendBlueBubblesTyping` + `markBlueBubblesChatRead` in `extensions/bluebubbles/src/chat.ts`.
- `downloadBlueBubblesAttachment` in `extensions/bluebubbles/src/attachments.ts` for inbound media.
- `buildBlueBubblesApiUrl` + `blueBubblesFetchWithTimeout` in `extensions/bluebubbles/src/types.ts` for shared REST plumbing.

## Webhooks
- BlueBubbles posts JSON to the gateway HTTP server.
- Normalize sender/chat IDs defensively (payloads vary by version).
- Skip messages marked as from self.
- Route into core reply pipeline via the plugin runtime (`api.runtime`) and `clawdbot/plugin-sdk` helpers.
- For attachments/stickers, use `<media:...>` placeholders when text is empty and attach media paths via `MediaUrl(s)` in the inbound context.

## Config (core)
- `channels.bluebubbles.serverUrl` (base URL), `channels.bluebubbles.password`, `channels.bluebubbles.webhookPath`.
- Action gating: `channels.bluebubbles.actions.reactions` (default true).

## Message tool notes
- **Reactions:** The `react` action requires a `target` (phone number or chat identifier) in addition to `messageId`. Example: `action=react target=+15551234567 messageId=ABC123 emoji=❤️`

_meta.json

{
  "ownerId": "kn76fefs432zhff78zmv4q1b2x7zymsz",
  "slug": "bluebubbles",
  "version": "1.0.0",
  "publishedAt": 1769405231570
}

skill-card.md

## Description:

Build or update the BlueBubbles external channel plugin for Clawdbot (extension package, REST send/probe, webhook inbound).

This skill is ready for commercial/non-commercial use.

## Publisher:

[kevin19830331](https://clawhub.ai/user/kevin19830331)

### License/Terms of Use:


## Use Case:

Developers and engineers use this skill to build or update a BlueBubbles channel plugin for Clawdbot, including REST send and probe flows, webhook inbound handling, runtime integration, and plugin catalog onboarding.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: Generated plugin work may affect message content, attachments, webhook traffic, and a BlueBubbles server password.

Mitigation: Review the eventual plugin implementation separately before deployment, with attention to credential handling, webhook exposure, and media processing.

Risk: BlueBubbles payloads may vary by version, which can lead to incorrect sender or chat routing if handled too narrowly.

Mitigation: Normalize sender and chat identifiers defensively and test webhook payloads from the deployed BlueBubbles version.

## Reference(s):

- [ClawHub skill page](https://clawhub.ai/kevin19830331/skills/bluebubbles)

## Skill Output:

**Output Type(s):** [Guidance, Markdown, Code, Shell commands, Configuration]

**Output Format:** [Markdown guidance with code paths, helper names, and command examples]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [May guide edits to a BlueBubbles channel plugin that handles message content, attachments, webhook traffic, and server credentials.]

## Skill Version(s):

1.0.0 (source: server release metadata)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Sponsored

Ads related to Bluebubbles and adjacent AI workflows.