macOS에서 OpenClaw 시작하기

새로운 개발 도구를 설치할 때마다 마주치는 복잡한 설정 과정은 정말 번거롭죠. 앱을 실행하자마자 쏟아지는 권한 요청과 설정 옵션들 때문에 작업 흐름이 끊기기도 하고요. OpenClaw는 이런 초기 설정 과정을 최대한 직접적이고 명확하게 구성해서 개발자가 빠르게 도구를 사용할 수 있도록 돕습니다.

필요한 것

• macOS 기기
• npm 또는 pnpm (CLI 설치를 원하는 경우)

빠른 시작

OpenClaw를 설치하고 첫 실행을 마치기까지 약 5분 정도면 충분해요. 다음 단계를 따라주세요.

1. 시스템 경고 및 네트워크 승인

앱을 처음 실행하면 macOS 보안 경고와 로컬 네트워크 접근 권한 요청이 나타나요. 두 항목 모두 승인해야 정상적으로 작동합니다.

2. 보안 공지 확인

OpenClaw는 기본적으로 개인용 Agent로 동작하며, 한 명의 신뢰할 수 있는 운영자를 기준으로 설계되었어요.

• 기본 프로필: 로컬 설정 시 tools.profile: "coding"이 기본값으로 지정됩니다. 덕분에 파일 시스템이나 런타임 도구를 제한 없이 바로 사용할 수 있어요.
• 보안 권장: 공유 환경이나 다중 사용자 설정이 필요하다면 도구 액세스 권한을 최소화하고 보안 가이드를 확인하세요.

3. Gateway 위치 선택

Gateway가 어디에서 실행될지 결정해야 합니다.

• This Mac (Local only): 로컬에서 인증을 구성하고 자격 증명을 저장합니다.
• Remote (over SSH/Tailnet): 로컬 인증을 구성하지 않습니다. 자격 증명은 Gateway 호스트에 이미 존재해야 합니다.
• Configure later: 설정을 건너뛰고 나중에 구성합니다.

4. 권한 부여 (TCC)

OpenClaw가 제대로 작동하려면 다음 항목들에 대한 권한이 필요해요.

• AppleScript 자동화, 알림
• 손쉬운 사용, 화면 기록
• 마이크, 음성 인식, 카메라, 위치 정보

5. CLI 설치 (선택 사항)

터미널 워크플로우를 위해 npm이나 pnpm을 통해 전역 openclaw CLI를 설치할 수 있어요. 이 단계를 완료하면 launchd 작업 등을 바로 사용할 수 있습니다.

6. 온보딩 채팅

모든 설정이 끝나면 전용 온보딩 채팅 세션이 열립니다. Agent가 스스로를 소개하고 다음 단계를 안내해 줄 거예요.

문제 해결

설정 과정에서 혼란스러울 수 있는 부분들을 정리했어요.

• Gateway 인증 실패: 루프백(loopback) 접속이라도 token이 생성됩니다. 로컬 WS 클라이언트는 반드시 이 토큰으로 인증해야 해요. 인증을 완전히 비활성화하면 로컬의 모든 프로세스가 접속할 수 있으니, 신뢰할 수 있는 기기에서만 주의해서 사용하세요.
• 신뢰할 수 없는 콘텐츠: 웹훅이나 외부 피드를 사용한다면 강력한 최신 모델을 사용하고 엄격한 샌드박싱 정책을 유지하는 것이 좋습니다.

도움이 더 필요하신가요? AI Setup Assistant에게 물어보세요.

다음 단계

• Onboarding Overview
• Bootstrapping
• Security Guide