BlueBubbles 채널 설정

BlueBubbles를 통해 macOS iMessage를 OpenClaw와 연동하는 방법을 안내합니다.

개요

BlueBubbles는 macOS에서 iMessage를 다른 플랫폼으로 전달하는 오픈소스 서버입니다:

• macOS 컴퓨터에서 BlueBubbles 서버 실행 필요
• iPhone 없이도 iMessage 수신/발신 가능
• 그룹 채팅, 리액션 지원

요구사항

• macOS 컴퓨터 (항상 켜져 있어야 함)
• Apple ID (iMessage 활성화)
• BlueBubbles 서버 설치

1단계: BlueBubbles 서버 설치

1. bluebubbles.app에서 macOS 서버 다운로드
2. 설치 후 실행
3. Apple ID로 로그인
4. 서버 비밀번호 설정
5. 서버 포트 확인 (기본: 1234)

2단계: OpenClaw 설정

{
  "channels": {
    "bluebubbles": {
      "enabled": true,
      "serverUrl": "http://your-mac-ip:1234",
      "password": "your-bb-password"
    }
  }
}

# 환경 변수로 설정 (보안)
export BLUEBUBBLES_URL="http://your-mac-ip:1234"
export BLUEBUBBLES_PASSWORD="your-bb-password"

3단계: 연결 테스트

openclaw gateway start
openclaw channel test --type bluebubbles

접근 제어

특정 연락처만 허용:

{
  "channels": {
    "bluebubbles": {
      "allowedNumbers": ["+821012345678"],
      "allowAll": false
    }
  }
}

트러블슈팅

연결 실패

• macOS 컴퓨터가 켜져 있는지 확인
• 방화벽에서 포트 개방 확인
• BlueBubbles 서버가 실행 중인지 확인

# BlueBubbles 서버 상태 확인
curl http://your-mac-ip:1234/api/v1/ping

메시지가 전송되지 않음

• Apple ID iMessage 활성화 확인
• macOS iMessage 앱에서 로그인 상태 확인

참고:

• BlueBubbles 공식 사이트
• 공식 문서: BlueBubbles Channel