​

iMessage (레거시: imsg)

​

빠른 설정

brew install steipete/tap/imsg
imsg rpc --help

{
  channels: {
    imessage: {
      enabled: true,
      cliPath: "/usr/local/bin/imsg",
      dbPath: "/Users/<you>/Library/Messages/chat.db",
    },
  },
}

openclaw gateway

openclaw pairing list imessage
openclaw pairing approve imessage <CODE>

#!/usr/bin/env bash
exec ssh -T gateway-host imsg "$@"

{
  channels: {
    imessage: {
      enabled: true,
      cliPath: "~/.openclaw/scripts/imsg-ssh",
      remoteHost: "user@gateway-host", // SCP 첨부 파일 가져오기에 사용됨
      includeAttachments: true,
      // 선택 사항: 허용된 첨부 파일 루트를 재정의합니다.
      // 기본값에는 /Users/*/Library/Messages/Attachments가 포함됩니다.
      attachmentRoots: ["/Users/*/Library/Messages/Attachments"],
      remoteAttachmentRoots: ["/Users/*/Library/Messages/Attachments"],
    },
  },
}

​

요구 사항 및 권한(macOS)

• imsg를 실행하는 Mac에서 Messages에 로그인되어 있어야 합니다.
• OpenClaw/imsg를 실행하는 프로세스 컨텍스트에는 전체 디스크 접근 권한이 필요합니다(Messages DB 접근).
• Messages.app을 통해 메시지를 보내려면 자동화 권한이 필요합니다.

imsg chats --limit 1
# 또는
imsg send <handle> "test"

​

액세스 제어 및 라우팅

​

ACP 대화 바인딩

• DM 또는 허용된 그룹 채팅 안에서 /acp spawn codex --bind here를 실행합니다.
• 이후 같은 iMessage 대화의 메시지는 생성된 ACP 세션으로 라우팅됩니다.
• /new와 /reset은 같은 바인딩된 ACP 세션을 제자리에서 재설정합니다.
• /acp close는 ACP 세션을 닫고 바인딩을 제거합니다.

• +15555550123 또는 user@example.com 같은 정규화된 DM 핸들
• chat_id:<id> (안정적인 그룹 바인딩에 권장)
• chat_guid:<guid>
• chat_identifier:<identifier>

{
  agents: {
    list: [
      {
        id: "codex",
        runtime: {
          type: "acp",
          acp: { agent: "codex", backend: "acpx", mode: "persistent" },
        },
      },
    ],
  },
  bindings: [
    {
      type: "acp",
      agentId: "codex",
      match: {
        channel: "imessage",
        accountId: "default",
        peer: { kind: "group", id: "chat_id:123" },
      },
      acp: { label: "codex-group" },
    },
  ],
}

​

배포 패턴

{
  channels: {
    imessage: {
      enabled: true,
      cliPath: "~/.openclaw/scripts/imsg-ssh",
      remoteHost: "bot@mac-mini.tailnet-1234.ts.net",
      includeAttachments: true,
      dbPath: "/Users/bot/Library/Messages/chat.db",
    },
  },
}

#!/usr/bin/env bash
exec ssh -T bot@mac-mini.tailnet-1234.ts.net imsg "$@"

​

미디어, 청킹 및 전달 대상

imsg chats --limit 20

​

구성 쓰기

{
  channels: {
    imessage: {
      configWrites: false,
    },
  },
}

​

문제 해결

imsg rpc --help
openclaw channels status --probe

imsg chats --limit 1
imsg send <handle> "test"

​

구성 참조 포인터

• 구성 참조 - iMessage
• 게이트웨이 구성
• 페어링
• BlueBubbles

​

관련 항목

• 채널 개요 — 지원되는 모든 채널
• 페어링 — DM 인증 및 페어링 흐름
• 그룹 — 그룹 채팅 동작 및 멘션 게이팅
• 채널 라우팅 — 메시지용 세션 라우팅
• 보안 — 액세스 모델 및 강화