채널 통합

OpenClaw를 iMessage에 연결하기

macOS의 Apple 메시지 앱을 통해 AI 어시스턴트를 직접 사용하세요. iMessage와 SMS 모두 지원합니다.

macOS 전용

iMessage 통합은 메시지 앱이 설정된 macOS가 필요합니다. 로컬 메시지 데이터베이스에서 읽기 위해 imsg CLI 도구를 사용합니다.

왜 iMessage를 사용해야 할까요?

+네이티브 Apple 통합 — 기존 메시지 앱과 함께 작동
+iMessage + SMS — 두 프로토콜을 원활하게 지원
+읽음 확인 — 메시지가 전달되고 읽혔는지 확인
+리액션 — iMessage 리액션 지원
+그룹 채팅 — 그룹 대화에 참여
+원격 게이트웨이 — SSH를 통해 원격 Mac에서 작동 가능

요구 사항

1.
macOS
메시지 앱이 설정되고 Apple ID에 로그인된 상태
2.
전체 디스크 접근 권한
OpenClaw가 ~/Library/Messages/chat.db를 읽는 데 필요
3.
imsg CLI
메시지와 상호 작용하기 위한 명령줄 도구

설정 단계

imsg CLI 설치

OpenClaw가 메시지와 상호 작용하는 데 사용하는 imsg 명령줄 도구를 설치하세요:

brew install imsg

또는 imsg GitHub 릴리스 페이지에서 다운로드

전체 디스크 접근 권한 부여

OpenClaw는 메시지 데이터베이스를 읽는 권한이 필요합니다:

- 시스템 설정 (또는 시스템 환경설정) 열기
- 개인정보 보호 및 보안 > 전체 디스크 접근으로 이동
- + 버튼을 클릭하고 터미널 (또는 iTerm) 추가
- 바이너리로 실행하는 경우 OpenClaw 실행 파일도 추가

OpenClaw 설정

openclaw.json 설정 파일에 iMessage 구성을 추가하세요:

{
  "channels": {
    "imessage": {
      "enabled": true,
      "cliPath": "imsg",
      "dbPath": "~/Library/Messages/chat.db",
      "allowFrom": ["+15555550123", "user@example.com"]
    }
  }
}

allowFrom 설정

봇과 상호 작용할 수 있는 사람을 지정하세요:

- 국가 코드가 포함된 전화번호: +15555550123
- Apple ID (이메일 주소): user@example.com

연결 테스트

iMessage 채널이 작동하는지 확인하세요:

openclaw channels status imessage

그런 다음 허용된 연락처에서 메시지를 보내 통합을 테스트하세요.

고급 설정

iMessage 채널을 위한 전체 설정 옵션:

{
  "channels": {
    "imessage": {
      "enabled": true,
      "cliPath": "imsg",
      "dbPath": "~/Library/Messages/chat.db",
      "remoteHost": "user@gateway-host",
      "dmPolicy": "pairing",
      "allowFrom": ["+15555550123", "user@example.com"],
      "historyLimit": 50,
      "includeAttachments": false,
      "mediaMaxMb": 16,
      "service": "auto",
      "region": "US"
    }
  }
}

cliPath — imsg CLI 실행 파일 경로
dbPath — 메시지 데이터베이스 경로
remoteHost — 원격 게이트웨이 설정을 위한 SSH 호스트
dmPolicy — 다이렉트 메시지 처리 방법
allowFrom — 메시지가 허용된 전화번호 또는 Apple ID
historyLimit — 컨텍스트로 포함할 메시지 수
includeAttachments — 첨부 파일 처리 활성화
mediaMaxMb — 최대 첨부 파일 크기 (MB)
service — iMessage 또는 SMS 강제, 또는 자동 사용
region — 전화번호 서식을 위한 지역

원격 게이트웨이 설정 (선택사항)

서버에서 OpenClaw를 실행하지만 집에 있는 Mac에서 iMessage에 접근하려면 SSH를 사용할 수 있습니다:

{
  "channels": {
    "imessage": {
      "enabled": true,
      "remoteHost": "user@your-mac.local",
      "cliPath": "/usr/local/bin/imsg"
    }
  }
}

- SSH 키 인증이 설정되어 있는지 확인
- Mac은 항상 켜져 있고 연결되어 있어야 함
- Mac에 imsg와 전체 디스크 접근이 설정되어 있어야 함

지원되는 기능

지원읽음 확인

지원iMessage 리액션

지원그룹 채팅

지원SMS 지원

선택첨부 파일 (선택사항)

지원메시지 기록

문제 해결

chat.db를 읽을 때 권한이 거부되나요?

터미널/iTerm과 OpenClaw 실행 파일에 전체 디스크 접근 권한을 부여했는지 확인하세요. 권한 부여 후 터미널을 재시작해야 할 수 있습니다.

봇이 메시지에 응답하지 않나요?

allowFrom의 전화번호 또는 Apple ID가 정확히 일치하는지 확인하세요. 전화번호에는 +와 국가 코드가 필요합니다.

chat.db를 찾을 수 없나요?

기본 경로는 ~/Library/Messages/chat.db입니다. 메시지 앱을 최소 한 번 열었고 로그인되어 있는지 확인하세요.

imsg 명령을 찾을 수 없나요?

imsg가 설치되어 있고 PATH에 있는지 확인하세요. cliPath에 전체 경로를 지정할 수 있습니다.

원격 게이트웨이가 연결되지 않나요?

ssh user@host로 SSH 키 인증이 작동하는지 확인하고 원격 Mac에 imsg가 설치되어 있고 전체 디스크 접근이 있는지 확인하세요.

iMessage 연결 완료!

더 많은 채널을 추가하거나 스킬을 설정하여 AI 어시스턴트를 사용자 정의하세요.

WhatsApp 추가 스킬 탐색