2026 OpenClaw 클라우드 서버 배포 두 경로: 원클릭 이미지 vs 소스 빌드
OpenClaw를 클라우드 서버에 배포하는 방법은 크게 두 가지입니다. 하나는 클라우드 업체가 제공하는 OpenClaw/Claw 앱 이미지로 원클릭 구축하는 방식으로, 빠르게 검증하고 싶거나 의존성 설정을 건드리기 싫은 경우에 적합합니다. 다른 하나는 Node 22를 수동으로 설치하고 npm 또는 pnpm으로 openclaw를 전역 설치한 뒤 직접 설정하는 방식으로, 커스터마이징이나 기존 운영 플로우가 있는 팀에 맞습니다. 원클릭 이미지는 보통 3~5분 안에 콘솔에 접속할 수 있지만 OS와 버전은 이미지에 따라 정해집니다. 소스 빌드는 20~30분 정도 걸리지만 Node와 openclaw 버전을 정확히 제어할 수 있습니다. 2026년에는 먼저 원클릭 이미지로 동작을 확인한 뒤, 필요에 따라 자체 구축이나 원격 Mac으로 옮기는 것을 권장합니다.
시스템 요구사항과 필수 항목: Node 22, 18789 포트 개방, 방화벽·보안 그룹
어느 경로를 택하든 다음 세 가지를 만족하지 않으면 콘솔에 접속할 수 없고 서비스도 외부에 제공할 수 없습니다.
| 항목 | 요구사항 | 설명 |
|---|---|---|
| Node.js | ≥ 22.0.0 | 22 미만이면 설치·실행 시 오류가 날 수 있으므로 nvm으로 관리 권장: nvm install 22 && nvm use 22 |
| 포트 | TCP 18789 | OpenClaw 콘솔·게이트웨이 기본 포트. 인스턴스 보안 그룹/방화벽에서 인바운드를 허용해야 함 |
| OS·리소스 | Linux Ubuntu 20.04+ / macOS / Windows WSL2; 최소 2코어 2GB 메모리, 20GB 디스크 | 클라우드 이미지는 대부분 충족. 자체 구축 시 확인 필요 |
클라우드 서버(텐cent·알리云 등)에서는 콘솔에서「보안 그룹」또는「방화벽」을 열고 인바운드 규칙을 추가하세요: 프로토콜 TCP, 포트 18789, 소스 0.0.0.0/0(필요 시 IP 제한). 그렇지 않으면 브라우저에서 http://서버IP:18789 로 접속해도 타임아웃됩니다.
설치 시 자주 나오는 문제: Node 버전 불일치, npm 멈춤/타임아웃, 미러와 pnpm 사용
2026년 기준으로 자주 나오는 세 가지 설치 문제와 대처 방법입니다.
# 1. Node 버전 확인·전환 (≥ 22 필수)
node -v
nvm install 22
nvm use 22
# 2. npm 미러 설정 (멈춤/타임아웃 해결)
npm config set registry https://registry.npmmirror.com
# 3. npm 대신 pnpm 사용 (선택, 보통 더 빠름)
npm install -g pnpm
pnpm add -g openclaw@latest
# 4. 원클릭 설치 스크립트 (공식, 모든 플랫폼 공통)
curl -fsSL https://openclaw.ai/install.sh | bash
Node 버전이 낮을 때: 설치·실행 시 오류가 나면 먼저 node -v를 실행하고, 22 미만이면 nvm 또는 공식 패키지로 Node 22를 설치한 뒤 기본으로 설정하세요.
npm install 멈춤·타임아웃: 미러를 먼저 설정하고, 그래도 불안정하면 pnpm으로 설치하세요.
Docker 컨테이너가 기동되지 않을 때: 18789가 사용 중인지(netstat -an | grep 18789)와 이미지 풀 완료 여부를 확인하세요(미러 가속 설정도 가능).
콘솔 접속 불가·Telegram/Feishu 미응답 시 확인 절차
콘솔이 안 열릴 때(http://IP:18789 타임아웃 또는 거부): 대부분 18789가 방화벽에서 열려 있지 않기 때문입니다. 클라우드 콘솔에서 인스턴스「보안 그룹」→ 인바운드 규칙을 확인하고 TCP 18789를 추가하세요. 자체 IDC나 로컬 Linux에서는 firewalld·ufw 또는 iptables에서 18789를 허용했는지 확인한 뒤, 개방 후 OpenClaw 서비스를 재시작하고 다시 접속하세요.
Telegram / Feishu Bot이 응답하지 않을 때: 먼저 OpenClaw가 동작 중인지 확인(openclaw status 또는 프로세스 확인)하고, 해당 채널의 Token이 올바르게 설정되었는지, Bot 설정에서 필요한 권한이 켜져 있는지 확인하세요. 로그 openclaw logs --tail 50로 연결·인증 오류를 볼 수 있습니다. 여러 채널을 동시에 설정할 수 있으며 대화 기록은 채널별로 분리됩니다.
멀티플랫폼 연동과 오프라인 운영(Ollama) 개요
OpenClaw는 동일 인스턴스에서 여러 채널(Telegram, Discord, Feishu 등)을 설정할 수 있으며, 모든 채널이 같은 AI 능력을 공유하고 대화 기록은 채널별로 독립적입니다. 스킬과 일부 채널 연동에는 네트워크가 필요합니다. Ollama 같은 로컬 모델을 쓰면 핵심 대화는 오프라인으로 동작할 수 있습니다. 모델 선택 참고: 일상 대화는 Kimi·MiniMax, 코딩 작업은 Claude Sonnet·GPT-4, 비용 절감은 DeepSeek·Qwen, 프라이버시 우선은 Ollama 로컬 배포가 적합합니다.
FAQ와 체크리스트: 클라우드 이미지 vs 원격 Mac 상시 운영
- 빠르게 검증·단기 체험만 할 때: 클라우드 업체 OpenClaw 이미지를 쓰고, 위와 같이 18789를 개방하고 API Key를 설정하면 됩니다.
- 7×24 안정 가동이 필요하고 클라우드 호스트 운영·보안 그룹을 신경 쓰고 싶지 않을 때: OpenClaw를 원격 Mac 호스팅(SFTPMAC 등)으로 옮기면, 제공자가 노드 가용성·디렉터리·권한 명확성을 보장해 주어 장기 자동화와 멀티플랫폼 연동에 적합합니다.
- 이미 Apple 생태계나 Mac 워크플로가 있을 때: 원격 Mac이 호환성·데스크톱/파일 협업 측면에서 더 일관되며, 업그레이드·백업 전략도 맞추기 쉽습니다.
클라우드 이미지는 빠르게 써보고 검증하는 데 적합합니다. 작업이「가끔만 돌리기」에서「상시 가동·멀티플랫폼·명확한 디렉터리·권한」으로 바뀌면 원격 Mac 호스팅을 쓰는 편이 운영 부담을 줄이면서 안정성을 높이기 좋습니다.
OpenClaw 콘솔에 접속할 수 없을 때는?
대부분 방화벽 또는 보안 그룹에서 18789 포트가 열려 있지 않기 때문입니다. 클라우드 콘솔에서 인스턴스 보안 그룹·인바운드 규칙을 확인하고 TCP 18789를 허용하세요. 로컬 또는 자체 IDC Linux에서는 firewalld/ufw 또는 iptables에서 18789를 열었는지 확인하세요.
npm install이 멈추거나 타임아웃될 때는?
미러 설정: npm config set registry https://registry.npmmirror.com. 또는 pnpm을 npm 대신 사용하면 설치가 빨라집니다. Node 버전이 ≥ 22.0.0인지도 확인하고, 그 미만이면 호환성 문제로 멈출 수 있습니다.
클라우드 이미지와 원격 Mac에서 OpenClaw를 상시 운영할 때 어떤 것을 쓸까?
클라우드 이미지는 빠른 검증·단기 체험이나 기존 클라우드 리소스가 있을 때 적합합니다. 7×24 안정 가동, Apple 생태계 호환, 디렉터리·권한 명확성, 기존 Mac 워크플로와의 통일이 필요하면 원격 Mac 호스팅(SFTPMAC 등)에서 상시 운영을 권장합니다.
클라우드 서버에서 직접 OpenClaw를 올리면 빠르게 돌려볼 수 있지만, 장기 운영에서는 보안 그룹·OS 업데이트·백업·다중 환경 일관성을 고려해야 합니다. AI 자동화 자체에 집중하고 운영 세부는 맡기고 싶다면 SFTPMAC의 원격 Mac 노드에 OpenClaw를 배포하는 선택이 있습니다. 18789 포트 도달·디렉터리·권한 명확성을 우리가 보장하고, 멀티플랫폼 연동과 7×24 안정 운영을 지원하므로 모델과 채널 설정에만 집중하시면 됩니다.