콘텐츠로 이동

Northflank에서 OpenClaw 원클릭으로 배포하기

새로운 도구를 사용해보고 싶을 때, 서버를 직접 구축하고 터미널에서 복잡한 명령어를 입력하는 과정은 꽤나 번거로운 일이에요. 설정 파일을 관리하거나 서버를 재시작할 때마다 데이터가 사라질까 걱정하는 것도 개발자라면 누구나 한 번쯤 겪어본 고민이죠.

복잡한 과정 없이 브라우저만으로 모든 설정을 끝내고 싶다면 Northflank의 원클릭 템플릿이 좋은 대안이 될 수 있습니다. Northflank가 OpenClaw Gateway를 대신 실행해주고, 여러분은 웹 화면에서 클릭 몇 번으로 설정을 마칠 수 있거든요.

필요한 것

시작하기 전에 다음 사항들이 준비되었는지 확인해 주세요.

Northflank 계정
환경 변수로 사용할 SETUP_PASSWORD
사용할 모델의 API Key 또는 인증 정보
(선택 사항) Telegram 또는 Discord 봇 토큰

빠른 시작

5분 안에 OpenClaw를 실행하는 방법입니다.

Deploy OpenClaw를 클릭해 템플릿을 엽니다.
Northflank 계정이 없다면 새로 만듭니다.
Deploy OpenClaw now를 클릭합니다.
필수 환경 변수인 SETUP_PASSWORD를 설정합니다.
Deploy stack을 클릭해 OpenClaw 템플릿 빌드와 실행을 시작합니다.
배포가 완료될 때까지 기다린 후 View resources를 클릭합니다.
OpenClaw 서비스를 선택합니다.
공개된 OpenClaw URL을 열고 주소 뒤에 /setup을 붙여 웹 위저드에 접속합니다.
설정을 마친 후 /openclaw에서 Control UI를 확인합니다.

구성 요소

이 과정을 통해 다음과 같은 환경이 준비됩니다.

호스팅된 OpenClaw Gateway 및 Control UI
/setup에서 제공되는 웹 설정 위저드 (터미널 명령어 불필요)
Northflank Volume (/data)을 통한 영구 저장소 (재배포 시에도 설정/인증 정보 유지)

Setup Flow

https://<your-northflank-domain>/setup에 접속하여 설정한 SETUP_PASSWORD를 입력합니다.
모델 및 인증 제공자를 선택하고 API Key를 입력합니다.
(선택 사항) Telegram, Discord, Slack 토큰을 추가합니다.
Run setup을 클릭합니다.
https://<your-northflank-domain>/openclaw로 접속해 Control UI를 사용합니다.

참고: Telegram DM이 페어링 모드로 설정된 경우, 설정 위저드에서 페어링 코드를 승인할 수 있습니다.

Getting Chat Tokens

Telegram 봇 토큰

Telegram에서 @BotFather에게 메시지를 보냅니다.
/newbot 명령어를 실행합니다.
123456789:AA... 형식의 토큰을 복사합니다.
OpenClaw /setup 화면에 붙여넣습니다.

Discord 봇 토큰

Discord Developer Portal에 접속합니다.
New Application을 누르고 이름을 설정합니다.
Bot 메뉴에서 Add Bot을 클릭합니다.
Privileged Gateway Intents 항목 아래에 있는 MESSAGE CONTENT INTENT를 반드시 활성화하세요.
Bot Token을 복사해 /setup 화면에 붙여넣습니다.
OAuth2 URL Generator를 통해 bot과 applications.commands 권한을 선택한 뒤 봇을 서버에 초대합니다.

문제 해결

Discord 봇이 시작 직후 종료되는 경우: Discord Developer Portal에서 MESSAGE CONTENT INTENT를 활성화했는지 다시 확인해 보세요. 이 옵션이 꺼져 있으면 봇이 정상적으로 실행되지 않고 크래시가 발생합니다.

추가로 궁금한 점이 있다면 AI Setup Assistant에게 물어보세요.

다음 단계

OpenClaw Expert

아직 막혀 있나요?

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