OpenClaw 시작하기: 깔끔한 설정과 워크플로우 가이드

새로운 오픈소스 도구를 로컬에 세팅하다 보면, 내 입맛에 맞게 수정한 코드들이 업데이트할 때마다 충돌해서 골치 아픈 적 많으시죠? 설정 파일이 여기저기 흩어져 있으면 나중에 백업하기도 힘들고, 버전이 올라갈 때마다 환경을 다시 구성하는 것도 꽤나 번거로운 일이에요.

OpenClaw는 이런 불편함을 줄이기 위해 설정과 워크스페이스를 코드 저장소와 분리해서 관리합니다. 어떻게 하면 업데이트 걱정 없이 나만의 환경을 구축할 수 있는지 바로 알려드릴게요.

필요한 것

시작하기 전에 아래 도구들이 준비되어 있는지 확인해 주세요.

가장 권장하는 Stable 워크플로우로 빠르게 시작해 보세요. macOS 앱을 사용하면 Gateway 관리가 훨씬 편해집니다.

OpenClaw.app 설치: 앱을 설치하고 실행하면 메뉴 바에 나타납니다.
권한 설정: 온보딩 체크리스트에 따라 TCC 권한(개인정보 보호 설정)을 승인하세요.
Gateway 설정: Connection Mode가 Local인지, 정상적으로 실행 중인지 확인하세요. (앱이 자동으로 Gateway를 관리합니다.)
채널 연결: WhatsApp 등을 연결하려면 터미널에서 아래 명령어를 실행하세요.
Terminal window
```
openclaw channels login
```
상태 확인: 모든 설정이 올바른지 체크합니다.
Terminal window
```
openclaw health
```

만약 빌드 버전에서 온보딩 마법사를 쓸 수 없다면, openclaw setup 실행 후 openclaw channels login을 하고 openclaw gateway로 직접 Gateway를 켜주세요.

업데이트할 때마다 설정이 날아가지 않도록, 커스텀 파일은 반드시 저장소 외부인 아래 경로에서 관리하는 것을 추천해요.

Config: ~/.openclaw/openclaw.json
Workspace: ~/.openclaw/workspace (스킬, 프롬프트, 메모리 등은 여기서 관리하고 개인 Git 레포로 만드세요.)

처음 한 번은 아래 명령어로 초기 설정을 잡아주세요.

openclaw setup

전역 설치를 하지 않았다면 pnpm openclaw setup으로 실행할 수 있습니다.

설치 중에 문제가 생겼나요? 자주 발생하는 상황들입니다.

포트 충돌: Gateway WS 기본값은 ws://127.0.0.1:18789입니다. 앱과 CLI가 서로 같은 포트를 바라보고 있는지 확인하세요.
Linux 서비스 중단: Linux에서는 로그아웃하면 Gateway 서비스가 멈출 수 있어요. 아래 명령어로 링거링(lingering)을 켜주세요.
Terminal window
```
sudo loginctl enable-linger $USER
```
데이터 위치:
- 인증 정보: ~/.openclaw/credentials/
- 세션: ~/.openclaw/agents/<agentId>/sessions/
- 로그: /tmp/openclaw/

설정 과정에서 더 궁금한 점이 있다면 AI Setup Assistant에게 물어보세요.

OpenClaw Expert

이 문서에서 답을 못 찾았다면 OpenClaw Expert에게 바로 물어보세요.