核心用法
本 Skill 是 BlueBubbles 外部通道插件的开发文档，面向 Clawdbot 扩展包开发者。主要功能包括：
- 扩展包架构：
extensions/bluebubbles/目录结构，入口index.ts，通道实现channel.ts，Webhook 处理monitor.ts - REST 通信：通过
send.ts发送消息、probe.ts健康检查、types.ts共享 URL 构建与超时控制 - Webhook 入站：BlueBubbles 向网关 HTTP 服务器投递 JSON，需防御性规范化 sender/chat ID，过滤自身消息，经
api.runtime路由至核心回复管道 - 媒体处理：附件下载使用
attachments.ts，入站媒体通过<media:...>占位符与MediaUrl(s)上下文传递 - 消息工具：
react动作需额外提供target（手机号或聊天标识符）与messageId
显著优点
- 文档详尽，覆盖插件完整生命周期（开发→部署→配置）
- 内部辅助函数封装完善，避免原始 API 调用
- 提供明确的配置项与动作门控机制
- Webhook 处理包含防御性编程建议（ID 规范化、自我消息过滤）
潜在局限
- 纯文档性质：无可执行代码，无法直接运行，需配合实际插件实现使用
- 来源可信度：T3 级个人开发者/社区项目，无企业背书
- 实现依赖：文档引用的辅助函数（如
probeBlueBubbles、sendMessageBlueBubbles）需用户自行验证其实现安全性 - 版本兼容：BlueBubbles 版本差异导致 payload 格式变化，需持续维护
适合人群
- Clawdbot 插件开发者、iMessage 桥接需求的技术团队、需自建消息通道的进阶用户
常规风险
- 文档安全≠实现安全：实际插件代码的网络请求、数据验证逻辑需独立审计
- Webhook 端点暴露风险：需确保
api.registerHttpHandler注册的路由有适当认证 - 敏感配置泄露：
channels.bluebubbles.password等凭据需安全存储，避免硬编码