메인 콘텐츠로 건너뛰기

​
온보딩(macOS 앱)

이 문서는 현재 첫 실행 설정 흐름을 설명합니다. 목표는 매끄러운 “첫날” 경험입니다. Gateway 실행 위치를 선택하고, 인증을 연결하고, 마법사를 실행한 다음, 에이전트가 스스로 부트스트랩되도록 합니다. 온보딩 경로의 일반적인 개요는 온보딩 개요를 참고하세요.
1

macOS 경고 승인

2

로컬 네트워크 찾기 승인

3

환영 및 보안 안내

보안 신뢰 모델:
  • 기본적으로 OpenClaw는 개인용 에이전트입니다. 하나의 신뢰된 운영자 경계만 있습니다.
  • 공유/다중 사용자 설정은 잠금 구성이 필요합니다(신뢰 경계를 분리하고, 도구 접근을 최소화하며, 보안을 따르세요).
  • 로컬 온보딩은 이제 새 config의 기본값을 tools.profile: "coding"으로 설정하므로, 새 로컬 설정에서 제한 없는 full 프로필을 강제하지 않고 파일 시스템/런타임 도구를 유지합니다.
  • hook/webhook 또는 기타 신뢰할 수 없는 콘텐츠 피드가 활성화된 경우, 강력한 최신 모델 등급을 사용하고 엄격한 도구 정책/샌드박싱을 유지하세요.
4

로컬 vs 원격

Gateway는 어디에서 실행되나요?
  • 이 Mac(로컬 전용): 온보딩에서 로컬로 인증을 구성하고 자격 증명을 기록할 수 있습니다.
  • 원격(SSH/Tailnet 통해): 온보딩은 로컬 인증을 구성하지 않습니다. 자격 증명은 Gateway 호스트에 있어야 합니다.
  • 나중에 구성: 설정을 건너뛰고 앱을 미구성 상태로 둡니다.
Gateway 인증 팁:
  • 이제 마법사는 loopback에 대해서도 토큰을 생성하므로, 로컬 WS 클라이언트도 인증해야 합니다.
  • 인증을 비활성화하면 모든 로컬 프로세스가 연결할 수 있으므로, 완전히 신뢰할 수 있는 머신에서만 그렇게 하세요.
  • 다중 머신 접근 또는 비-loopback 바인딩에는 토큰을 사용하세요.
5

권한

온보딩은 다음에 필요한 TCC 권한을 요청합니다:
  • 자동화(AppleScript)
  • 알림
  • 손쉬운 사용
  • 화면 기록
  • 마이크
  • 음성 인식
  • 카메라
  • 위치
6

CLI

이 단계는 선택 사항입니다
앱은 npm, pnpm 또는 bun을 통해 전역 openclaw CLI를 설치할 수 있습니다. 기본적으로 npm을 먼저 시도하고, 그다음 pnpm을 시도하며, 감지된 패키지 관리자가 bun뿐인 경우에만 bun을 사용합니다. Gateway 런타임에는 여전히 Node 경로가 권장됩니다.
7

온보딩 채팅(전용 세션)

설정 후 앱은 전용 온보딩 채팅 세션을 열어 에이전트가 자신을 소개하고 다음 단계를 안내할 수 있게 합니다. 이렇게 하면 첫 실행 안내가 일반 대화와 분리됩니다. 첫 번째 에이전트 실행 중 Gateway 호스트에서 어떤 일이 일어나는지는 부트스트래핑을 참고하세요.