BlueBubbles에서 iMessage로 이전
기준일: 2026-06-06
난이도: 중급
공식 기준: BlueBubbles removal and the imsg iMessage path, iMessage
OpenClaw의 BlueBubbles 지원 종료 이후에는 신규 iMessage 설정과 기존 BlueBubbles 사용자가 모두 channels.imessage와 imsg 기반 경로로 이전해야 합니다.
핵심 개념
| 항목 | 현재 기준 |
|---|---|
| BlueBubbles | OpenClaw에서 제거된 레거시 경로 |
| iMessage plugin | 지원되는 공식 iMessage 채널 |
imsg |
macOS Messages DB와 JSON-RPC로 통신하는 CLI |
| SSH wrapper | Gateway가 Linux/Windows에 있을 때 Mac의 imsg를 원격 실행 |
| pairing | DM 접근을 승인하는 기본 안전 장치 |
선택 기준
- 새 iMessage 연동은 BlueBubbles가 아니라
channels.imessage로 시작합니다. - 기존 설정에
channels.bluebubbles가 있으면 삭제하지 말고 먼저 변환표와 컷오버 체크리스트를 확인합니다. - Linux/Windows Gateway에서 iMessage가 필요하면 SSH wrapper로 signed-in Mac의
imsg를 호출합니다. - 첨부 파일, group allowlist, private API action은 별도 검증 후 켭니다.
실습
Mac에서 imsg를 먼저 검증합니다.
brew install steipete/tap/imsg
imsg --version
imsg chats --limit 3
imsg rpc --help
OpenClaw 상태 확인:
openclaw channels status --probe
openclaw pairing list imessage
기존 설정 점검:
내 OpenClaw config에서 channels.bluebubbles를 찾아
channels.imessage로 옮길 항목과 버려야 할 항목을 표로 정리해줘.
allowFrom, groups, includeAttachments, ACP binding을 특히 확인해줘.
도구에 입력할 프롬프트
BlueBubbles에서 OpenClaw iMessage로 이전하는 컷오버 계획을 만들어줘.
사전 백업, imsg 권한, config 변환, gateway 재시작, DM/group/attachment 검증,
이전 서버 제거 시점을 단계별로 나눠줘.
체크리스트
-
channels.bluebubbles를 새 설정으로 복사하지 않는다. - Messages Mac에서 Full Disk Access와 Automation 권한을 확인했다.
-
imsg chats와openclaw channels status --probe가 통과한다. - DM, group, attachment, private API action을 따로 테스트한다.
- BlueBubbles 세션 키와 iMessage 세션 키가 다르다는 점을 이해했다.
다음 단계
- iMessage 채널 설정에서 새 설정을 진행합니다.
- 접근 제어와 라우팅에서 pairing과 allowlist를 설계합니다.