REFERENCE · FAQ

자주 묻는 질문

설치, 결제, 사용법에 대한 답변을 카테고리별로 정리했어요.

Creator OS FAQ

자주 묻는 질문이에요. 각 질문을 클릭하면 답변이 펼쳐져요. 해결되지 않으면 페이지 맨 아래 문의 채널로 알려주세요.


설치

권한 4종 (AX / SCR / FDA / AUTO)이 정확히 뭔가요?

위자드에서 요청하는 4가지 권한은 모두 macOS 시스템 권한이에요.

  • AX (Accessibility / 손쉬운 사용) — 키보드/마우스 입력을 자동화하기 위한 권한이에요. 에이전트가 사용자 대신 클릭하거나 타이핑할 때 사용해요.
  • SCR (Screen Recording / 화면 녹화) — 스크린샷을 찍어서 AI가 화면 맥락을 인식하기 위한 권한이에요. 영상 녹화나 외부 전송 용도가 아니에요.
  • FDA (Full Disk Access / 전체 디스크 접근) — 컨텍스트 파일 읽기와 작업 결과물 저장을 위한 권한이에요.
  • AUTO (Automation / 자동화) — Safari 같은 다른 앱을 제어해 Discord 봇 자동 생성, MFA 분기 등을 수행하기 위한 권한이에요.

이 권한들의 자세한 사용 범위는 이용약관 제4조에 표 형태로 명시돼 있어요.

다른 봇 설치 가이드에는 있던 "입력 모니터링(Input Monitoring)" 권한 카드가 없어요. 왜 빠졌나요?

좋은 관찰이세요. v0.2.30 (2026-05-10)부터 Input Monitoring 권한을 영구적으로 제거했어요.

처음에는 5종 권한(IM 포함)을 요청했는데, macOS Tahoe 26.x 환경에서 IM 권한 다이얼로그가 정상적으로 자동 발사되지 않는 Apple 자체 이슈가 확인됐어요. 진단 결과 Creator OS 출시 범위에는 IM 권한을 실제로 사용하는 코드가 0건이라서 카드 자체를 제거하는 게 맞다고 판단했어요.

추후 글로벌 단축키 같은 기능이 추가되면 deep link + polling 패턴으로 안전하게 재도입할 예정이에요. 현재 출시 버전에서는 권한 카드 4종(AX/SCR/FDA/AUTO)만 통과하시면 충분해요.

macOS Tahoe 26.x를 쓰고 있는데 호환되나요?

네, macOS Tahoe 26.2 기준으로 검증 완료된 상태예요. 출시 직전 v0.4.5까지 Tahoe 환경에서 발견된 호환성 이슈들을 모두 픽스했어요. 주요 픽스 내역은 다음과 같아요.

  • pywebview 위자드 창이 표시되지 않던 race condition (v0.2.19 ~ v0.2.21)
  • 권한 체크 false positive 2건 (v0.2.22)
  • LaunchServices DB 7-way path 오염 (v0.2.33)
  • close_wizard 무한 바람개비 + Script Editor 알림 (v0.4.4)
  • 위자드 poll_bot_ready 3-Gate 안정화 (v0.4.5)

Sequoia 15.x와 Sonoma 14.x도 지원해요. Ventura 13.x 이하는 공식 지원 대상이 아니에요.

첫 실행 후 위자드 창이 안 떠요. 어떻게 해야 하나요?

대부분 권한 다이얼로그 race 또는 Gatekeeper quarantine 잔존이 원인이에요. 다음 순서로 시도해주세요.

  1. Creator OS를 완전히 종료해주세요. 메뉴바에서 우클릭 → 종료, 또는 활성 상태 보기에서 Creator OS 프로세스를 종료해주세요.
  2. Launchpad에서 Creator OS 우클릭 → 열기로 다시 실행해주세요.
  3. 그래도 위자드가 안 뜨면 로그 파일을 확인해주세요 — ~/Library/Application Support/Creator OS/logs/launcher.log
  4. 위 절차로도 해결이 안 되면 Helper Bot DM으로 launcher.log 마지막 100줄을 보내주세요. 보통 5분 안에 진단해드려요.

v0.4.4 부터는 위자드 종료 시 발생하던 무한 로딩(close_wizard 바람개비)도 자동으로 해소돼요.

위자드 중간에 권한을 잘못 거부했어요. 다시 시작할 수 있나요?

네, 가능해요. 시스템 환경설정 → 개인정보 보호 및 보안에서 해당 권한 항목(예: 손쉬운 사용)을 찾아 Creator OS 토글을 켜주시면 돼요. 그 후 위자드 화면의 [새로고침] 버튼을 누르시면 권한 상태가 자동으로 다시 감지돼요.

위자드 자체를 처음부터 다시 시작하고 싶으시면 메뉴바 아이콘에서 [설정 마법사 다시 실행]을 선택해주세요.

위자드의 9단계가 정확히 어떤 순서로 진행되나요?

v0.4.x 부터 위자드는 다음 9단계로 진행돼요. 각 단계는 자동 진행 또는 사용자 입력 대기 상태가 명확히 표시돼요.

  1. 사용자 별칭 입력 — 에이전트가 부를 호칭을 입력 (SSOT .env CREATOR_OS_USER_NAME)
  2. 이용약관 동의 — 인라인 약관 표시 + 동의 체크
  3. 필수 권한 부여 — AX/SCR/FDA/AUTO 4종 토글 (위 권한 안내 참고)
  4. 데이터베이스 자동 구성 — 동봉된 PostgreSQL 시동 + DB/스키마 자동 생성
  5. Claude CLI 로그인 — Claude CLI 설치 + Anthropic 계정 로그인/매핑
  6. Safari로 Discord 봇 만들기 — Discord 로그인 → Developer Portal 자동 진입 → 봇 생성 → 토큰 발급 → Public Bot OFF + Presence Intent ON (MFA가 켜져 있으면 자동 분기)
  7. 백그라운드 서비스 등록 — launchd 등록 (재시작 시에도 자동 가동)
  8. Discord 서버에 봇 초대 — OAuth invite → on_guild_join 트리거 → 5개 인박스 채널 자동 생성
  9. 설치 완료poll_bot_ready 3-Gate (봇 가동 + 채널 생성 + 첫 메시지 도달) 폴링 + 완료 카드

