BlueBubbles插件开发

技能简介

本技能用于开发或维护 BlueBubbles 外部通道插件，实现 Clawdbot 与 iMessage 网络的桥接。该插件以扩展包形式存在，支持 REST 发送/探测及 Webhook 入站处理。

能做什么

• 搭建完整的 BlueBubbles 通道插件工程结构
• 实现消息发送、健康探测、表情回应等核心功能
• 处理 BlueBubbles 推送的 Webhook 事件并路由至回复流水线
• 管理附件下载、输入状态、已读标记等会话操作

使用说明

1. 安装依赖：确保项目已集成 clawdbot/plugin-sdk
2. 创建扩展目录：extensions/bluebubbles/，入口文件为 index.ts
3. 实现通道逻辑：在 src/channel.ts 中定义通道行为
4. 注册 Webhook 处理器：通过 api.registerHttpHandler 在 src/monitor.ts 中接收 BlueBubbles 推送
5. 配置运行时桥接：调用 api.runtime 设置 src/runtime.ts
6. 更新通道目录：在 src/channels/plugins/catalog.ts 登记插件入口
7. 配置核心参数：channels.bluebubbles.serverUrl、password、webhookPath

输入与输出

见下方输入与输出表格。

风险提示

• 需防御性处理 sender/chat ID，BlueBubbles 不同版本 payload 格式存在差异
• 应跳过标记为 from self 的消息避免循环
• reaction 动作必须同时提供 target（手机号或聊天标识）与 messageId
• 附件场景下空文本需使用 <media:...> 占位符

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/kevin19830331/bluebubbles/SKILL.md
来源类型：GitHub 仓库