​

BlueBubbles 제거 및 imsg iMessage 경로

OpenClaw는 더 이상 BlueBubbles 채널을 제공하지 않습니다. iMessage 지원은 번들로 제공되는 imessage 플러그인을 통해 이루어집니다. Gateway는 로컬에서 또는 SSH 래퍼를 통해 imsg를 자식 프로세스로 실행하고, 표준 입력/표준 출력을 통해 JSON-RPC로 통신합니다. 서버도, Webhook도, 포트도 없습니다. 구성에 여전히 channels.bluebubbles가 포함되어 있다면 channels.imessage로 마이그레이션하세요. 기존 /channels/bluebubbles 문서 URL은 전체 구성 변환표와 전환 체크리스트가 있는 BlueBubbles에서 이전하기로 리디렉션됩니다.

​

변경 사항

• 지원되는 iMessage 경로에는 BlueBubbles HTTP 서버, Webhook 경로, REST 비밀번호 또는 BlueBubbles 플러그인 런타임이 없습니다.
• OpenClaw는 Messages.app에 로그인된 Mac에서 imsg를 통해 메시지를 읽고 변경 사항을 감시합니다.
• 기본적인 전송, 수신, 기록 및 미디어 기능은 일반 imsg 인터페이스와 macOS 권한을 사용합니다.
• 고급 작업(스레드 답장, 탭백, 편집, 전송 취소, 효과, 읽음 확인, 입력 중 표시, 그룹 관리)에는 비공개 API 브리지가 필요합니다. SIP를 비활성화해야 하는 imsg launch를 실행하세요.
• Linux 및 Windows Gateway에서도 로그인된 Mac에서 imsg를 실행하는 SSH 래퍼를 channels.imessage.cliPath로 지정하여 iMessage를 사용할 수 있습니다.

​

수행할 작업

1. Messages가 실행되는 Mac에 imsg를 설치하고 확인합니다.
   brew install steipete/tap/imsg
   imsg --version
   imsg chats --limit 3
   imsg rpc --help
   
2. imsg와 OpenClaw를 실행하는 프로세스 컨텍스트에 전체 디스크 접근 권한과 자동화 권한을 부여합니다.
3. 이전 구성을 변환합니다.
   {
     channels: {
       imessage: {
         enabled: true,
         cliPath: "/opt/homebrew/bin/imsg",
         dmPolicy: "pairing",
         allowFrom: ["+15555550123"],
         groupPolicy: "allowlist",
         groupAllowFrom: ["+15555550123"],
         groups: {
           "*": { requireMention: true },
         },
         includeAttachments: true,
       },
     },
   }
   
4. Gateway를 다시 시작하고 확인합니다.
   openclaw channels status --probe
   
5. 이전 BlueBubbles 서버를 삭제하기 전에 DM, 그룹, 첨부 파일 및 사용하는 모든 비공개 API 작업을 테스트합니다.

​

마이그레이션 참고 사항

• channels.bluebubbles.serverUrl 및 channels.bluebubbles.password에 해당하는 iMessage 설정은 없습니다. 연결하거나 인증할 서버가 없기 때문입니다.
• allowFrom, groupAllowFrom, groups, includeAttachments, attachmentRoots, mediaMaxMb, textChunkLimit, actions.*는 channels.imessage에서도 의미가 동일하게 유지됩니다.
• channels.imessage.includeAttachments는 여전히 기본적으로 꺼져 있습니다. 수신 사진, 음성 메모, 동영상 또는 파일이 에이전트에 전달되어야 한다면 명시적으로 설정하세요.
• groupPolicy: "allowlist"를 사용하는 경우 "*" 와일드카드 항목을 포함하여 이전 groups 블록을 복사하세요. 그룹 발신자 허용 목록과 그룹 레지스트리는 별도의 통과 조건입니다. 항목은 있지만 일치하는 chat_id가 없고 "*"도 없는 groups 블록은 런타임에 메시지를 폐기합니다. 빈 groups 블록은 발신자 필터링을 통해 메시지가 계속 전달되더라도 시작 시 경고를 기록합니다.
• match.channel: "bluebubbles"가 지정된 ACP 바인딩은 "imessage"로 변경해야 합니다.
• 이전 BlueBubbles 세션 키는 iMessage 세션 키로 변환되지 않습니다. 페어링 승인은 발신자 핸들을 기준으로 하므로 복사한 allowFrom 항목은 계속 작동하지만, BlueBubbles 세션 키에 저장된 대화 기록은 이전되지 않습니다.

​

관련 문서

• BlueBubbles에서 이전하기
• iMessage
• 구성 참조 - iMessage