Ansible

Deploy OpenClaw ke server produksi dengan openclaw-ansible, penginstal otomatis dengan arsitektur yang mengutamakan keamanan.

Prasyarat

Yang Anda dapatkan

• Keamanan yang mengutamakan firewall: UFW + isolasi Docker (hanya SSH + Tailscale yang dapat dijangkau)
• VPN Tailscale untuk akses jarak jauh tanpa mengekspos layanan secara publik
• Docker untuk kontainer sandbox terisolasi dengan pengikatan khusus localhost
• Integrasi systemd dengan penguatan keamanan, dimulai otomatis saat boot
• Penyiapan dengan satu perintah

Mulai cepat

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

Yang diinstal

1. Tailscale (VPN mesh untuk akses jarak jauh yang aman)
2. Firewall UFW (hanya port SSH + Tailscale)
3. Docker CE + Compose V2 (backend sandbox agen default)
4. Node.js dan pnpm (OpenClaw memerlukan Node 22.22.3+, 24.15+, atau 25.9+; Node 24 direkomendasikan)
5. OpenClaw, diinstal langsung pada host, bukan dalam kontainer
6. Layanan systemd dengan penguatan keamanan

Penyiapan setelah penginstalan

sudo -i -u openclaw

openclaw channels login --channel <name>

sudo systemctl status openclawsudo journalctl -u openclaw -f

Perintah cepat

# Periksa status layanansudo systemctl status openclaw # Lihat log langsungsudo journalctl -u openclaw -f # Mulai ulang gatewaysudo systemctl restart openclaw # Masuk ke saluran (jalankan sebagai pengguna openclaw)sudo -i -u openclawopenclaw channels login --channel <name>

Arsitektur keamanan

Model pertahanan empat lapis:

1. Firewall (UFW): hanya SSH (22) dan Tailscale (41641/udp) yang diekspos secara publik
2. VPN (Tailscale): Gateway hanya dapat dijangkau melalui mesh VPN
3. Isolasi Docker: rantai iptables DOCKER-USER mencegah eksposur port eksternal
4. Penguatan systemd: NoNewPrivileges, PrivateTmp, pengguna tanpa hak istimewa

Verifikasi permukaan serangan eksternal Anda:

nmap -p- YOUR_SERVER_IP

Hanya port 22 (SSH) yang seharusnya terbuka. Gateway dan Docker tetap terkunci.

Docker diinstal untuk sandbox agen (eksekusi alat yang terisolasi), bukan untuk menjalankan Gateway. Lihat Sandbox dan Alat Multiagen untuk konfigurasi sandbox.

Penginstalan manual

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

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

ansible-galaxy collection install -r requirements.yml

./run-playbook.sh

ansible-playbook playbook.yml --ask-become-pass# Kemudian jalankan: /tmp/openclaw-setup.sh

Memperbarui

Penginstal Ansible menyiapkan OpenClaw untuk pembaruan manual; lihat Memperbarui untuk alur standar.

Untuk menjalankan ulang playbook (misalnya, setelah perubahan konfigurasi):

cd openclaw-ansible./run-playbook.sh

Proses ini idempoten dan aman dijalankan beberapa kali.

Pemecahan masalah

# Periksa logsudo journalctl -u openclaw -n 100 # Verifikasi izinsudo ls -la /opt/openclaw # Uji pemulaian manualsudo -i -u openclawcd ~/openclawopenclaw gateway run

# Verifikasi Docker sedang berjalansudo systemctl status docker # Periksa image sandboxsudo docker images | grep openclaw-sandbox # Bangun image sandbox jika tidak ada (memerlukan checkout sumber)cd /opt/openclaw/openclawsudo -u openclaw ./scripts/sandbox-setup.sh# Untuk penginstalan npm tanpa checkout sumber, lihat# https://docs.openclaw.ai/gateway/sandboxing#images-and-setup

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

Konfigurasi lanjutan

Untuk arsitektur keamanan dan pemecahan masalah yang terperinci, lihat repositori openclaw-ansible:

• Arsitektur Keamanan
• Detail Teknis
• Panduan Pemecahan Masalah

Terkait

• openclaw-ansible: panduan deployment lengkap
• Docker: penyiapan Gateway dalam kontainer
• Sandbox: konfigurasi sandbox agen
• Sandbox dan Alat Multiagen: isolasi per agen