OpenClaw 플랫폼 선택 및 Gateway 설치 가이드

새로운 도구를 설치할 때 어떤 운영체제나 런타임이 가장 안정적일지 고민하느라 시간을 허비하곤 하죠. 환경 설정 단계에서 발생하는 예기치 못한 버그는 개발 의욕을 꺾기도 합니다. OpenClaw를 가장 빠르고 안정적으로 시작할 수 있는 최적의 환경을 바로 확인해 보세요.

필요한 것

Node.js: OpenClaw core는 TypeScript로 작성되었으며, Node.js를 권장 런타임으로 사용합니다. (Bun은 WhatsApp/Telegram 버그 문제로 Gateway 사용 시 권장하지 않습니다.)
지원 운영체제: macOS, iOS, Android, Windows (WSL2 권장), Linux

빠른 시작

OpenClaw Gateway를 설치하고 실행하는 가장 빠른 방법입니다. 5분 안에 설정을 마칠 수 있습니다.

1. Gateway 서비스 설치 (CLI)

터미널에서 다음 명령어 중 하나를 선택해 실행하세요. Wizard 방식을 가장 추천합니다.

Wizard (추천):
Terminal window
```
openclaw onboard --install-daemon
```
직접 설치:
Terminal window
```
openclaw gateway install
```
설정 흐름을 통한 설치: openclaw configure 실행 후 Gateway service를 선택하세요.
복구 및 마이그레이션: openclaw doctor를 실행하면 서비스 설치나 수정을 제안합니다.

2. 상태 확인

설치가 완료되면 서비스가 정상 작동하는지 확인합니다.

openclaw gateway status

문제 해결

설치 중 문제가 발생하면 다음 사항을 확인해 보세요.

Bun 관련 이슈: Gateway 실행 시 WhatsApp이나 Telegram에서 버그가 발생한다면, Bun 대신 Node.js를 사용하고 있는지 확인하세요.
서비스 타겟 확인: OS에 따라 서비스 등록 위치가 다릅니다.
- macOS: LaunchAgent (bot.molt.gateway 또는 bot.molt.<profile>)
- Linux/WSL2: systemd user service (openclaw-gateway[-<profile>].service)
설치 오류: 서비스가 제대로 작동하지 않는다면 openclaw doctor 명령어를 통해 문제를 진단하고 복구할 수 있습니다.

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

다음 단계

OpenClaw Expert

아직 막혀 있나요?

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