macOS 권한 설정 (Permissions)

OpenClaw 에이전트가 시스템 도구를 사용하고 여러분의 작업을 돕기 위해서는 macOS의 개인정보 보호 승인이 필요합니다.

🛠️ 필수 권한 목록

1. 전체 디스크 접근 권한 (Full Disk Access)

가장 중요한 권한입니다. 에이전트가 여러분의 프로젝트 파일에 접근하고 코드를 수정하기 위해 필요합니다.

• 설정 경로: 시스템 설정 > 개인정보 보호 및 보안 > 전체 디스크 접근 권한
• 대상: OpenClaw 앱을 목록에 추가하고 체크 표시를 켭니다.

2. 손쉬운 사용 (Accessibility)

에이전트가 대신 마우스를 클릭하거나 키보드 입력을 시뮬레이션할 때 필요합니다.

• 설정 경로: 시스템 설정 > 개인정보 보호 및 보안 > 손쉬운 사용

3. 화면 기록 (Screen Recording)

에이전트가 현재 화면의 상황(브라우저 내용 등)을 보고 이해하는 데 필요합니다.

• 설정 경로: 시스템 설정 > 개인정보 보호 및 보안 > 화면 기록

---

❓ 권한 오류 해결 방법

Q: 권한을 줬는데도 에이전트가 파일을 못 읽어요.

• 해결: 가끔 macOS가 설정을 즉시 반영하지 않을 때가 있습니다. 설정을 끈 후 다시 켜고 OpenClaw 앱을 완전히 종료 후 다시 실행해 보세요.

Q: 터미널 명령어(CLI)를 쓰는데도 권한이 필요한가요?

• 해결: 네, openclaw CLI를 사용하더라도 해당 CLI를 실행하는 **터미널 앱(Terminal, iTerm2 등)**에 '전체 디스크 접근 권한'이 있어야 원활한 파일 작업이 가능합니다.