Agent Skills › wukongrobot/wukongbot › bluebubbles

bluebubbles

GitHub

用于开发和维护 Moltbot 的 BlueBubbles 外部通道插件，涵盖扩展包结构、REST API 集成、Webhook 处理及消息工具逻辑。

skills/bluebubbles/SKILL.md wukongrobot/wukongbot

触发场景

开发或更新 BlueBubbles 通道插件实现 REST 发送/探测功能配置 Webhook 接收与消息路由

安装

npx skills add wukongrobot/wukongbot --skill bluebubbles -g -y

更多选项

不安装直接使用

npx skills use wukongrobot/wukongbot@bluebubbles

指定 Agent (Claude Code)

npx skills add wukongrobot/wukongbot --skill bluebubbles -a claude-code -g -y

安装 repo 全部 skill

npx skills add wukongrobot/wukongbot --all -g -y

预览 repo 内 skill

npx skills add wukongrobot/wukongbot --list

SKILL.md

Frontmatter

{
    "name": "bluebubbles",
    "description": "Build or update the BlueBubbles external channel plugin for Moltbot (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=❤️