온보딩(macOS 앱)

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

1

macOS 경고 승인

2

로컬 네트워크 찾기 승인

3

환영 및 보안 안내

보안 신뢰 모델:

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

4

로컬과 원격

Gateway는 어디에서 실행되나요?

• 이 Mac(로컬 전용): 온보딩에서 인증을 구성하고 자격 증명을 로컬에 쓸 수 있습니다.
• 원격(SSH/Tailnet 경유): 온보딩은 로컬 인증을 구성하지 않습니다. 자격 증명은 Gateway 호스트에 있어야 합니다.
• 나중에 구성: 설정을 건너뛰고 앱을 구성되지 않은 상태로 둡니다.

Gateway 인증 팁:

• 이제 마법사는 loopback에도 토큰을 생성하므로 로컬 WS 클라이언트는 인증해야 합니다.
• 인증을 비활성화하면 모든 로컬 프로세스가 연결할 수 있습니다. 완전히 신뢰할 수 있는 머신에서만 사용하세요.
• 다중 머신 접근 또는 non-loopback 바인드에는 토큰을 사용하세요.

5

권한

온보딩은 다음에 필요한 TCC 권한을 요청합니다.

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

6

CLI

이 단계는 선택 사항입니다

앱은 npm, pnpm 또는 bun을 통해 전역 openclaw CLI를 설치할 수 있습니다. npm을 먼저 선호하고, 그다음 pnpm, 감지된 유일한 패키지 관리자가 bun인 경우 bun을 사용합니다. Gateway 런타임에는 Node가 계속 권장 경로입니다.

7

온보딩 채팅(전용 세션)

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

​

관련 항목

• 온보딩 개요
• 시작하기