iMessage 채널 추가 (NanoClaw)
NanoClaw 에이전트에 iMessage 채널을 로컬(Mac chat.db) 또는 호스티드(photon.codes) 백엔드로 연결해 주는 설치 스킬입니다.
자동화·워크플로고급★ 30,471⑂ 12,865AI 점수 7/10마지막 업데이트: 2026. 8. 9.
무엇을 해주나
NanoClaw 프로젝트에 imessage 채널을 추가하는 전 과정을 단계별로 실행합니다.
- 백엔드 선택:
local(이 Mac에 로그인된 iMessage 계정의chat.db를 직접 읽음, macOS 전용) 또는hosted(photon.codes의 관리형 회선, OS 무관). channels브랜치에서 통합 iMessage 어댑터와 테스트 파일을 복사하고, 채널 배럴(src/channels/index.ts)에 자기 등록 import 한 줄을 추가합니다.- 선택한 백엔드의 패키지를 정확한 버전으로 핀 고정해 설치합니다(
chat-adapter-imessage@0.1.1또는spectrum-ts@11.0.0). - 빌드와 등록 테스트를 돌려 채널이 실제로 레지스트리에 붙었는지 검증합니다.
- 로컬은 Node 바이너리에 전체 디스크 접근 권한을 부여하는 안내를, 호스티드는 기기 로그인 마법사(프로젝트 프로비저닝 → 번호 등록 → 첫 문자 옵트인)를 진행합니다.
모든 명령이 nc: 디렉티브로 표기되어 있고 멱등성이 보장되므로, 중간에 실패해도 스킬 전체를 다시 실행할 수 있습니다.
이런 분께 추천
- NanoClaw로 개인 AI 에이전트를 운영하며 iMessage로 대화하고 싶은 분
- Mac 릴레이 서버를 두지 않고 어떤 OS에서든 iMessage 회선을 붙이고 싶은 분
- 채널 어댑터 설치·검증 과정을 사람이 아니라 에이전트가 자동으로 수행하길 원하는 분
주의: NanoClaw 저장소 밖에서는 의미가 없고, pnpm·tsx·vitest 기반 개발 환경 지식이 필요합니다.
활용 예시
- 맥북에서 로컬 연결: "add imessage"라고 요청 → 백엔드
local선택 → Node에 전체 디스크 접근 권한 부여 →+8210...핸들 등록 → 재시작 후 자기 자신과의 iMessage 대화창에서 에이전트가 인사. - 리눅스 서버에 호스티드 연결: 백엔드
hosted선택 → 기기 로그인 URL/코드 승인 → 배정받은 iMessage 번호로 문자 1건 발송(옵트인) → 이후 어디서든 iMessage로 에이전트와 대화. - 문제 해결: 메시지가 안 오면
imessage-registration.test.ts를 돌려 배럴 등록 여부를 확인하고, 호스티드는grep "Photon channel connected" logs/nanoclaw.log로 연결 상태를 점검.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 nanocoai/nanoclaw 의 .claude/skills/add-imessage 폴더를 내 ~/.claude/skills/add-imessage/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/nanocoai/nanoclaw.git && mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-imessage ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 열고 작업할 폴더로 이동합니다.
- NanoClaw 저장소를 클론합니다:
git clone https://github.com/nanocoai/nanoclaw.git - 스킬 폴더를 Claude Code 스킬 경로로 복사합니다:
mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-imessage ~/.claude/skills/ cd nanoclaw후pnpm install로 의존성을 설치하고 프로젝트가 정상 빌드되는지(pnpm run build) 확인합니다.- NanoClaw 저장소 폴더에서 Claude Code를 실행합니다(
claude). - 대화창에 "add imessage" 또는 "connect imessage"라고 입력해 스킬을 실행합니다.
- 백엔드를
local(Mac 전용) 또는hosted(photon.codes)로 답하고, 이후 안내에 따라 권한 부여 또는 기기 로그인을 완료합니다. - 마지막에
bash setup/lib/restart.sh로 서비스가 재시작되면, 자신의 iMessage로 문자를 한 번 보내 연결을 확인합니다.
GitHub에서 원본 보기 ↗라이선스: MIT