전체 소요 시간은 약 3~4분이에요 (자동 약 90초 + 사용자 입력 약 90초).


활성화 코드

결제 후 활성화 코드는 어디로 와요?

결제 완료 시점에 두 경로로 발송돼요.

  • 이메일 — 결제 시 입력한 이메일로 6자리 활성화 코드와 Helper Bot 초대 링크가 발송돼요.
  • SMS — 결제 시 등록한 휴대폰 번호로도 동일한 코드가 발송돼요 (백업 채널).

메일이 안 보이면 스팸함과 프로모션 탭도 꼭 확인해주세요. 일부 메일 클라이언트에서 자동 분류될 수 있어요.

활성화 코드 만료 시간이 얼마나 되나요?

활성화 코드는 발급 시점부터 24시간 동안 유효해요. 24시간이 지나면 자동으로 만료되고, 보안상 같은 코드는 재사용할 수 없어요.

만료된 경우 Helper Bot DM에서 !resend 명령어를 입력해주시면 새 코드가 발급돼요.

활성화 코드를 분실했어요. 재발급할 수 있나요?

네, Helper Bot DM에서 !resend 명령어를 입력하시면 즉시 재발급돼요. 결제 시 사용한 이메일 주소와 SMS로 새 코드가 함께 발송돼요.

!resend는 24시간 내 최대 3회까지 사용 가능해요. 그 이상 필요하시면 [email protected]으로 메일 주시거나 Helper Bot DM으로 문의해주세요.

Helper Bot이 제 Discord 서버에 들어와 있지 않아요.

Helper Bot은 자동으로 사용자 서버에 들어가지 않아요. 결제 안내 메일/SMS에 포함된 Helper Bot 초대 링크를 통해 직접 본인 Discord 계정 또는 본인 소유 서버에 초대해주세요.

초대 링크가 안 보이면 다음 위치를 확인해주세요.

  1. 결제 안내 메일 본문 하단의 "Helper Bot 초대하기" 버튼
  2. 안 보이면 [email protected]으로 메일 주세요. 결제 이메일 주소를 알려주시면 5분 내 초대 링크를 다시 보내드려요.
활성화 코드 입력은 어디서 하나요?

Helper Bot을 본인 서버에 초대하시면 자동으로 DM이 와요. 그 DM에서 /activate {6자리 코드} 슬래시 커맨드를 입력하시면 활성화돼요.

활성화가 완료되면 Helper Bot이 자동으로 DMG 다운로드 링크를 DM으로 보내드려요. 그 링크로 받은 DMG를 설치하시면 돼요.

코드를 입력했는데 "유효하지 않은 코드"라고 떠요.

다음 3가지 중 하나일 가능성이 높아요.

  1. 24시간이 지나서 만료된 경우!resend로 재발급해주세요.
  2. 이미 사용한 코드를 재입력한 경우 → 활성화 코드는 1회용이에요. 새 코드를 발급받아 주세요.
  3. 공백/대소문자 오타 → 6자리 숫자만 띄어쓰기 없이 정확하게 입력해주세요.

세 가지 모두 아닌 경우 Helper Bot DM 메시지 스크린샷과 함께 [email protected]으로 메일 주시면 즉시 확인해드려요.


결제 · 환불

결제 금액과 기간이 어떻게 되나요?

Creator 단일 플랜이에요. 결제 수단(카드 결제)은 결제대행사를 통해 안전하게 처리돼요.

한 번 구매하시면 봇은 평생 사용하실 수 있어요. 12개월 동안 매월 1,000 크레딧과 무료 업데이트가 함께 들어와요.

자세한 결제 정보는 환불 정책 제1조에 표로 정리돼 있어요.

갱신은 어떻게 처리되나요?

자동 갱신 자체가 없어요. 한 번 결제하시면 봇은 평생 사용하실 수 있고, 12개월 무료 업데이트가 만료되는 시점에 별도로 안내드릴게요.

webhook 지연 같은 예외 상황에 대비해 약간의 유예 시간(grace period)이 자동으로 포함돼요. 정상 결제자가 시간차로 차단되는 일은 없어요.

환불은 언제 가능한가요?

결제 후 3일 이내에 요청하면 환불 가능해요 (크레딧이 사용된 경우 제외).

가입한 멤버에게 영구 회원번호가 부여된다고 들었어요.

