> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# BlueBubbles에서 오기

번들된 `imessage` Plugin은 이제 JSON-RPC를 통해 [`steipete/imsg`](https://github.com/steipete/imsg)를 구동하여 BlueBubbles와 동일한 비공개 API 표면(`react`, `edit`, `unsend`, `reply`, `sendWithEffect`, 그룹 관리, 첨부 파일)에 접근합니다. 이미 `imsg`가 설치된 Mac을 실행 중이라면 BlueBubbles 서버를 제거하고 Plugin이 Messages.app과 직접 통신하게 할 수 있습니다.

BlueBubbles 지원은 제거되었습니다. OpenClaw는 `imsg`를 통해서만 iMessage를 지원합니다. 이 가이드는 기존 `channels.bluebubbles` 구성을 `channels.imessage`로 마이그레이션하기 위한 것입니다. 다른 지원되는 마이그레이션 경로는 없습니다.

<Note>
  짧은 공지와 운영자 요약은 [BlueBubbles 제거 및 imsg iMessage 경로](/ko/announcements/bluebubbles-imessage)를 참조하세요.
</Note>

## 마이그레이션 체크리스트

기존 BlueBubbles 구성을 이미 알고 있고 가장 짧고 안전한 경로를 원할 때 이 체크리스트를 사용하세요.

1. Messages.app을 실행하는 Mac에서 `imsg`를 직접 확인합니다(`imsg chats`, `imsg history`, `imsg send`, `imsg rpc --help`).
2. `channels.bluebubbles`의 동작 키를 `channels.imessage`로 복사합니다: `dmPolicy`, `allowFrom`, `groupPolicy`, `groupAllowFrom`, `groups`, `includeAttachments`, `attachmentRoots`, `mediaMaxMb`, `textChunkLimit`, `coalesceSameSenderDms`, `actions`.
3. 더 이상 존재하지 않는 전송 키를 제거합니다: `serverUrl`, `password`, Webhook URL, BlueBubbles 서버 설정.
4. Gateway가 Messages Mac에서 실행되지 않는 경우 `channels.imessage.cliPath`를 SSH 래퍼로 설정하고 원격 첨부 파일 가져오기를 위해 `remoteHost`를 설정합니다.
5. Gateway를 중지한 상태에서 `channels.imessage`를 활성화한 다음 `openclaw channels status --probe --channel imessage`를 실행합니다.
6. DM 하나, 허용된 그룹 하나, 활성화한 경우 첨부 파일, 그리고 에이전트가 사용할 것으로 예상하는 모든 비공개 API 동작을 테스트합니다.
7. iMessage 경로가 확인된 뒤 BlueBubbles 서버와 기존 `channels.bluebubbles` 구성을 삭제합니다.

## 이 마이그레이션이 적합한 경우

* Messages.app에 로그인된 동일한 Mac 또는 SSH로 접근 가능한 Mac에서 이미 `imsg`를 실행 중입니다.
* 이동 부품을 하나 줄이고 싶습니다. 별도의 BlueBubbles 서버, 인증할 REST 엔드포인트, Webhook 배관이 없습니다. 서버 + 클라이언트 앱 + 헬퍼 대신 단일 CLI 바이너리입니다.
* 비공개 API 프로브가 `available: true`를 보고하는 [지원되는 macOS / `imsg` 빌드](/ko/channels/imessage#requirements-and-permissions-macos)를 사용 중입니다.

## imsg의 역할

`imsg`는 Messages용 로컬 macOS CLI입니다. OpenClaw는 `imsg rpc`를 자식 프로세스로 시작하고 stdin/stdout을 통해 JSON-RPC로 통신합니다. HTTP 서버, Webhook URL, 백그라운드 데몬, launch agent, 노출할 포트가 없습니다.

* 읽기는 읽기 전용 SQLite 핸들을 사용하여 `~/Library/Messages/chat.db`에서 가져옵니다.
* 실시간 인바운드 메시지는 `imsg watch` / `watch.subscribe`에서 가져오며, 이는 폴링 fallback과 함께 `chat.db` 파일 시스템 이벤트를 추적합니다.
* 전송은 일반 텍스트 및 파일 전송에 Messages.app 자동화를 사용합니다.
* 고급 동작은 `imsg launch`를 사용하여 `imsg` 헬퍼를 Messages.app에 주입합니다. 이를 통해 읽음 확인, 입력 표시기, 리치 전송, 편집, 전송 취소, 스레드 답장, tapback, 그룹 관리가 가능해집니다.
* Linux 빌드는 복사된 `chat.db`를 검사할 수 있지만, 전송하거나 실시간 Mac 데이터베이스를 감시하거나 Messages.app을 구동할 수는 없습니다. OpenClaw iMessage의 경우 로그인된 Mac에서 또는 해당 Mac으로 가는 SSH 래퍼를 통해 `imsg`를 실행하세요.

## 시작하기 전에

1. Messages.app을 실행하는 Mac에 `imsg`를 설치합니다.

   ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
   brew install steipete/tap/imsg
   imsg --version
   imsg chats --limit 3
   ```

   `imsg chats`가 `unable to open database file`, 빈 출력, 또는 `authorization denied`로 실패하면 `imsg`를 실행하는 터미널, 편집기, Node 프로세스, Gateway 서비스, 또는 SSH 부모 프로세스에 전체 디스크 접근 권한을 부여한 다음 해당 부모 프로세스를 다시 엽니다.

2. OpenClaw 구성을 변경하기 전에 읽기, 감시, 전송, RPC 표면을 확인합니다.

   ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
   imsg chats --limit 10 --json | jq -s
   imsg history --chat-id 42 --limit 10 --attachments --json | jq -s
   imsg watch --chat-id 42 --reactions --json
   imsg send --chat-id 42 --text "OpenClaw imsg test"
   imsg rpc --help
   ```

   `42`를 `imsg chats`의 실제 채팅 ID로 바꾸세요. 전송에는 Messages.app에 대한 자동화 권한이 필요합니다. OpenClaw가 SSH를 통해 실행될 예정이라면 OpenClaw가 사용할 동일한 SSH 래퍼 또는 사용자 컨텍스트를 통해 이 명령을 실행하세요. 읽기/프로브는 작동하지만 AppleEvents `-1743`으로 전송이 실패하면 자동화 권한이 `/usr/libexec/sshd-keygen-wrapper`에 적용되었는지 확인하세요. [SSH 래퍼 전송이 AppleEvents -1743으로 실패](/ko/channels/imessage#ssh-wrapper-sends-fail-with-appleevents-1743)를 참조하세요.

3. 고급 동작이 필요할 때 비공개 API 브리지를 활성화합니다.

   ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
   imsg launch
   imsg status --json
   ```

   `imsg launch`를 사용하려면 SIP를 비활성화해야 합니다. 기본 전송, 기록, 감시는 `imsg launch` 없이 작동하지만 고급 동작은 작동하지 않습니다.

4. 활성화된 `channels.imessage` 구성을 추가한 뒤 OpenClaw를 통해 브리지를 확인합니다.

   ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
   openclaw channels status --probe
   ```

   `imessage.privateApi.available: true`가 필요합니다. `false`를 보고하면 먼저 이를 수정하세요. [기능 감지](/ko/channels/imessage#private-api-actions)를 참조하세요. `channels status --probe`는 구성되고 활성화된 계정만 프로브합니다.

5. 구성을 스냅샷합니다.

   ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
   cp ~/.openclaw/openclaw.json5 ~/.openclaw/openclaw.json5.bak
   ```

## 구성 변환

iMessage와 BlueBubbles는 많은 채널 수준 구성을 공유합니다. 변경되는 키는 대부분 전송 방식(REST 서버와 로컬 CLI)입니다. 동작 키(`dmPolicy`, `groupPolicy`, `allowFrom` 등)는 동일한 의미를 유지합니다.

| BlueBubbles                                                | 번들 iMessage                               | 참고                                                                                                                                                                                                                                                                                                   |
| ---------------------------------------------------------- | ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `channels.bluebubbles.enabled`                             | `channels.imessage.enabled`               | 동일한 의미입니다.                                                                                                                                                                                                                                                                                           |
| `channels.bluebubbles.serverUrl`                           | *(제거됨)*                                   | REST 서버가 없습니다. Plugin이 stdio를 통해 `imsg rpc`를 생성합니다.                                                                                                                                                                                                                                                  |
| `channels.bluebubbles.password`                            | *(제거됨)*                                   | Webhook 인증이 필요 없습니다.                                                                                                                                                                                                                                                                                 |
| *(암시적)*                                                    | `channels.imessage.cliPath`               | `imsg` 경로입니다(기본값 `imsg`). SSH에는 래퍼 스크립트를 사용하세요.                                                                                                                                                                                                                                                      |
| *(암시적)*                                                    | `channels.imessage.dbPath`                | 선택적 Messages.app `chat.db` 재정의입니다. 생략하면 자동 감지됩니다.                                                                                                                                                                                                                                                    |
| *(암시적)*                                                    | `channels.imessage.remoteHost`            | `host` 또는 `user@host`입니다. `cliPath`가 SSH 래퍼이고 SCP 첨부 파일 가져오기를 원할 때만 필요합니다.                                                                                                                                                                                                                           |
| `channels.bluebubbles.dmPolicy`                            | `channels.imessage.dmPolicy`              | 동일한 값입니다(`pairing` / `allowlist` / `open` / `disabled`).                                                                                                                                                                                                                                             |
| `channels.bluebubbles.allowFrom`                           | `channels.imessage.allowFrom`             | 페어링 승인은 토큰이 아니라 핸들 기준으로 이어집니다.                                                                                                                                                                                                                                                                       |
| `channels.bluebubbles.groupPolicy`                         | `channels.imessage.groupPolicy`           | 동일한 값입니다(`allowlist` / `open` / `disabled`).                                                                                                                                                                                                                                                         |
| `channels.bluebubbles.groupAllowFrom`                      | `channels.imessage.groupAllowFrom`        | 동일합니다.                                                                                                                                                                                                                                                                                               |
| `channels.bluebubbles.groups`                              | `channels.imessage.groups`                | **`groups: { "*": { ... } }` 와일드카드 항목을 포함해 그대로 복사하세요.** 그룹별 `requireMention`, `tools`, `toolsBySender`가 이어집니다. `groupPolicy: "allowlist"`에서 `groups` 블록이 비어 있거나 없으면 모든 그룹 메시지가 조용히 드롭됩니다. 아래 "그룹 레지스트리 함정"을 참고하세요.                                                                                   |
| `channels.bluebubbles.sendReadReceipts`                    | `channels.imessage.sendReadReceipts`      | 기본값은 `true`입니다. 번들 Plugin에서는 비공개 API 프로브가 실행 중일 때만 작동합니다.                                                                                                                                                                                                                                            |
| `channels.bluebubbles.includeAttachments`                  | `channels.imessage.includeAttachments`    | 동일한 형태이며, **동일하게 기본적으로 꺼져 있습니다**. BlueBubbles에서 첨부 파일이 전달되고 있었다면 iMessage 블록에서 이를 명시적으로 다시 설정해야 합니다. 암시적으로 이어지지 않으며, 그렇게 하기 전까지 수신 사진/미디어는 `Inbound message` 로그 줄 없이 조용히 드롭됩니다.                                                                                                                      |
| `channels.bluebubbles.attachmentRoots`                     | `channels.imessage.attachmentRoots`       | 로컬 루트입니다. 와일드카드 규칙은 동일합니다.                                                                                                                                                                                                                                                                           |
| *(해당 없음)*                                                  | `channels.imessage.remoteAttachmentRoots` | SCP 가져오기에 `remoteHost`가 설정된 경우에만 사용됩니다.                                                                                                                                                                                                                                                              |
| `channels.bluebubbles.mediaMaxMb`                          | `channels.imessage.mediaMaxMb`            | iMessage의 기본값은 16 MB입니다(BlueBubbles 기본값은 8 MB였습니다). 더 낮은 제한을 유지하려면 명시적으로 설정하세요.                                                                                                                                                                                                                      |
| `channels.bluebubbles.textChunkLimit`                      | `channels.imessage.textChunkLimit`        | 둘 다 기본값은 4000입니다.                                                                                                                                                                                                                                                                                    |
| `channels.bluebubbles.coalesceSameSenderDms`               | `channels.imessage.coalesceSameSenderDms` | 동일한 옵트인입니다. DM 전용입니다. 그룹 채팅은 두 채널 모두에서 메시지별 즉시 디스패치를 유지합니다. 명시적인 `messages.inbound.byChannel.imessage` 또는 전역 `messages.inbound.debounceMs` 없이 활성화하면 기본 수신 디바운스가 7000 ms로 넓어집니다. [iMessage 문서 § 분할 전송 DM 병합](/ko/channels/imessage#coalescing-split-send-dms-command--url-in-one-composition)을 참고하세요. |
| `channels.bluebubbles.enrichGroupParticipantsFromContacts` | *(해당 없음)*                                 | iMessage는 이미 `chat.db`에서 보낸 사람 표시 이름을 읽습니다.                                                                                                                                                                                                                                                          |
| `channels.bluebubbles.actions.*`                           | `channels.imessage.actions.*`             | 작업별 토글입니다: `reactions`, `edit`, `unsend`, `reply`, `sendWithEffect`, `renameGroup`, `setGroupIcon`, `addParticipant`, `removeParticipant`, `leaveGroup`, `sendAttachment`.                                                                                                                           |

다중 계정 구성(`channels.bluebubbles.accounts.*`)은 `channels.imessage.accounts.*`로 일대일 변환됩니다.

## 그룹 레지스트리 함정

번들 iMessage Plugin은 **두 개의** 별도 그룹 허용 목록 게이트를 연속으로 실행합니다. 그룹 메시지가 에이전트에 도달하려면 둘 다 통과해야 합니다.

1. **보낸 사람 / 채팅 대상 허용 목록**(`channels.imessage.groupAllowFrom`) — `isAllowedIMessageSender`가 확인합니다. 수신 메시지를 보낸 사람 핸들, `chat_guid`, `chat_identifier` 또는 `chat_id`와 매칭합니다. 형태는 BlueBubbles와 동일합니다.
2. **그룹 레지스트리**(`channels.imessage.groups`) — `inbound-processing.ts:199`의 `resolveChannelGroupPolicy`가 확인합니다. `groupPolicy: "allowlist"`에서는 이 게이트가 다음 중 하나를 요구합니다.
   * `groups: { "*": { ... } }` 와일드카드 항목(`allowAll = true` 설정), 또는
   * `groups` 아래의 명시적인 `chat_id`별 항목.

게이트 1은 통과하지만 게이트 2가 실패하면 메시지는 드롭됩니다. 이제 기본 로그 수준에서 조용히 지나가지 않도록 Plugin은 두 개의 `warn` 수준 신호를 내보냅니다.

* `groupPolicy: "allowlist"`가 설정되어 있지만 `channels.imessage.groups`가 비어 있을 때(`"*"` 와일드카드도 없고 `chat_id`별 항목도 없음), 계정별로 시작 시 한 번 발생하는 `warn`입니다. 메시지가 도착하기 전에 발생합니다.
* 특정 그룹이 런타임에서 처음 드롭될 때 `chat_id`별로 한 번 발생하는 `warn`입니다. chat\_id와 이를 허용하기 위해 `groups`에 추가할 정확한 키를 명시합니다.

DM은 다른 코드 경로를 사용하므로 계속 작동합니다.

이는 가장 흔한 BlueBubbles → 번들 iMessage 마이그레이션 실패 모드입니다. 운영자가 `groupAllowFrom`과 `groupPolicy`는 복사하지만 `groups` 블록은 건너뜁니다. BlueBubbles의 `groups: { "*": { "requireMention": true } }`가 관련 없는 멘션 설정처럼 보이기 때문입니다. 실제로는 레지스트리 게이트에 필수입니다.

`groupPolicy: "allowlist"` 이후에도 그룹 메시지가 계속 흐르도록 하는 최소 구성:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  channels: {
    imessage: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15555550123", "chat_guid:any;-;..."],
      groups: {
        "*": { requireMention: true },
      },
    },
  },
}
```

`*` 아래의 `requireMention: true`는 멘션 패턴이 구성되지 않은 경우에도 무해합니다. 런타임은 `canDetectMention = false`로 설정하고 `inbound-processing.ts:512`에서 멘션 드롭을 단락 처리합니다. 멘션 패턴이 구성된 경우(`agents.list[].groupChat.mentionPatterns`)에는 예상대로 작동합니다.

Gateway 로그에 `imessage: dropping group message from chat_id=<id>` 또는 시작 줄 `imessage: groupPolicy="allowlist" but channels.imessage.groups is empty`가 표시되면 게이트 2에서 드롭하는 것입니다. `groups` 블록을 추가하세요.

## 단계별 절차

1. 기존 BlueBubbles 블록 옆에 iMessage 블록을 추가합니다. Gateway가 아직 BlueBubbles 트래픽을 라우팅하는 동안에는 비활성화 상태로 둡니다.

   ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
   {
     channels: {
       bluebubbles: {
         enabled: true,
         // ... existing config ...
       },
       imessage: {
         enabled: false,
         cliPath: "/opt/homebrew/bin/imsg",
         dmPolicy: "pairing",
         allowFrom: ["+15555550123"], // copy from bluebubbles.allowFrom
         groupPolicy: "allowlist",
         groupAllowFrom: [], // copy from bluebubbles.groupAllowFrom
         groups: { "*": { requireMention: true } }, // copy from bluebubbles.groups — silently drops groups if missing, see "Group registry footgun" above
         actions: {
           reactions: true,
           edit: true,
           unsend: true,
           reply: true,
           sendWithEffect: true,
           sendAttachment: true,
         },
       },
     },
   }
   ```

2. **트래픽이 중요해지기 전에 프로브합니다** — Gateway를 중지하고, iMessage 블록을 임시로 활성화한 뒤, CLI에서 iMessage가 정상으로 보고되는지 확인합니다.

   ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
   openclaw gateway stop
   # edit config: channels.imessage.enabled = true
   openclaw channels status --probe --channel imessage   # expect imessage.privateApi.available: true
   ```

   `channels status --probe`는 구성되고 활성화된 계정만 프로브합니다. 두 채널 모니터를 의도적으로 모두 실행하려는 경우가 아니라면 BlueBubbles와 iMessage가 모두 활성화된 상태로 Gateway를 다시 시작하지 마세요. 즉시 전환하지 않을 경우 Gateway를 다시 시작하기 전에 `channels.imessage.enabled`를 다시 `false`로 설정하세요. OpenClaw 트래픽을 활성화하기 전에 Mac을 검증하려면 [시작하기 전에](#before-you-start)의 직접 `imsg` 명령을 사용하세요.

3. **전환합니다.** 활성화된 iMessage 계정이 정상으로 보고되면 BlueBubbles 구성을 제거하고 iMessage를 활성화 상태로 유지합니다.

   ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
   {
     channels: {
       imessage: { enabled: true /* ... */ },
     },
   }
   ```

   Gateway를 다시 시작합니다. 이제 인바운드 iMessage 트래픽은 번들 Plugin을 통해 흐릅니다.

4. **DM을 검증합니다.** 에이전트에게 직접 메시지를 보내고 응답이 도착하는지 확인합니다.

5. **그룹을 별도로 검증합니다.** DM과 그룹은 다른 코드 경로를 사용합니다. DM 성공이 그룹 라우팅을 증명하지는 않습니다. 페어링된 그룹 채팅에서 에이전트에게 메시지를 보내고 응답이 도착하는지 확인합니다. 그룹이 조용해지면(에이전트 응답 없음, 오류 없음) Gateway 로그에서 `imessage: dropping group message from chat_id=<id>` 또는 시작 줄 `imessage: groupPolicy="allowlist" but channels.imessage.groups is empty`를 확인하세요. 둘 다 기본 로그 레벨에서 발생합니다. 둘 중 하나가 표시되면 `groups` 블록이 없거나 비어 있는 것입니다. 위의 "그룹 레지스트리 함정"을 참고하세요.

6. **액션 표면을 검증합니다** — 페어링된 DM에서 에이전트에게 반응, 수정, 전송 취소, 답장, 사진 전송, 그리고 그룹에서 그룹 이름 변경 / 참가자 추가 또는 제거를 요청합니다. 각 액션은 Messages.app에 네이티브로 도착해야 합니다. "iMessage `<action>` requires the imsg private API bridge" 오류가 발생하면 `imsg launch`를 다시 실행하고 `channels status --probe`를 새로고침하세요.

7. iMessage DM, 그룹, 액션이 검증되면 **BlueBubbles 서버와 구성을 제거합니다**. OpenClaw는 `channels.bluebubbles`를 사용하지 않습니다.

## 액션 동등성 한눈에 보기

| 액션                         | 레거시 BlueBubbles          | 번들 iMessage                                                          |
| -------------------------- | ------------------------ | -------------------------------------------------------------------- |
| 텍스트 전송 / SMS 폴백            | ✅                        | ✅                                                                    |
| 미디어 전송(사진, 동영상, 파일, 음성)    | ✅                        | ✅                                                                    |
| 스레드 답장(`reply_to_guid`)    | ✅                        | ✅ ([#51892](https://github.com/openclaw/openclaw/issues/51892) 해결)   |
| Tapback(`react`)           | ✅                        | ✅                                                                    |
| 수정 / 전송 취소(macOS 13+ 수신자)  | ✅                        | ✅                                                                    |
| 화면 효과와 함께 전송               | ✅                        | ✅ ([#9394](https://github.com/openclaw/openclaw/issues/9394)의 일부 해결) |
| 리치 텍스트 굵게 / 기울임 / 밑줄 / 취소선 | ✅                        | ✅ (attributedBody를 통한 typed-run 서식 지정)                               |
| 그룹 이름 변경 / 그룹 아이콘 설정       | ✅                        | ✅                                                                    |
| 참가자 추가 / 제거, 그룹 나가기        | ✅                        | ✅                                                                    |
| 읽음 확인 및 입력 표시기             | ✅                        | ✅ (private API 프로브에 의해 제한됨)                                          |
| 동일 발신자 DM 병합               | ✅                        | ✅ (DM 전용; `channels.imessage.coalesceSameSenderDms`로 옵트인)            |
| 재시작 후 인바운드 복구              | ✅ (Webhook 재생 + 기록 가져오기) | ✅ (자동: since\_rowid + 중복 제거로 누락분 재생; 로컬에서는 더 넓은 창)                   |

iMessage는 Gateway가 다운된 동안 놓친 메시지를 복구합니다. 시작 시 `imsg watch.subscribe`의 `since_rowid`를 통해 마지막 디스패치된 rowid부터 재생하고 GUID로 중복 제거하며, 오래된 백로그 age fence가 Push-flush "백로그 폭탄"을 억제합니다. 이는 `imsg` RPC 연결을 통해 실행되므로 원격 SSH `cliPath` 설정에서도 작동합니다. 로컬 설정은 `chat.db`를 읽을 수 있으므로 더 넓은 복구 창을 얻습니다. [브리지 또는 Gateway 재시작 후 인바운드 복구](/ko/channels/imessage#inbound-recovery-after-a-bridge-or-gateway-restart)를 참고하세요.

## 페어링, 세션, ACP 바인딩

* **페어링 승인**은 핸들 기준으로 이어집니다. 알려진 발신자를 다시 승인할 필요가 없습니다. `channels.imessage.allowFrom`은 BlueBubbles가 사용하던 동일한 `+15555550123` / `user@example.com` 문자열을 인식합니다.
* **세션**은 에이전트 + 채팅별로 범위가 유지됩니다. DM은 기본 `session.dmScope=main`에서 에이전트 메인 세션으로 합쳐지고, 그룹 세션은 `chat_id`별로 격리됩니다. 세션 키는 다릅니다(`agent:<id>:imessage:group:<chat_id>`와 BlueBubbles의 동등한 키). BlueBubbles 세션 키 아래의 기존 대화 기록은 iMessage 세션으로 이어지지 않습니다.
* `match.channel: "bluebubbles"`를 참조하는 **ACP 바인딩**은 `"imessage"`로 업데이트해야 합니다. `match.peer.id` 형태(`chat_id:`, `chat_guid:`, `chat_identifier:`, 단순 핸들)는 동일합니다.

## 롤백 채널 없음

되돌아갈 수 있는 지원되는 BlueBubbles 런타임은 없습니다. iMessage 검증이 실패하면 `channels.imessage.enabled: false`로 설정하고 Gateway를 다시 시작한 뒤, `imsg` 차단 요인을 수정하고 전환을 다시 시도하세요.

응답 캐시는 SQLite Plugin 상태에 있습니다. `openclaw doctor --fix`는 이전 `imessage/reply-cache.jsonl` 사이드카가 있으면 가져오고 보관합니다.

## 관련 항목

* [BlueBubbles 제거 및 imsg iMessage 경로](/ko/announcements/bluebubbles-imessage) — 짧은 공지와 운영자 요약.
* [iMessage](/ko/channels/imessage) — `imsg launch` 설정 및 기능 감지를 포함한 전체 iMessage 채널 참조.
* `/channels/bluebubbles` — 이 마이그레이션 가이드로 리디렉션되는 레거시 URL.
* [페어링](/ko/channels/pairing) — DM 인증 및 페어링 흐름.
* [채널 라우팅](/ko/channels/channel-routing) — Gateway가 아웃바운드 응답에 사용할 채널을 선택하는 방식.