OpenClawDocs
이 페이지에서

이 페이지에서

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Hosting

Ansible

OpenClaw를 보안 우선 아키텍처의 자동 설치 프로그램인 **openclaw-ansible**을 사용하여 프로덕션 서버에 배포하십시오.

사전 요구 사항

요구 사항 세부 정보
OS Debian 11+ 또는 Ubuntu 20.04+
액세스 Root 또는 sudo 권한
네트워크 패키지 설치를 위한 인터넷 연결
Ansible 2.14+ (빠른 시작 스크립트에서 자동으로 설치됨)

제공되는 기능

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

빠른 시작

bash
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 서비스

설치 후 설정

  • openclaw 사용자로 전환

    bash
    sudo -i -u openclaw

  • 온보딩 마법사 실행

    설치 후 스크립트가 OpenClaw 구성 과정을 안내합니다.

  • 메시징 채널 연결

    WhatsApp, Telegram, Discord 또는 Signal에 로그인하십시오.

    bash
    openclaw channels login --channel <name>

  • 설치 확인

    bash
    sudo systemctl status openclawsudo journalctl -u openclaw -f

  • Tailscale에 연결

    안전한 원격 액세스를 위해 VPN 메시에 참여하십시오.

    • 빠른 명령

    bash
    # 서비스 상태 확인sudo systemctl status openclaw # 실시간 로그 보기sudo journalctl -u openclaw -f # Gateway 재시작sudo systemctl restart openclaw # 채널 로그인(openclaw 사용자로 실행)sudo -i -u openclawopenclaw channels login --channel <name>

    보안 아키텍처

    4계층 방어 모델:

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

    외부 공격 표면을 확인하십시오.

    bash
    nmap -p- YOUR_SERVER_IP

    포트 22(SSH)만 열려 있어야 합니다. Gateway와 Docker는 계속 차단된 상태로 유지됩니다.

    Docker는 Gateway 실행용이 아니라 에이전트 샌드박스(격리된 도구 실행)용으로 설치됩니다. 샌드박스 구성은 다중 에이전트 샌드박스 및 도구를 참조하십시오.

    수동 설치

  • 사전 요구 사항 설치

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

  • 저장소 복제

    bash
    git clone https://github.com/openclaw/openclaw-ansible.gitcd openclaw-ansible

  • Ansible 컬렉션 설치

    bash
    ansible-galaxy collection install -r requirements.yml

  • 플레이북 실행

    bash
    ./run-playbook.sh

    또는 플레이북을 직접 실행한 후 설정 스크립트를 수동으로 실행하십시오.

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

    • 업데이트

    Ansible 설치 프로그램은 OpenClaw를 수동으로 업데이트하도록 설정합니다. 표준 절차는 업데이트를 참조하십시오.

    예를 들어 구성을 변경한 후 플레이북을 다시 실행하려면 다음 명령을 사용하십시오.

    bash
    cd openclaw-ansible./run-playbook.sh

    이 작업은 멱등성을 보장하므로 여러 번 안전하게 실행할 수 있습니다.

    문제 해결

    방화벽이 연결을 차단함
    • 먼저 Tailscale VPN을 통해 연결하십시오. Gateway는 설계상 이 방식으로만 접근할 수 있습니다.
    • SSH(포트 22)는 항상 허용됩니다.
    서비스가 시작되지 않음
    bash
    # 로그 확인sudo journalctl -u openclaw -n 100 # 권한 확인sudo ls -la /opt/openclaw # 수동 시작 테스트sudo -i -u openclawcd ~/openclawopenclaw gateway run
    Docker 샌드박스 문제
    bash
    # Docker 실행 여부 확인sudo systemctl status docker # 샌드박스 이미지 확인sudo docker images | grep openclaw-sandbox # 이미지가 없으면 샌드박스 이미지 빌드(소스 체크아웃 필요)cd /opt/openclaw/openclawsudo -u openclaw ./scripts/sandbox-setup.sh# 소스 체크아웃 없이 npm으로 설치한 경우 다음 참조# https://docs.openclaw.ai/gateway/sandboxing#images-and-setup
    채널 로그인 실패

    openclaw 사용자로 실행하고 있는지 확인하십시오.

    bash
    sudo -i -u openclawopenclaw channels login --channel <name>

    고급 구성

    자세한 보안 아키텍처 및 문제 해결 정보는 openclaw-ansible 저장소를 참조하십시오.

    관련 항목

    Was this useful?