BlueBubbles Actions
개요
BlueBubbles는 OpenClaw의 레거시 iMessage 브리지입니다. 첨부 파일, 탭백, 편집/회수, 회신 또는 그룹 관리를 필요로 하는 기존 BlueBubbles 기반 대화에는 channel: "bluebubbles"와 함께 message 도구를 사용하세요.
수집할 입력
target(chat_guid:...선호; 또한 E.164 형식의+15551234567또는[email protected])- 전송/편집/회신을 위한
message텍스트 - 반응/편집/회수/회신을 위한
messageId - 로컬 파일의 경우 첨부 파일
path, 또는 base64의 경우buffer+filename
사용자가 모호하게 말하는 경우(예: "우리 엄마한테 문자 보내줘"), 수신자 핸들 또는 채팅 GUID와 정확한 메시지 내용을 물어보세요.
작업
메시지 전송
{
"action": "send",
"channel": "bluebubbles",
"target": "+15551234567",
"message": "hello from OpenClaw"
}
반응 (탭백)
{
"action": "react",
"channel": "bluebubbles",
"target": "+15551234567",
"messageId": "<message-guid>",
"emoji": "❤️"
}
반응 제거
{
"action": "react",
"channel": "bluebubbles",
"target": "+15551234567",
"messageId": "<message-guid>",
"emoji": "❤️",
"remove": true
}
이전에 보낸 메시지 편집
{
"action": "edit",
"channel": "bluebubbles",
"target": "+15551234567",
"messageId": "<message-guid>",
"message": "updated text"
}
메시지 회수
{
"action": "unsend",
"channel": "bluebubbles",
"target": "+15551234567",
"messageId": "<message-guid>"
}
특정 메시지에 회신
{
"action": "reply",
"channel": "bluebubbles",
"target": "+15551234567",
"replyTo": "<message-guid>",
"message": "replying to that"
}
첨부 파일 전송
{
"action": "sendAttachment",
"channel": "bluebubbles",
"target": "+15551234567",
"path": "/tmp/photo.jpg",
"caption": "here you go"
}
iMessage 효과와 함께 전송
{
"action": "sendWithEffect",
"channel": "bluebubbles",
"target": "+15551234567",
"message": "big news",
"effect": "balloons"
}
참고 사항
- 게이트웨이 구성
channels.bluebubbles(serverUrl/password/webhookPath)가 필요합니다. - 사용 가능한 경우
chat_guid대상(특히 그룹 채팅)을 선호합니다. - BlueBubbles는 다양한 작업을 지원하지만 일부는 macOS 버전에 따라 다릅니다(예: 편집은 macOS 26 Tahoe에서 작동하지 않을 수 있음).
- 게이트웨이는 짧은 메시지 ID와 전체 메시지 ID를 모두 노출할 수 있습니다. 전체 ID는 재시작 후에도 더 안정적입니다.
- 기본 플러그인에 대한 개발자 참조는 BlueBubbles 플러그인 패키지 README에 있습니다.
시도해 볼 아이디어
- 탭백으로 반응하여 요청을 승인합니다.
- 사용자가 특정 메시지를 참조할 때 스레드에서 회신합니다.
- 짧은 캡션과 함께 파일 첨부 파일을 전송합니다.