mirror of https://github.com/openclaw/openclaw.git synced 2026-05-06 08:00:42 +00:00

Files

Omar Shahine 6f1d321aab feat(bluebubbles): replay missed webhook messages after gateway restart (#66857 )

Adds an in-process startup catchup pass to the BlueBubbles channel that
queries BB Server for messages delivered since a persisted per-account
cursor and re-feeds each through the existing processMessage pipeline.

Fixes the missed-message hole documented in #66721: BB's WebhookService
is fire-and-forget on POST failure, and MessagePoller only re-fires
webhooks on BB-side reconnection events, not on webhook-receiver
recovery.

- New extensions/bluebubbles/src/catchup.ts with singleflight per
  accountId, cursor persistence via the canonical state-paths
  resolver, bounded query (perRunLimit + maxAgeMinutes), failure-held
  cursor, truncation-aware page-boundary advancement, future-cursor
  recovery, isFromMe filter (pre- and post-normalization).
- monitor.ts fires catchup as a background task after the webhook
  target registers.
- config-schema.ts adds optional catchup block; accounts.ts adds
  catchup to nestedObjectKeys for deep-merge per-account overrides.
- Dedupes against #66816's persistent inbound GUID cache.
- 22 scoped tests; full BB suite 411/411; pnpm check green; live E2E
  on macOS 26.3 / BB Server 1.9.x recovered 3/3 missed messages.

Closes #66721.

Co-authored-by: Omar Shahine <omar@shahine.com>

2026-04-14 19:20:42 -07:00

src

feat(bluebubbles): replay missed webhook messages after gateway restart (#66857 )

2026-04-14 19:20:42 -07:00

api.ts

refactor: clean bundled channel bootstrap boundaries

2026-04-05 18:18:59 +01:00

channel-config-api.ts

refactor: move channel config metadata into plugin-owned manifests

2026-03-27 01:59:30 +00:00

contract-api.ts

fix(secrets): restore source-mode contract loading

2026-04-06 17:59:53 +01:00

index.ts

fix: repair bundled channel secret sidecars

2026-04-08 04:56:58 +01:00

openclaw.plugin.json

chore: Run pnpm format:fix.

2026-01-31 21:13:13 +09:00

package.json

chore: bump version to 2026.4.12

2026-04-12 10:37:18 -07:00

README.md

refactor(plugins): decouple bundled plugin runtime loading

2026-03-29 09:10:38 +01:00

runtime-api.ts

refactor: clean bundled channel bootstrap boundaries

2026-04-05 18:18:59 +01:00

secret-contract-api.ts

fix: repair bundled channel secret sidecars

2026-04-08 04:56:58 +01:00

setup-entry.ts

fix: repair bundled channel secret sidecars

2026-04-08 04:56:58 +01:00

tsconfig.json

chore(plugins): bulk add package boundary tsconfig rollout

2026-04-07 08:48:23 +01:00

README.md

BlueBubbles extension (developer reference)

This package contains the BlueBubbles external channel plugin for OpenClaw.

If you’re looking for how to use BlueBubbles as an agent/tool user, see:

skills/bluebubbles/SKILL.md

Layout

Package entry: index.ts.
Channel implementation: src/channel.ts.
Webhook handling: src/monitor.ts (register per-account route via registerPluginHttpRoute).
REST helpers: src/send.ts + src/probe.ts.
Runtime bridge: src/runtime.ts (set via api.runtime).
Catalog entry for setup selection: src/channels/plugins/catalog.ts.

Internal helpers (use these, not raw API calls)

probeBlueBubbles in src/probe.ts for health checks.
sendMessageBlueBubbles in src/send.ts for text delivery.
resolveChatGuidForTarget in src/send.ts for chat lookup.
sendBlueBubblesReaction in src/reactions.ts for tapbacks.
sendBlueBubblesTyping + markBlueBubblesChatRead in src/chat.ts.
downloadBlueBubblesAttachment in src/attachments.ts for inbound media.
buildBlueBubblesApiUrl + blueBubblesFetchWithTimeout in 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 openclaw/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=❤️

README.md Unescape Escape

BlueBubbles extension (developer reference)

Layout

Internal helpers (use these, not raw API calls)

Webhooks

Config (core)

Message tool notes

README.md