OpenClaw를 위한 Apple Mail 채널 플러그인 구축하기

최근 저는 Apple Mail을 OpenClaw(AI 자동화 플랫폼)와 통합하여, AI 에이전트가 스레드별 세션 격리 (session isolation)를 통해 이메일을 모니터링하고 응답할 수 있도록 하는 플러그인을 구축하여 게시했습니다.

🎯 문제점

OpenClaw와 Hermes는 강력한 AI 자동화 플랫폼이지만, macOS에서 네이티브 Apple Mail 통합 기능이 부족했습니다. 사용자들은 다음과 같은 기능을 원했습니다:

• 여러 이메일 계정 모니터링
• AI 에이전트가 이메일에 자동으로 응답
• 이메일 스레드 전반에 걸친 대화 문맥 (context) 유지
• 서로 다른 이메일 대화를 격리된 상태로 유지

💡 해결책

저는 다음과 같은 기능을 갖춘 채널 플러그인인 @jehadurre/openclaw-apple-mail을 구축했습니다:

• AppleScript를 통한 Apple Mail 연결
• 이메일 스레드당 격리된 세션 생성
• HTML 이메일의 지능적 처리
• 다중 계정 설정 지원
• 발신자 허용 목록 (allowlists)과 같은 보안 기능 포함

🛠️ 기술 스택

• TypeScript - 타입 안전 (Type-safe) 개발
• AppleScript - 네이티브 macOS Mail.app 통합
• HTML 처리 (HTML Processing) - DOMPurify, jsdom, sanitize-html, marked
• 스키마 검증 (Schema Validation) - 설정 검증을 위한 Zod

📦 주요 기능

1. 스레드별 세션 격리 (Per-Thread Session Isolation)

각 이메일 대화는 고유한 격리된 세션을 할당받아 문맥 (context)이 섞이는 것을 방지합니다:

// 각 스레드는 고유한 세션 ID를 가집니다
const sessionId = `apple-mail:${threadId}`;

2. 다중 계정 지원 (Multi-Account Support)

독립적인 설정을 가진 여러 이메일 계정을 구성할 수 있습니다:

{
  "channels": {
    "apple-mail": {
...

3. 보안 기능

• 계정별 발신자 허용 목록 (allowlist)
• HTML 살균 (sanitization)
• AppleScript 샌드박싱 (sandboxing)

4. 스마트 HTML 처리 (Smart HTML Processing)

HTML 이메일을 깨끗한 마크다운 (markdown)으로 자동 변환합니다:

• 표 (Table) 추출 및 변환
• 트래킹 픽셀 (tracking pixels) 제거
• 악성 콘텐츠 살균
• AI 에이전트를 위한 서식 유지

📚 게시 과정

저는 이 플러그인을 여러 플랫폼에 게시했습니다:

1. npm 레지스트리 (npm Registry)

npm install @jehadurre/openclaw-apple-mail

2. GitHub

• 전체 소스 코드 (Full source code)
• 이슈 트래킹 (Issue tracking)
• 기여 가이드라인 (Contribution guidelines)
• MIT 라이선스 (MIT License)

3. ClawHub

openclaw plugins install @jehadurre/openclaw-apple-mail

4. OpenClaw Skill

포괄적인 설정 스킬 (setup skill)을 생성했습니다:

clawhub install apple-mail-setup

이 스킬에는 다음이 포함됩니다:

• 설치 가이드 (Installation guide)
• 5가지 설정 템플릿 (5 configuration templates)
• 문제 해결 솔루션 (Troubleshooting solutions)
• 모범 사례 (Best practices)

🎓 학습 내용 (Lessons Learned)

1. 컴파일된 출력물 (Compiled Output)의 중요성

ClawHub는 단순한 TypeScript 소스 코드가 아닌 컴파일된 JavaScript를 필요로 합니다. 저는 다음 작업을 수행해야 했습니다:

• 프로덕션 배포 (production deployment)로부터 컴파일된 출력물 확보
• 패키지에 index.js 포함
• 컴파일된 파일을 참조하도록 package.json 업데이트

2. 스킬을 통한 도입 촉진 (Skills Enhance Adoption)

사용자에게 플러그인을 설정하고 사용하는 방법을 가르쳐주는 별도의 "스킬 (skill)" 패키지를 만드는 것은 사용자 경험을 크게 향상시킵니다.

3. 멀티 플랫폼 게시 (Multi-Platform Publishing)

npm, GitHub, ClawHub에 게시하고 GitHub Pages에 문서를 작성하는 것은 발견 가능성 (discoverability)을 극대화합니다.

🚀 사용 예시 (Usage Example)

사용자가 설정하는 방법은 다음과 같습니다:

1단계: 설치 (Install)

openclaw plugins install @jehadurre/openclaw-apple-mail
clawhub install apple-mail-setup

2단계: 구성 (Configure)

openclaw.json에 추가합니다:

{
  "channels": {
    "apple-mail": {
...

3단계: 시작 (Start)

openclaw start

끝입니다! 이제 OpenClaw가 귀하의 이메일을 모니터링하고 자동으로 응답할 수 있습니다.

📊 아키텍처 (Architecture)

사용자 이메일 → Apple Mail.app
              ↓ (AppleScript)
           플러그인 모니터 (Plugin Monitor)
...

🔐 보안 고려 사항 (Security Considerations)

1. 발신자 화이트리스트 (Sender Allowlist): 신뢰할 수 있는 발신자의 이메일만 처리
2. HTML 산리타이제이션 (HTML Sanitization): HTML 이메일에서 악성 콘텐츠 제거
3. AppleScript 샌드박싱 (AppleScript Sandboxing): Mail.app API에 대한 제한된 접근
4. 자격 증명 저장 안 함 (No Credential Storage): 기존 Apple Mail 계정 사용

🌟 향후 개선 사항 (Future Enhancements)

계획된 기능:

🌟 향후 개선 사항 (Future Enhancements)

계획된 기능:

• 스마트 답장 제안 (Smart reply suggestions)
• 첨부 파일 처리 (Attachment handling)
• 이메일 분류 (Email categorization)
• 사용자 지정 이메일 템플릿 (Custom email templates)
• 다른 채널과의 통합 (Integration with other channels)

📖 자료 (Resources)

• GitHub: https://github.com/JehadurRE/openclaw-apple-mail
• npm: https://www.npmjs.com/package/@jehadurre/openclaw-apple-mail
• 문서 (Documentation): https://openclaw-apple-mail.jehadurre.me
• 설치 명령어: clawhub install apple-mail-setup

🤝 기여 (Contributing)

기여를 환영합니다! 기여 가이드(Contributing Guide)를 확인해 보세요.

💬 피드백 (Feedback)

이메일 자동화에 AI를 사용해 본 적이 있나요? 어떤 기능들이 추가되기를 바라시나요? 댓글로 알려주세요!

저에 대하여: 저는 AI 자동화 및 생산성 도구에 열정을 가진 개발자 Md. Jehadur Rahman (Emran)입니다. GitHub와 제 웹사이트에서 저를 찾아보세요.

라이선스: MIT - 사용, 수정 및 재배포가 자유롭습니다!