OpenClaw Linux 설치 가이드: 5분 만에 VPS 환경 구축하기

리눅스 서버에서 서비스를 안정적으로 구동하는 일은 생각보다 손이 많이 가죠. 프로세스가 갑자기 종료되지 않도록 관리하고, 서버가 재부팅될 때마다 자동으로 실행되도록 설정하는 과정에서 한 번쯤은 어려움을 겪어보셨을 거예요. OpenClaw는 이런 번거로운 과정을 줄여주고 Linux 환경에서 Gateway를 아주 쉽게 구축할 수 있도록 설계되었어요.

Linux App

Gateway는 Linux를 완벽하게 지원해요. Node 사용을 권장하며, Bun은 WhatsApp이나 Telegram 관련 버그가 있어 권장하지 않아요.

현재 네이티브 Linux 컴패니언 앱을 계획 중이에요. 직접 빌드하는 데 도움을 주고 싶다면 언제든 기여를 환영해요.

초보자를 위한 빠른 경로 (VPS)

1. Node 24를 설치하세요 (권장 사양이에요. Node 22 LTS, 현재 22.14+ 버전도 호환 가능해요).
2. npm i -g openclaw@latest
3. openclaw onboard --install-daemon
4. 로컬 노트북에서 실행: ssh -N -L 18789:127.0.0.1:18789 <user>@<host>
5. http://127.0.0.1:18789/ 접속 후 토큰을 붙여넣으세요.

전체 Linux 서버 가이드는 Linux Server에서, 단계별 VPS 예시는 exe.dev에서 확인할 수 있어요.

설치

• 시작하기
• 설치 및 업데이트
• 선택 사항: Bun (실험적), Nix, Docker

Gateway

• Gateway runbook
• Configuration

Gateway 서비스 설치 (CLI)

다음 명령어 중 하나를 사용하세요:

openclaw onboard --install-daemon

또는:

openclaw gateway install

또는:

openclaw configure

메시지가 나타나면 Gateway service를 선택하세요.

복구 또는 마이그레이션이 필요한 경우:

openclaw doctor

시스템 제어 (systemd user unit)

OpenClaw는 기본적으로 systemd user 서비스를 설치해요. 공유 서버나 항상 켜져 있어야 하는 서버라면 system 서비스를 사용하는 것이 좋아요. 전체 유닛 예시와 안내는 Gateway runbook에 들어있어요.

최소 설정 방법:

~/.config/systemd/user/openclaw-gateway[-<profile>].service 파일을 생성하세요:

[Unit]
Description=OpenClaw Gateway (profile: <profile>, v<version>)
After=network-online.target
Wants=network-online.target

[Service]
ExecStart=/usr/local/bin/openclaw gateway --port 18789
Restart=always
RestartSec=5

[Install]
WantedBy=default.target

서비스 활성화:

systemctl --user enable --now openclaw-gateway[-<profile>].service

다음 단계

• Gateway 운영 가이드
• 상세 설정 방법

설정 중에 도움이 필요하다면 AI Setup Assistant에게 물어보세요.