geziel16/google-workspace-스킬

google-workspace-스킬은(는) 무엇을 하나요?

구조화된 JSON 명령어를 사용하여 Google Workspace 서비스를 제어하는 OpenClaw 스킬입니다. 이 스킬은 공식 Google Workspace CLI를 래핑합니다.

개요

이 스킬은 AI 에이전트(예: Claude Code, Cursor, Codex)가 표준 JSON 페이로드를 통해 Google Workspace 서비스와 상호 작용할 수 있도록 합니다. 복잡한 CLI 명령어를 외울 필요 없이 간단한 JSON 요청을 보내는 것만으로 사용자, 이메일, 문서, 캘린더 등을 관리할 수 있습니다.

지원 서비스

• Gmail: 이메일 보내기, 받은편지함 검색, 라벨 관리
• Google 캘린더: 일정 만들기/업데이트/삭제, 일정 조회
• Google 드라이브: 파일 업로드/다운로드/공유, 폴더 관리
• Google 문서: 문서 생성 및 편집
• Google 시트: 스프레드시트 생성, 데이터 읽기/쓰기
• Google 슬라이드: 프레젠테이션 생성 및 편집
• Google 미트: 미팅 만들기 및 관리
• Google 채팅: 메시지 보내기, 스페이스 관리

사전 요구 사항

1. Google Workspace 계정 (관리자 권한 필요)
2. Google Cloud 프로젝트 설정 및 API 사용 설정
3. OAuth 2.0 클라이언트 ID 생성 (데스크톱 앱 유형)
4. OpenClaw 런타임 설치

설치

# OpenClaw 스킬 저장소에 이 저장소 클론
openclaw skill install geziel16/google-workspace-skill

인증

스킬은 OAuth 2.0을 사용하여 Google Workspace에 인증합니다. 첫 번째 요청 시 인증 흐름이 트리거되며, 자격 증명은 나중에 사용하기 위해 안전하게 저장됩니다.

# 인증 시작
openclaw skill run google-workspace skill.json -p '{"action": "auth", "service": "gmail"}'

JSON 명령어 형식

모든 요청은 다음 구조의 JSON 객체여야 합니다:

{
  "action": "명령어_이름",
  "service": "서비스_이름",
  "params": {
    "key1": "value1",
    "key2": "value2"
  }
}

사용 예시

Gmail: 이메일 보내기

{
  "action": "send_email",
  "service": "gmail",
  "params": {
    "to": "[email protected]",
    "subject": "안녕하세요",
    "body": "이것은 테스트 이메일입니다."
  }
}

Google 캘린더: 일정 만들기

{
  "action": "create_event",
  "service": "calendar",
  "params": {
    "summary": "팀 회의",
    "start_time": "2024-01-15T09:00:00Z",
    "end_time": "2024-01-15T10:00:00Z",
    "attendees": ["[email protected]", "[email protected]"]
  }
}

Google 드라이브: 파일 공유

{
  "action": "share_file",
  "service": "drive",
  "params": {
    "file_id": "1abc123def456",
    "email": "[email protected]",
    "role": "writer"
  }
}

전체 명령어 목록

서비스	명령어	설명
gmail	send_email	이메일 보내기
gmail	list_emails	받은편지함 검색
gmail	manage_labels	라벨 생성/삭제
calendar	create_event	일정 만들기
calendar	list_events	일정 조회
calendar	update_event	일정 수정
calendar	delete_event	일정 삭제
drive	upload_file	파일 업로드
drive	download_file	파일 다운로드
drive	share_file	파일 공유
drive	list_files	파일 목록 보기
docs	create_doc	문서 만들기
docs	edit_doc	문서 편집
sheets	create_sheet	시트 만들기
sheets	write_data	데이터 쓰기
slides	create_presentation	프레젠테이션 만들기
meet	create_meeting	미팅 만들기
chat	send_message	메시지 보내기

오류 처리

스킬은 다음 구조의 JSON 객체를 반환합니다:

{
  "success": true/false,
  "data": { ... },  // 성공 시
  "error": "오류 메시지"  // 실패 시
}

라이선스

MIT

기여하기

이슈 또는 풀 리퀘스트를 환영합니다. 자세한 내용은 CONTRIBUTING.md를 참조하세요.