빠른 시작 가이드
10분 만에 나만의 AI 비서를 실행시키세요.
1
환경 준비
Node.js (v22 이상)를 설치해야 합니다. macOS 사용자는 터미널을 직접 사용할 수 있으며, Windows 사용자는 WSL2 (Ubuntu)를 사용하는 것을 강력히 권장합니다.
2
원클릭 설치 및 마법사
터미널에서 다음 명령어를 실행하여 대화형 설정 마법사를 시작하세요:
openclaw onboard --install-daemon
마법사가 게이트웨이 모드 선택, AI 모델 구성 (Anthropic Claude Pro 권장) 및 채팅 채널 연결 과정을 안내합니다.
3
시작 및 확인
설치 후 서비스는 백그라운드에서 자동으로 실행됩니다. 상태를 확인하려면:
openclaw status
또는 브라우저에서 대시보드를 방문하세요: http://127.0.0.1:18789/
4
첫 번째 기기 페어링
WhatsApp을 사용하는 경우 `openclaw channels login`을 실행하여 QR 코드를 스캔합니다. Telegram을 사용하는 경우 봇에게 메시지를 보내고 페어링 코드(Pairing Code)를 승인합니다.
보안 가이드
OpenClaw는 시스템 수준의 권한을 가지므로 다음 관리 지침을 따라주시기 바랍니다.
고위험 경고
게이트웨이 포트(18789)를 공용 인터넷에 직접 노출하지 마십시오. 안전한 원격 액세스를 위해 Tailscale Serve를 사용하세요.
접근 제어
페어링 활성화 유지
기본적으로 봇에게 DM을 보내는 낯선 사람은 관리자의 승인이 필요합니다. 이것을 `open` 모드로 변경하지 마십시오.
그룹 채팅에서 @멘션
AI가 대화에 끼어들거나 악의적으로 호출되는 것을 방지하기 위해 그룹에서는 `requireMention: true`로 설정하십시오.
샌드박스 및 격리
주 세션이 아닌 퍼블릭 그룹(Public groups)과 같은 환경에서는 Docker 샌드박스 모드를 사용하고 위험도가 높은 명령어 권한(예: `system.run`)을 비활성화하는 것을 추천합니다.
// openclaw.json
{
"agents": {
"defaults": {
"sandbox": { "mode": "non-main" }
}
}
}