튜토리얼 카테고리 Skills 소개
ZH EN JA KO
📧

Gmail

이메일 메시징 및 소셜

설치 명령어

npx clawhub@latest install gmail

설치 안내

1
환경 확인

Node.js 22 이상과 OpenClaw가 설치되어 있는지 확인하세요. 터미널에서 openclaw --version을 실행하여 확인할 수 있습니다.

2
설치 실행

위의 설치 명령어를 터미널에서 실행하세요. ClawHub가 자동으로 Gmail을(를) ~/.openclaw/skills/ 디렉토리에 다운로드하고 설치합니다.

3
설치 확인

openclaw skills list를 실행하여 설치된 스킬 목록을 확인하고, Gmail이(가) 목록에 표시되는지 확인하세요.

4
매개변수 설정 (선택사항)

아래 소개의 설정 안내에 따라 ~/.config/openclaw/openclaw.json5에 스킬 설정 항목을 추가하세요.

수동 설치 방법: Skill 폴더를 ~/.openclaw/skills/ 또는 프로젝트의 skills/ 디렉토리에 복사하세요. 폴더에 SKILL.md 파일이 포함되어 있어야 합니다.
이메일 송수신 첨부파일 관리 자동 분류

상세 소개

Gmail 스킬은 OpenClaw가 Gmail 메일함을 직접 관리하게 해주어, 자연어로 이메일 송수신, 검색, 라벨 관리 등의 작업을 수행하여 이메일 처리 효율을 크게 향상시킵니다.

핵심 기능

  • 이메일 읽기: 조건별 이메일 검색 및 내용 읽기, Gmail 검색 구문 지원
  • 이메일 발송: 이메일 작성 및 발송, 참조, 숨은참조, HTML 형식 본문 지원
  • 첨부파일 처리: 이메일 첨부파일 내용 읽기 또는 이메일 발송 시 첨부파일 추가
  • 라벨 관리: 이메일에 자동 라벨 추가, 보관, 읽음 표시
  • 임시보관함 관리: 이메일 임시보관함 생성 및 편집

설정 방법

사용 전 Google Cloud Console에서 OAuth 자격 증명을 생성하고 인증해야 합니다. 설치 후 첫 실행 시 인증 절차를 안내합니다.

{
  skills: {
    gmail: {
      credentialsPath: "~/.openclaw/gmail-creds.json",
      maxResults: 10,
      autoLabel: true
    }
  }
}

사용 시나리오

  • 「지난주에 John이 보낸 프로젝트 진행 상황 이메일 찾아줘」
  • 「마케팅팀 전체에 회의 알림 이메일 보내줘」
  • 「오늘 답장해야 할 중요한 이메일이 있어?」
  • [email protected]에서 온 모든 이메일을 보관 처리해 줘」

보안 안내

이메일 자격 증명은 로컬에 저장되며 제3자 서버에 업로드되지 않습니다. 필요한 권한 범위(scope)만 부여하고, OAuth 인증 상태를 정기적으로 확인하는 것을 권장합니다.