Ansible

​

사전 요구 사항

​

제공되는 기능

• 방화벽 우선 보안: UFW + Docker 격리(SSH + Tailscale로만 접근 가능)
• 서비스를 공개적으로 노출하지 않고 원격으로 액세스할 수 있는 Tailscale VPN
• localhost 전용 바인딩을 사용하는 격리된 샌드박스 컨테이너용 Docker
• 보안 강화 및 부팅 시 자동 시작을 지원하는 systemd 통합
• 단일 명령 설정

​

빠른 시작

curl -fsSL https://raw.githubusercontent.com/openclaw/openclaw-ansible/main/install.sh | bash

​

설치되는 항목

1. Tailscale(안전한 원격 액세스를 위한 메시 VPN)
2. UFW 방화벽(SSH + Tailscale 포트만 허용)
3. Docker CE + Compose V2(기본 에이전트 샌드박스 백엔드)
4. Node.js 및 pnpm(OpenClaw에는 Node 22.22.3+, 24.15+ 또는 25.9+가 필요하며, Node 24를 권장함)
5. 컨테이너가 아닌 호스트 기반으로 설치되는 OpenClaw
6. 보안이 강화된 systemd 서비스

​

설치 후 설정

sudo -i -u openclaw

openclaw channels login --channel <name>

sudo systemctl status openclaw
sudo journalctl -u openclaw -f

​

빠른 명령

# 서비스 상태 확인
sudo systemctl status openclaw

# 실시간 로그 보기
sudo journalctl -u openclaw -f

# Gateway 재시작
sudo systemctl restart openclaw

# 채널 로그인(openclaw 사용자로 실행)
sudo -i -u openclaw
openclaw channels login --channel <name>

​

보안 아키텍처

1. 방화벽(UFW): SSH(22) 및 Tailscale(41641/udp)만 공개적으로 노출
2. VPN(Tailscale): VPN 메시를 통해서만 Gateway에 접근 가능
3. Docker 격리: DOCKER-USER iptables 체인이 외부 포트 노출을 방지
4. Systemd 보안 강화: NoNewPrivileges, PrivateTmp, 비특권 사용자

nmap -p- YOUR_SERVER_IP

​

수동 설치

sudo apt update && sudo apt install -y ansible git

git clone https://github.com/openclaw/openclaw-ansible.git
cd openclaw-ansible

ansible-galaxy collection install -r requirements.yml

./run-playbook.sh

ansible-playbook playbook.yml --ask-become-pass
# 그런 다음 실행: /tmp/openclaw-setup.sh

​

업데이트

cd openclaw-ansible
./run-playbook.sh

​

문제 해결

# 로그 확인
sudo journalctl -u openclaw -n 100

# 권한 확인
sudo ls -la /opt/openclaw

# 수동 시작 테스트
sudo -i -u openclaw
cd ~/openclaw
openclaw gateway run

# Docker 실행 여부 확인
sudo systemctl status docker

# 샌드박스 이미지 확인
sudo docker images | grep openclaw-sandbox

# 이미지가 없으면 샌드박스 이미지 빌드(소스 체크아웃 필요)
cd /opt/openclaw/openclaw
sudo -u openclaw ./scripts/sandbox-setup.sh
# 소스 체크아웃 없이 npm으로 설치한 경우 다음 참조
# https://docs.openclaw.ai/gateway/sandboxing#images-and-setup

sudo -i -u openclaw
openclaw channels login --channel <name>

​

고급 구성

• 보안 아키텍처
• 기술 세부 정보
• 문제 해결 가이드

​

관련 항목

• openclaw-ansible: 전체 배포 가이드
• Docker: 컨테이너화된 Gateway 설정
• 샌드박싱: 에이전트 샌드박스 구성
• 다중 에이전트 샌드박스 및 도구: 에이전트별 격리