OpenClaw：설치 튜토리얼, macOS에서 가상 머신(Ubuntu)으로 안전하게 Lobster AI 배포
Source: Dev.to
이 글에서 해결하고자 하는 문제
OpenClaw가 세상에 등장한 이후 관련 기사와 동영상 소개를 자주 보게 되는데, 시대를 앞선 제품처럼 느껴집니다. 하지만 동시에 여러 보안 우려도 존재합니다.
이 글에서는 macOS에서 Ubuntu 가상 머신을 이용해 OpenClaw(龍蝦)를 안전하게 배포하는 방법을 설명합니다. 설치에 실패하거나 공격을 받을 경우 가상 머신을 삭제하기만 하면 됩니다.
주의
- 이 글에서 설치한 공식 버전은
2026.3.2이며, 공식 업데이트가 있으면 설정이 달라질 수 있습니다.- 본 튜토리얼은 macOS + Ubuntu 24.04.4 (ARM64) 가상 머신을 기준으로 합니다.
1. VirtualBuddy와 Ubuntu 설치
-
VirtualBuddy를 다운로드하고 설치합니다.
-
VirtualBuddy를 실행하고 Linux → Custom Link를 선택한 뒤, 아래 ISO 링크를 입력합니다:
https://cdimage.ubuntu.com/releases/24.04.4/release/ubuntu-24.04.4-live-server-arm64.iso또는 직접 ISO를 다운로드합니다(64-bit ARM (ARMv8/AArch64) server install image 클릭).
-
VirtualBuddy 인터페이스에서 Linux → Custom File을 선택하고 방금 다운로드한 ISO 파일을 지정합니다.
-
권장 VM 설정:
- Virtual CPUs：3 ~ 4
- Memory：4 GB
- Display Width / Height：최소값이면 충분합니다
- Install OpenSSH server 체크(설치 과정 중에 옵션이 나타납니다)
-
설치가 완료되면 재부팅하고, 이후에는 macOS 터미널에서 SSH로 접속해 작업하는 것을 권장합니다:
ssh @192.168.64.13 # 예시 ssh letswrite@192.168.64.13
2. Ubuntu에 Node.js 설치 (NVM 사용)
# NVM 설치 스크립트 다운로드 및 실행
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
# 쉘 설정 다시 로드
source ~/.bashrc # Zsh를 사용한다면 source ~/.zshrc 로 변경
# LTS 버전 Node.js 설치 (npm도 함께 설치됨)
nvm install --lts3. Telegram Bot 만들기
-
BotFather와 대화합니다.
-
BotFather에게 다음 명령을 입력합니다:
/newbot -
안내에 따라 봇 이름과 사용자 이름을 설정하고 Telegram Bot Token을 받아 저장합니다.
4. OpenClaw 설치
# 전역으로 openclaw 설치
npm i -g openclaw4.1 초기 설정 (onboard)
openclaw onboard-
Onboarding mode: QuickStart 선택
-
Model/auth provider: 아래 두 옵션 중 하나를 권장
- OpenAI Codex (ChatGPT OAuth) (ChatGPT Plus 이상 필요)
- GitHub Copilot (GitHub device login) (Copilot 구독 중인 경우)
화면 안내에 따라 인증 과정을 진행합니다. “이 사이트에 연결할 수 없습니다”라는 메시지가 뜨면 브라우저의 최종 URL을 터미널에 붙여넣으면 됩니다.
-
Select channel: Telegram (Bot API) 선택 후 앞 단계에서 얻은 Bot Token을 붙여넣습니다.
-
Skill 설치: 건너뛰어도 되며, 이후 Agent에서 직접 설치 가능.
-
API Key 입력: 추가 서비스(Google Places, Gemini, OpenAI, ElevenLabs, Notion)가 필요 없으면 모두 No 선택.
-
Enable hooks (필요에 따라 선택)
boot-md,bootstrap-extra-files,command-logger,session-memory등은 보안 및 사용 목적에 맞게 선택합니다.
위 과정을 모두 마치면 OpenClaw 설치가 성공적으로 완료됩니다. 이제 Telegram Bot에 임의의 메시지를 보내면 다음과 같은 페어링 명령을 받게 됩니다:
Approved telegram sender xxxxxxxxxx.페어링이 성공하면 Telegram에서 OpenClaw를 사용할 수 있습니다.
5. 흔히 발생하는 오류와 해결 방법
5.1 systemctl is-enabled 오류
마지막 단계에서 다음과 같은 메시지가 보이면:
Error: systemctl is-enabled unavailable: Command failed: systemctl --user is-enabled openclaw-gateway.service아래 명령을 순서대로 실행합니다:
sudo loginctl enable-linger $USER
echo 'export XDG_RUNTIME_DIR=/run/user/$(id -u)' >> ~/.bashrc
echo 'export DBUS_SESSION_BUS_ADDRESS=unix:path=${XDG_RUNTIME_DIR}/bus' >> ~/.bashrc
source ~/.bashrc
openclaw onboard # onboarding을 다시 실행5.2 systemd 사용자 서비스 만들기
mkdir -p ~/.config/systemd/user
cat > ~/.config/systemd/user/openclaw-gateway.service <<'EOF'
[Unit]
Description=OpenClaw Gateway
After=network.target
[Service]
Type=simple
Environment="PATH=$(dirname $(which openclaw)):/usr/local/bin:/usr/bin:/bin"
ExecStart=$(which openclaw) gateway run
Restart=on-failure
RestartSec=5
[Install]
WantedBy=default.target
EOF서비스를 다시 로드하고, 활성화 및 시작합니다:
systemctl --user daemon-reload
systemctl --user enable openclaw-gateway
systemctl --user start openclaw-gateway
# 상태 확인
systemctl --user status openclaw-gateway
systemctl --user is-enabled openclaw-gateway # enabled가 표시되어야 함
openclaw status # gateway가 reachable 표시재설치하거나 강제 업데이트가 필요할 때:
openclaw gateway install --force
openclaw gateway restart서비스 제어 명령:
systemctl --user stop openclaw-gateway # 정지
systemctl --user restart openclaw-gateway # 재시작
journalctl --user -u openclaw-gateway -f # 실시간 로그6. 설정 변경 및 Gateway 재시작
설치 과정에서 GitHub Copilot을 선택했는데 나중에 OpenAI Codex로 바꾸거나 다른 설정을 조정하고 싶다면 다음만 실행하면 됩니다:
openclaw config # 설정 인터페이스 진입 후 수정
openclaw gateway restart # 변경 사항 적용을 위해 gateway 재시작위 단계를 모두 마치면 macOS의 Ubuntu 가상 머신에서 OpenClaw(龍蝦) AI를 안전하게 사용할 수 있습니다. 즐거운 사용 되세요!