Ansible

OpenClaw를 **openclaw-ansible**로 프로덕션 서버에 배포하세요. 보안을 우선하는 아키텍처를 갖춘 자동 설치 프로그램입니다.

# 필수 조건

# 제공되는 항목

• 방화벽 우선 보안 -- UFW + Docker 격리(SSH + Tailscale만 접근 가능)
• Tailscale VPN -- 서비스를 공개적으로 노출하지 않는 안전한 원격 접근
• Docker -- 격리된 샌드박스 컨테이너, localhost 전용 바인딩
• 심층 방어 -- 4계층 보안 아키텍처
• Systemd 통합 -- 강화 설정과 함께 부팅 시 자동 시작
• 단일 명령 설정 -- 몇 분 안에 전체 배포 완료

# 빠른 시작

단일 명령 설치:

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

# 설치되는 항목

Ansible 플레이북은 다음을 설치하고 구성합니다.

1. Tailscale -- 안전한 원격 접근을 위한 메시 VPN
2. UFW 방화벽 -- SSH + Tailscale 포트만 허용
3. Docker CE + Compose V2 -- 기본 에이전트 샌드박스 백엔드용
4. Node.js 24 + pnpm -- 런타임 의존성(Node 22 LTS, 현재 22.16+, 계속 지원됨)
5. OpenClaw -- 컨테이너화되지 않은 호스트 기반
6. Systemd 서비스 -- 보안 강화와 함께 자동 시작

# 설치 후 설정

sudo -i -u openclaw

openclaw channels login

sudo systemctl status openclaw
sudo journalctl -u openclaw -f

# 빠른 명령

# Check service status
sudo systemctl status openclaw

# View live logs
sudo journalctl -u openclaw -f

# Restart gateway
sudo systemctl restart openclaw

# Provider login (run as openclaw user)
sudo -i -u openclaw
openclaw channels login

# 보안 아키텍처

배포는 4계층 방어 모델을 사용합니다.

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

외부 공격 표면을 확인하려면 다음을 실행하세요.

nmap -p- YOUR_SERVER_IP

포트 22(SSH)만 열려 있어야 합니다. 다른 모든 서비스(Gateway, Docker)는 잠겨 있습니다.

Docker는 Gateway 자체를 실행하기 위한 것이 아니라 에이전트 샌드박스(격리된 도구 실행)를 위해 설치됩니다. 샌드박스 구성은 Multi-Agent Sandbox and Tools를 참조하세요.

# 수동 설치

자동화 대신 수동 제어를 선호하는 경우:

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
# Then run: /tmp/openclaw-setup.sh

# 업데이트

Ansible 설치 프로그램은 OpenClaw를 수동 업데이트에 맞게 설정합니다. 표준 업데이트 흐름은 Updating을 참조하세요.

Ansible 플레이북을 다시 실행하려면(예: 구성 변경):

cd openclaw-ansible
./run-playbook.sh

이는 멱등적이며 여러 번 실행해도 안전합니다.

# 문제 해결

# Check logs
sudo journalctl -u openclaw -n 100

# Verify permissions
sudo ls -la /opt/openclaw

# Test manual start
sudo -i -u openclaw
cd ~/openclaw
openclaw gateway run

# Verify Docker is running
sudo systemctl status docker

# Check sandbox image
sudo docker images | grep openclaw-sandbox

# Build sandbox image if missing (requires source checkout)
cd /opt/openclaw/openclaw
sudo -u openclaw ./scripts/sandbox-setup.sh
# For npm installs without a source checkout, see
# https://docs.openclaw.ai/gateway/sandboxing#images-and-setup

sudo -i -u openclaw
openclaw channels login

# 고급 구성

자세한 보안 아키텍처와 문제 해결은 openclaw-ansible 저장소를 참조하세요.

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

# 관련 항목

• openclaw-ansible -- 전체 배포 가이드
• Docker -- 컨테이너화된 Gateway 설정
• Sandboxing -- 에이전트 샌드박스 구성
• Multi-Agent Sandbox and Tools -- 에이전트별 격리