네, 결제 완료 시점에 단 한 번만 발급되는 영구 회원번호 (Member #N) 가 부여돼요. 이 번호는 해지하셔도 회수되지 않고, 재가입하셔도 새 번호로 바뀌지 않는 영구 식별자예요.

  • 가입 순서대로 1번부터 순차 발급
  • 환불·해지하셔도 번호는 유지 (재가입 시 같은 번호 그대로)
  • 메일·앱 안내문 푸터에 자동 표시 (조회 별도 불필요)

초기 멤버라는 사실 자체가 영구히 남아요.

환불 신청은 어떻게 하나요?

[email protected]으로 다음 정보를 포함해 메일 주세요.

  • 결제 시 사용한 이메일 주소
  • 결제 일자 및 금액
  • 환불 사유

접수 후 5 영업일 이내 처리돼요. 자세한 절차는 환불 정책 제4조에 명시돼 있어요.

결제대행사에서 환불 신청하면 어떻게 되나요?

결제대행사 자체 환불 정책이 본 정책보다 강한 소비자 보호를 제공하는 경우, 결제대행사 정책이 우선 적용될 수 있어요. 결제대행사 고객센터를 통해 신청하셔도 되고, 운영자에게 직접 신청하셔도 돼요. 결과는 동일해요.


재설치 · 이전

다른 Mac에서도 같은 라이센스로 사용할 수 있나요?

네, 구매자 본인 소유 Mac이라면 여러 대에서 사용 가능해요 (이용약관 제5조). 단, 각 Mac에 봇이 독립적으로 설치되기 때문에 봇 토큰은 Mac마다 다르게 발급돼요.

1인 1라이센스 원칙이라서 가족이나 동료에게 양도/공유하시면 안 돼요. 라이센스 우회 시도가 감지되면 이용약관 제6조에 따라 이용이 제한될 수 있어요.

Mac을 새로 샀어요. 기존 라이센스를 옮길 수 있나요?

네, 가능해요. 다음 절차를 따라주세요.

  1. 새 Mac에서 Helper Bot 초대 + 활성화 코드를 입력해주세요 (이메일은 동일하게 사용).
  2. 새 Mac에 DMG를 설치하고 위자드를 진행해주세요.
  3. 위자드가 자동으로 새 봇 토큰을 발급하고 기존 데이터베이스와는 분리된 상태로 시동돼요.

기존 Mac의 데이터(Discord 메시지 이력, 에이전트 메모리)는 자동으로 이전되지 않아요. 필요하시면 아래 Q4.3 백업 절차를 참고해주세요.

데이터 백업은 어떻게 하나요?

Creator OS는 모든 데이터를 사용자 Mac 로컬 PostgreSQL에 저장해요. 다음 두 경로를 백업하시면 돼요.

  • PostgreSQL 데이터~/Library/Application Support/Creator OS/postgres/ 폴더 전체
  • 봇 설정~/Library/Application Support/Creator OS/.env 파일 (봇 토큰 포함, 권한 600으로 저장됨)

복원하실 때는 새 Mac의 동일 경로에 복사한 뒤 Creator OS를 시동하시면 돼요. 단, 봇 토큰을 복사해서 새 Mac에서 사용하면 동시에 두 Mac에서 같은 봇이 가동되어 충돌이 날 수 있어요. 이전하시는 경우 기존 Mac에서는 launchd를 비활성화해주세요.

봇 토큰이 유출됐어요. 재발급할 수 있나요?

현재는 자동 재발급 기능이 출시 후 업데이트로 제공될 예정이에요 (/auth/reset-bot-app 엔드포인트). 긴급한 경우 다음 절차를 따라주세요.

  1. 즉시 Discord Developer Portal에서 본인 봇의 토큰을 재발급해주세요 (https://discord.com/developers/applications → 본인 봇 → Bot → Reset Token).
  2. 새 토큰을 ~/Library/Application Support/Creator OS/.envDISCORD_BOT_TOKEN 값으로 교체해주세요.
  3. Creator OS를 재시작하시면 새 토큰으로 가동돼요.

봇 토큰 유출은 이용약관 제7조 5항에 따라 운영자가 책임을 지지 않아요. 토큰 관리에 유의해주세요.

Creator OS를 완전히 제거하고 싶어요.

다음 5가지를 삭제하시면 완전 제거돼요.

  1. /Applications/Creator OS.app (앱 본체)
  2. ~/Library/Application Support/Creator OS/ (데이터베이스 + 로그 + 설정)
  3. ~/Library/LaunchAgents/com.creator-os.bot.plist (launchd 서비스 등록 파일)
  4. 시스템 환경설정 → 개인정보 보호 및 보안에서 Creator OS 권한 4종 토글 OFF + 목록에서 제거
  5. Discord Developer Portal에서 본인이 생성한 봇 Application 삭제 (선택 사항)

출시 안정화 단계에서 공식 Uninstaller를 제공할 예정이에요.

재설치 시 기존 Discord 봇과 데이터를 그대로 쓸 수 있나요?

네, 데이터가 그대로 있는 상태에서 앱만 재설치하시는 경우 자동으로 기존 PostgreSQL과 봇 설정이 복원돼요. 위자드는 이미 완료된 단계를 자동으로 건너뛰어요.

데이터까지 초기화하시려면 위 Q4.5의 2번 폴더(~/Library/Application Support/Creator OS/)도 함께 삭제 후 재설치해주세요.


봇 동작

에이전트 5개가 각각 뭘 담당하나요?

Creator OS는 5종의 전문 에이전트가 채널별로 분리돼 있어요 (v0.4.1 통일 네이밍).

  • assistant — 일정 관리, 이메일 처리, 태스크 매니징 (Google Calendar / Gmail 연동)
  • creator — 콘텐츠 기획, 스크립트 작성, SNS 게시 (이전 이름: content)
  • developer — 코드 개발, 버그 수정, 리팩토링 (이전 이름: dev)
  • brain — 리서치, 의사결정 지원, 분석
  • designer — AI 이미지 생성, 썸네일 제작, 시각 자산

각 에이전트는 전용 Discord 채널에서 동작해요. @developer 같은 멘션으로 특정 에이전트를 직접 호출하실 수도 있어요.

봇이 서버의 모든 메시지에 응답해요. @멘션할 때만 응답하게 할 수 있나요?

네, 멘션 전용 모드를 켜시면 돼요. 기본값은 에이전트 채널·스레드의 모든 메시지에 응답하는 건데, 채널에 메모를 자주 남기거나 대화가 많아지면 봇이 매 메시지마다 끼어드는 게 번거로울 수 있어요.

켜는 방법은 두 가지예요.

  • Hub 앱 — 메뉴바 아이콘에서 Hub를 열고 [멘션 전용 모드] 스위치를 켜주세요.
  • 슬래시 커맨드 — Discord에서 /system mention-mode mode:on 으로 켜고, mode:off 로 끌 수 있어요 (봇 주인 전용).

켜면 봇은 자신이나 에이전트 역할(@assistant 등)을 @멘션할 때만 응답하고, 그 외 일반 대화는 무시해요. 다시 끄면 모든 메시지에 응답해요.

봇을 Discord 서버에 초대할 때 어떤 권한을 요구하나요? 관리자 권한이 필요한가요?

관리자(Administrator) 권한은 요구하지 않아요. v0.10.16부터 봇 초대 링크는 봇이 실제로 쓰는 12가지 최소 권한만 요청해요.

봇이 서버에서 하는 일은 정해져 있어요 — 에이전트 인박스 채널·카테고리·포럼 만들기, 에이전트 역할 만들기, 웹훅으로 에이전트별 응답 보내기, 스레드 열고 정리하기, 메시지·임베드·파일 보내기, 리액션 달기예요. 딱 이 작업에 필요한 권한만 담았어요.

  • 포함 — 채널 보기 / 메시지 보내기(스레드 포함) / 링크 임베드 / 파일 첨부 / 메시지 기록 보기 / 리액션 추가 / 채널 관리 / 웹훅 관리 / 공개 스레드 만들기 / 스레드 관리 / 역할 관리
  • 불포함 — 관리자, 메시지 관리(타인 메시지 삭제·고정), @everyone 멘션, 서버 설정 변경, 멤버 추방·차단 등은 요청하지 않아요.

이미 봇을 초대해 쓰고 계시면 영향이 없어요. 권한 최소화는 새로 초대하는 경우에만 적용돼요. 권한 관련 문의는 [email protected]으로 연락 주세요.

봇이 응답을 안 해요. 멈춘 건가요?

Creator OS는 Hang Detector가 내장돼 있어요. Claude CLI 응답이 2분간 없으면 자동으로 Discord에 알림과 함께 진단 버튼이 노출돼요.

알림이 안 떴는데 답이 늦는 경우 다음을 확인해주세요.

  1. 다른 에이전트가 작업 중일 수 있어요 — 동일 에이전트는 한 번에 하나의 요청만 처리하고 나머지는 큐에 적재돼요. 큐 적재 시 "N번째 대기 중" 알림이 자동으로 와요.
  2. Claude API가 일시적으로 느려진 경우가 있어요. Anthropic 장애 페이지를 확인해주세요.
  3. 로컬 PostgreSQL이 중단된 경우도 있어요. 메뉴바 아이콘에서 [Postgres 재시작]을 눌러주세요.

위 모두 아니면 Helper Bot DM으로 에이전트 채널 링크와 메시지 시각을 알려주세요.

"모델 강등" 알림이 떴어요. 무슨 의미인가요?

Creator OS는 usage_guard 시스템이 사용량을 모니터링해서 자동으로 모델을 강등/복원해요.

  • 세션 또는 주간 사용량이 60% 이상 도달하면 액티브 모드 진입 + 1회 Discord 알림
  • 세션 90% / 예측 80% / 주간 60~80% 도달 시 자동 강등 — Opus → Sonnet → Haiku 순서
  • 세션 < 70% AND 주간 < 50% 회복 시 자동 복원

이 메커니즘은 Claude API 할당량을 다 소진해서 봇이 멈추는 사태를 막기 위한 안전장치예요. Sonnet/Haiku도 충분히 좋은 응답을 만들지만 Opus 대비 추론 깊이가 얕을 수 있어요. 복잡한 작업은 강등 알림 후 약간의 시간을 두고 시도하시면 자동 복원될 수 있어요.

v0.4.1부터는 /model 슬래시 커맨드로 직접 모델을 (sonnet / opus / haiku) 고정하실 수도 있어요.

사용량 한계가 정확히 얼마인가요?

Creator OS는 Claude CLI subprocess를 통해 Claude AI를 사용해요. Anthropic 정책에 따라 다음 한계가 적용돼요.

  • 세션 한계 — Claude 세션당 컨텍스트 한계 (모델별 상이)
  • 주간 한계 — 7일 단위 토큰 사용량 (Pro/Max 플랜별 상이)

모든 사용량은 Anthropic 측 계산을 기준으로 해요. Creator OS는 이를 모니터링만 하고 자체적으로 사용량을 제한하지는 않아요. 사용량 표시는 메뉴바 아이콘 → [사용량 보기]에서 확인하실 수 있어요.

큐 대기 알림이 너무 자주 와요. 끌 수 있나요?

큐 대기 알림은 동일 에이전트에 동시 요청이 들어왔을 때만 발생해요. 자주 뜨신다면 다음을 시도해주세요.

  • 같은 에이전트에 연속해서 메시지를 보내지 마시고, 이전 응답이 완료된 후 다음 메시지를 보내주세요.
  • 빠른 처리가 필요한 작업은 여러 에이전트에 분산해서 보내주세요 (예: 코드 작업은 developer, 일정은 assistant).
  • 알림 자체를 끄고 싶으시면 메뉴바 아이콘 → [설정] → [큐 알림 OFF]를 선택해주세요.
음성 메시지를 보내면 어떻게 처리되나요?

Discord 음성 메시지를 보내시면 자동으로 mlx-whisper STT를 통해 텍스트로 변환된 뒤 에이전트가 응답해요. 변환된 텍스트는 30일간 보관된 후 자동 삭제돼요.

처리 흐름은 다음과 같아요.

  1. 음성 첨부 → mlx-whisper 변환 (Apple Silicon Metal 가속)
  2. 노이즈 제거 (noisereduce 라이브러리)
  3. 변환된 텍스트가 미리보기로 표시 → 에이전트 응답

긴 음성(10분 이상)은 처리에 30초 이상 걸릴 수 있어요.

Discord 메시지가 외부 데이터베이스로 보내진다고요? 어디로 가나요?

네, archive_forwarder가 Discord 메시지를 운영자가 관리하는 PostgreSQL (Railway 미국 호스팅)로 실시간 적재해요. 적재 항목과 보관 기간은 개인정보처리방침 제1조와 제3조에 명시돼 있어요.

구독 해지 시 30일 이내 자동 삭제되고, 즉시 삭제를 원하시면 [email protected]으로 요청해주세요.

메일 / 일정은 어떻게 확인해요?

Mac 의 Mail 앱Calendar 앱 을 그대로 사용해요 (별도 OAuth 로그인 없이 Mac 시스템 환경설정에 등록된 계정 그대로).

진입점 (모든 티어 · 무료): - 슬래시 /mail-check limit=10 — 최근 메일 N개 (1~50) - 슬래시 /calendar-check range=today — 오늘/내일/이번 주 일정 (1~100) - 자연어 호출 — assistant 채널에서 "오늘 일정 알려줘" / "메일 확인해줘" 라고 말씀하시면 AI 가 자동 호출

첫 사용 시 macOS 권한 다이얼로그가 떠요. [허용] 누르시면 끝. 거부하셨다면 시스템 설정 → 개인정보 보호 및 보안 → 자동화 패널에서 Creator OS 의 Mail / Calendar 토글을 다시 켜주세요. 봇이 권한 패널을 자동으로 띄워드려요.

Mac Mail 앱에 계정이 안 등록된 경우 봇이 등록 안내 카드를 자동으로 띄워줘요. 시스템 설정 → 인터넷 계정 → Google · iCloud · Microsoft · Yahoo 중 본인 메일을 추가하시면 돼요.

Pro+ 의 메일 자동화 (백그라운드 폴링) 는 다른가요?

/mail-check수동 단발 조회 라면, /workflow email-automation [켜기]Pro+ 전용 자동화 예요.

  • 10분마다 새 메일을 자동으로 분류 (collab/personal/important_notice/spam)
  • 중요한 메일은 Discord 알림으로 안내
  • 답장 초안 자동 생성 (Mail.app drafts 폴더에 저장, 발송 X)

켜기 누르면 봇이 먼저 Mac Mail 앱 상태를 자동으로 확인해요. 계정 미등록 / 권한 미허용 시 안내 카드를 띄우고 자동화 시작은 미루어드려요.

Mac 잠자기 들어가면 봇은 어떻게 되나요?

Mac 이 잠자기 모드에 들어가면 Creator OS도 함께 잠자기에 들어가요. 다만 잠자는 동안 Discord 가 사용자 메시지를 자동으로 잠시 보관해두고, Mac 이 깨어난 후 봇이 한꺼번에 처리해드려요.

알림 흐름 (v0.9.34+):

  • 잠자기 진입 시 — 안내 채널에 1회 메시지: "Mac이 잠자기 모드에 들어갔어요." (/system always-on 안내 포함)
  • 잠자는 동안 — 봇이 함께 잠시 멈춰있어요. 사용자가 보낸 메시지는 Discord 가 보관해드려요
  • 깨어남 — 봇이 데이터베이스 연결을 자동으로 다시 맞추고, 잠자는 동안 보관됐던 메시지를 한꺼번에 처리해드려요
  • 깨어난 후 첫 응답의 footerCreator OS가 N시간 N분의 잠자기에서 깨어났어요. 안내. 다음 메시지부터는 footer 안 옴 (1 cycle = 1 안내)

잠자는 동안에도 봇 사용 필요하면/system always-on 으로 모드를 서버 항상 켜두기 로 변경하세요 (아래 Q&A 참고).

Always-On 모드는 뭔가요? 어떻게 켜요?

Always-On 모드 는 Mac 슬립 차단을 봇이 관리하는 기능이에요 (v0.9.34+). 3 가지 모드:

모드 동작 추천 사용
🔋 서버 항상 켜두기 AC + 배터리 모두 idle sleep 차단 외부에서 모바일 Discord 로 봇 사용
🔌 전원 연결 시에만 켜두기 (기본값) AC 전원 시만 슬립 차단. 배터리는 정상 슬립 이동이 잦은 노트북. 배터리 안전
🍃 시스템에 맡기기 슬립 차단 0. Mac 기본 정책 따름 배터리 절약 우선 (외부 사용 어려울 수 있음)

변경 방법 3가지:

  1. 봇 첫 설치 후 Assistant 채널의 안내 메시지의 버튼 — 1 클릭 = 즉시 적용
  2. /system always-on 슬래시 — 4 옵션 (status / always / ac_only / off) — 모바일 Discord 에서도 가능
  3. (Hub UI 는 다음 cycle 추가 예정)

선택 즉시 적용 + 영속 — 봇 재시작 / OTA 후에도 모드 유지. 노트북 배터리 모드 시 서버 항상 켜두기 켜면 평소보다 배터리 10~20% 빨리 닳을 수 있어요.

응답 마지막에 "잠자기에서 깨어났어요" 가 보여요. 뭔가요?

Mac 이 잠자기 cycle 후 처음으로 응답할 때 봇이 자동으로 footer 에 알림을 추가해요.

예시:

- 라이언, 1.5초동안 생각함. (Sonnet)
Creator OS가 1시간 30분의 잠자기에서 깨어났어요.
  • 첫 줄 — 에이전트 / 응답 시간 / 모델 (기본 footer)
  • 두 번째 줄 — wake 안내 (1 cycle = 1회만, 다음 메시지부터는 첫 줄만 표시)

응답이 늦은 게 잠자기 cycle 때문이었음을 자연스럽게 알려드리는 거예요. 별도 알림이 아니라 footer 라 봇 응답 흐름을 깨지 않아요.

잠자기 후 깨어났을 때 봇이 "죽었다 켜졌다" 알림이 자꾸 와요

v0.9.33 이하 의 알려진 알림이에요. Mac 이 깨어날 때 봇이 데이터베이스 연결 끊김에 과민 반응해서 종료 → macOS 가 자동 재시작 → "봇 시작" 알림이 사용자에게 다발로 발사되는 패턴.

v0.9.34 부터 해결됐어요. 봇이 잠자기에서 깨어난 후 데이터베이스 연결을 자동으로 다시 맞추고, 봇 종료 자체를 회피해요. 죽었다 켜졌다 알림도 더 이상 발사되지 않아요.

OTA 받으셨는데 여전히 같은 알림이 오면 봇 버전 확인 부탁드려요: - /system status 에서 봇 버전이 0.9.34 또는 그 이상 - 그 이상인데도 알림 발생 시 Helper Bot DM 또는 [email protected] 으로 알림.


바이오링크가 뭔가요?

Creator-OS에 무료로 포함된 공개 프로필 페이지예요. 결제하신 모든 분께 추가 비용 없이 제공돼요.

  • 나만의 주소 — 당신이 고른 핸들로 된 공개 프로필 페이지가 생겨요 (bio.creator-os.app/@당신의핸들).
  • 한 곳에 정리 — 소개·대표 링크·소셜 계정·갤러리 이미지를 한 페이지에 모아요.
  • 방문자 분석 — 페이지 조회수와 링크별 클릭, 어디서 들어왔는지(유입 경로)를 집계로 볼 수 있어요.

인스타그램·유튜브 프로필이나 이메일 서명에 이 주소 하나만 달아두면, 당신의 모든 채널을 한눈에 보여줄 수 있어요.

프로필 페이지에 뭘 넣을 수 있어요?
  • 소개 — 한 줄 헤드라인과 짧은 소개글
  • 프로필 사진 / 배너 — 아바타와 헤더 배경 이미지 (배너는 영상도 지원해요)
  • 링크 — 대표 링크 1개를 포함해 최대 30개까지
  • 소셜 계정 — Instagram · YouTube · Threads · TikTok · X · GitHub · 웹사이트 · 이메일 (최대 12개)
  • 갤러리 — 포트폴리오 이미지 최대 24장
  • 테마 — 따뜻한 페이퍼 톤이 기본이고, 여러 디자인 테마 중에서 고를 수 있어요.
바이오링크는 어떻게 편집하나요?

Creator OS 봇한테 그냥 말하면 돼요. 예를 들어 "내 바이오링크에 유튜브 링크 추가해줘", "테마 바꿔줘", "대표 링크를 인스타로 바꿔줘" 처럼요. 말한 대로 바로 반영돼서, 따로 관리 화면을 열지 않아도 돼요.

방문자 분석은 뭘 볼 수 있나요? 방문자 개인정보가 수집되나요?

당신의 페이지가 얼마나, 어디서, 어떤 링크로 반응을 얻는지 집계로 보여드려요.

  • 볼 수 있는 것 — 페이지 조회수, 링크별 클릭 수, 유입 경로(어느 사이트에서 왔는지), 기기 종류(모바일/PC), 국가, 시간대별·요일별 피크 통계
  • 수집하지 않는 것 — 방문자의 IP 주소, 이름·계정, 쿠키·세션, 누가 재방문했는지 같은 개인 식별 정보는 저장하지 않아요.

즉 "내 페이지가 얼마나 보이는지"를 알기 위한 집계 통계만 남기고, 방문자 개인을 추적하지 않아요. 이 분석은 크리에이터인 당신의 자산이에요.


클라우드 보관함

클라우드 보관함은 뭐고 용량은 얼마인가요?

계정마다 512GB 클라우드 보관함을 드려요. 다운로드는 무제한이에요.

영상 최종본·이미지·원본 파일 등 형식 제한 없이 무엇이든 보관할 수 있어요. 봇이 만든 생성물(이미지/영상/음악)도 이 보관함에 함께 저장돼요.

파일은 어떻게 올리나요?

브라우저 웹페이지에서 직접 올려요. 봇이 링크를 만들어 줘요.

  1. Discord 에서 /storage files 를 실행하거나, 봇에게 "내 보관함 열어줘" / "파일 올릴 링크 만들어줘" 라고 말해요.
  2. 봇이 보관함 링크를 보내줘요 (Mac 에서는 브라우저가 바로 열려요).
  3. 폰에서 쓰려면 그 링크를 폰에서 열어요. 사진·영상도 갤러리에서 바로 선택할 수 있어요.
  4. 페이지에서 파일을 올리면 내 보관함에 저장돼요. 진행률과 남은 용량이 실시간으로 보여요.
  • 링크는 7일 동안 유효해요. 그 안에 여러 파일을 올릴 수 있어요.
  • 파일 1개당 5GB 까지 올릴 수 있어요 (더 큰 원본은 추후 지원).
올린 파일을 관리(링크 복사·삭제)할 수 있나요?

네. 같은 /storage files 페이지 아래쪽 내 파일 목록에서 올린 파일을 관리해요.

  • 링크 복사 — 각 파일의 [📋 링크] 버튼으로 공개 링크를 바로 복사해서 공유할 수 있어요. 영상·오디오 파일은 재생과 다운로드가 모두 가능한 뷰어 링크로 제공돼요.
  • 삭제 — [🗑] 버튼으로 삭제하면 목록·용량에서 바로 빠지고 7일 동안 복구할 수 있어요. (이미 공유한 링크는 7일간 열려요.)
  • 파일은 올릴 때의 원본 이름으로 보이고, 최근 200개까지 표시돼요.
  • 봇에게 "내 파일 보여줘" 라고 말해도 같은 페이지 링크를 받을 수 있어요.
남은 용량은 어떻게 확인하나요?

Discord 에서 /storage quota 를 실행하거나, 봇에게 "내 용량 얼마나 남았어?" 라고 물어보면 사용 중 / 전체 512GB / 남은 용량을 보여줘요.

512GB를 다 쓰면 어떻게 되나요?

가장 오래된 파일부터 자동으로 정리돼요. 정리된 파일은 7일 동안 복구할 수 있는 휴지통에 보관됐다가 완전히 삭제돼요.

그래서 업로드는 한도에 도달해도 멈추지 않고 계속 진행돼요. 용량이 임박하면 미리 안내해 드려요.

보관함은 언제까지 쓸 수 있나요? (만료)

보관함은 크리에이터 멤버십(12개월) 동안 유지돼요 — 매월 크레딧이 지급되는 그 기간과 같아요. 멤버십이 끝나면 보관함도 함께 만료되는데, 만료 뒤 30일 동안은 올린 파일을 그대로 내려받을 수 있어요. 그 유예가 지나면 파일이 정리돼요. 멤버십을 갱신하면 보관함도 끊김 없이 이어져요. 더 큰 용량이 필요하면 운영팀에 문의해 주세요.


PC 제어 권한

Creator OS가 제 Mac에서 정확히 뭘 할 수 있나요?

이용약관 제4조에 명시된 5가지 권한 범위 내에서만 동작해요.

권한 동작
키보드 입력 키 입력 이벤트 발생
마우스 제어 포인터 이동/클릭/스크롤
화면 캡처 스크린샷 촬영 및 AI 분석
파일 시스템 지정 디렉토리 내 파일 읽기/쓰기
Claude CLI 실행 Anthropic Claude Code CLI 프로세스 실행

이 권한들은 사용자의 명시적인 Discord 메시지 지시에 의해서만 활성화돼요. 봇이 사용자 지시 없이 자율적으로 PC를 제어하지 않아요.

위험한 작업(파일 삭제, SNS 발행 등)은 어떻게 안전이 보장되나요?

외부 액션 승인 게이트가 작동해요. SNS 발행, 봇 재시작, 파일 삭제 같은 중요 작업은 봇이 바로 실행하지 않고 Discord에 승인 버튼을 띄워 사용자가 [승인] 버튼을 눌러야만 실행돼요.

승인 버튼 UI는 ApprovalView 컴포넌트로 통일돼 있고, 작업 내용/대상/예상 결과가 모두 카드 형태로 표시돼요. 의도하지 않은 작업은 [거부]를 눌러주시면 즉시 중단돼요.

봇이 뭘 했는지 사후에 확인할 수 있나요?

네, 모든 활동이 로그로 남아요. 다음 위치에서 확인하실 수 있어요.

  • launcher.log~/Library/Application Support/Creator OS/logs/launcher.log (봇 시작/종료, 권한 체크, 위자드 진행 상황)
  • agent.log — 같은 폴더의 agent.log (에이전트별 요청/응답 + Claude CLI subprocess 출력)
  • Discord 메시지 이력 — 에이전트 채널과 스레드에 모든 대화가 그대로 남아요.

로그는 로컬에만 저장되고 운영자가 자동으로 가져가지 않아요. 디버깅을 위해 공유가 필요하시면 Helper Bot DM으로 직접 보내주세요.

봇이 제 PC를 제어하지 못하게 일시 정지할 수 있나요?

네, 3가지 방법이 있어요.

  1. 메뉴바 아이콘 → [일시 정지] — 봇이 새 요청을 받지 않게 해요. 기존 요청은 완료될 때까지 동작해요.
  2. 시스템 환경설정에서 권한 OFF — 손쉬운 사용 토글을 끄시면 즉시 PC 제어가 차단돼요. 봇은 살아있지만 키/마우스 자동화 명령이 무력화돼요.
  3. 봇 완전 중단 — 메뉴바 아이콘 → [Creator OS 종료]를 선택하시면 launchd까지 중단돼요.
Computer Use를 영구적으로 비활성화하고 Discord 기능만 쓰고 싶어요.

가능해요. 시스템 환경설정 → 개인정보 보호 및 보안에서 다음 3가지 권한 토글을 OFF로 두시면 돼요.

  • 손쉬운 사용 (Accessibility)
  • 화면 녹화 (Screen Recording)
  • 자동화 (Automation)

전체 디스크 접근(FDA)은 컨텍스트 파일 읽기에 필요하니 켜두시는 걸 추천해요. 위 3개를 끄면 Discord 대화 기반 AI 응답 + Calendar/Mail MCP 연동까지는 정상 동작하지만 PC 자동 제어는 차단돼요.

봇이 제 키로그나 화면을 운영자 서버로 전송하나요?

아니요, 그런 일은 없어요. 키보드 입력 이벤트와 화면 캡처는 사용자 Mac 내부에서만 사용되고 운영자 서버로 전송되지 않아요.

다만 Discord 메시지 본문은 Anthropic Claude API로 전송돼서 AI 응답을 생성해요. 이는 서비스 핵심 기능이고 개인정보처리방침 제4조에 명시돼 있어요. Claude API로 전송된 데이터의 처리/보관은 Anthropic 자체 개인정보처리방침을 따라요.

봇에 오류가 나면 무엇이 전송되나요? 끌 수 있나요?

기본적으로는 아무것도 전송하지 않아요. 에러 진단 전송은 동의하셔야만 켜지고(Opt-in), 기본값은 꺼짐이에요 (개인정보처리방침 제1.6조).

동의해 주시면, 봇에 치명적인 오류가 났을 때만 아래를 개발자에게 보내 더 빨리 고칠 수 있게 도와요.

  • 보내는 것 — 에러 메시지, 기기 정보(앱 버전·macOS 종류)
  • 절대 안 보내는 것 — 대화 내용·메시지·파일·키보드 입력·화면·개인정보

켜고 끄는 방법은 두 가지예요.

  • Discord 온보딩 — 처음 설치하면 #assistant 채널에 동의 카드가 떠요. [동의해요] 또는 [나중에] 를 고르시면 돼요.
  • Hub 앱 — 메뉴바 아이콘에서 Hub를 열고 [에러 진단 전송] 스위치로 언제든 켜고 끌 수 있어요.
자동화가 의도치 않게 다른 앱을 망가뜨리면 어떻게 하나요?

이용약관 제7조 1항에 따라 PC 제어 과정에서 발생하는 데이터 손실, 파일 삭제, 시스템 설정 변경 등의 손해는 사용자 책임이에요.

이 위험을 최소화하기 위해 다음 보호 장치가 있어요.

  • 외부 액션 승인 게이트 — 중요 작업은 사용자 승인 후에만 실행
  • 로그 기록 — 모든 동작이 로그로 남아 사후 추적 가능
  • 즉시 중단 옵션 — 메뉴바 아이콘 또는 권한 토글로 즉시 차단 가능

처음에는 중요하지 않은 작업부터 테스트하시면서 봇 동작에 익숙해지시는 걸 추천해요. 중요한 파일은 별도 백업을 권장해요.


문제 해결

자주 마주칠 수 있는 일시적 문제와 해결 방법이에요. 헬퍼봇 /help 명령으로도 본 섹션 안내를 받을 수 있어요.

봇 가동 중인데 .app 더블클릭하면 "더 이상 열 수 없습니다" 라고 나와요 일시적 macOS 호환성 이슈예요. 봇 daemon 의 NSApp 활성화 정책 때문에 발생할 수 있어요. 다음 방법으로 해결됩니다: **[방법 1 — Claude 가 도와줘요 (가장 쉬움)]** 설치 시 같이 깔린 Claude CLI 가 자동으로 진단 + 재시작을 처리해요. 추가 설치 0. 1. 터미널 열기 (Spotlight 에서 'Terminal' 검색) 2. `claude` 입력 후 Enter 3. `Creator OS 봇 재시작해줘` 라고 메시지 보내기 Claude 가 봇 상태 확인 + `launchctl kickstart` 자동 호출해 줘요. **[방법 2 — 직접 명령어]**
launchctl kickstart -k gui/$(id -u)/com.creator-os.agent
위 한 줄을 터미널에서 실행하면 봇이 재시작되고 잠시 후 다시 `.app` 을 클릭하면 Hub 창이 정상으로 떠요. **[그래도 안 되면]** `[email protected]` 으로 다음 정보와 함께 문의해주세요: - 스크린샷 - macOS 버전 (Apple > 이 Mac에 관하여) - Creator OS 버전 (Hub UI 상단에 표시됨)
봇이 가동 중인지 확인하고 싶어요 가장 빠른 방법은 Discord 에서 봇 프로필을 확인하는 거예요. 온라인 상태면 정상이에요. 터미널에서 직접 확인하려면:
launchctl list | grep creator-os.agent
PID 가 표시되고 두 번째 컬럼이 `0` 이면 정상 가동 중이에요.
봇을 다른 Discord 서버로 옮기고 싶어요 Hub UI 의 **[봇 설정] → [다른 서버로 옮기기]** 메뉴를 사용하세요. 옛 서버 데이터 처리 방식을 3 옵션 중 선택할 수 있어요: - **그대로 보존** (기본) — 옛 서버 데이터를 archive 상태로 둡니다 - **새 서버로 마이그레이션** — 옛 데이터를 새 서버로 옮깁니다 - **옛 데이터 삭제** — 완전히 새출발 합니다 (되돌릴 수 없어요)
Discord Portal 에서 봇 토큰을 다시 발급받았어요 Hub UI 의 **[봇 설정] → [봇 토큰 변경]** 메뉴에서 새 토큰을 입력해주세요. 같은 봇이면 토큰만 갱신 + 재시작되고, 다른 봇이면 **[봇 변경하기]** 메뉴를 사용하시면 돼요.
Creator OS 를 완전히 삭제하고 싶어요 두 가지 방법이 있어요. 사용자 의도에 맞게 선택해주세요. **[방법 A — 휴지통 (데이터 보존)]** `/Applications/Creator OS.app` 을 휴지통으로 이동하기만 하면 봇 / launchd / LSDB 가 자동 정리돼요. 데이터 (메모리, 음성 전사 등) 와 권한은 보존되어서 다시 깔 때 그대로 이어집니다. **[방법 B — 완전 삭제 (모든 데이터 영구 삭제)]** Hub UI 의 **[봇 설정] → [완전 삭제]** 메뉴를 사용하세요. 다음이 영구 삭제됩니다 (되돌릴 수 없음): - 봇 앱 + 모든 데이터 + 시스템 권한 4종 + 봇 인증 정보 결제 정보는 license-server 에 그대로 남아 같은 계정으로 재설치 시 인증 가능해요.

문의 채널

해결되지 않으면 아래로 문의해주세요. 운영 시간은 평일 한국 시간 10:00~19:00이에요.

  • 이메일[email protected] (환불·개인정보·법적 사안 포함 모든 문의)

더 궁금한 점은 결제 후 받으신 이메일의 안내대로 Helper Bot DM 으로 알려주세요.