​

Instalação com Ansible

​

Início Rápido

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

📦 Guia completo: github.com/openclaw/openclaw-ansible O repositório openclaw-ansible é a fonte de verdade para implantação com Ansible. Esta página é apenas uma visão geral rápida.

​

O que você recebe

• 🔒 Segurança com foco em firewall: UFW + isolamento do Docker (apenas SSH + Tailscale acessíveis)
• 🔐 VPN Tailscale: Acesso remoto seguro sem expor serviços publicamente
• 🐳 Docker: Containers de sandbox isolados, com bindings apenas para localhost
• 🛡️ Defesa em profundidade: Arquitetura de segurança em 4 camadas
• 🚀 Configuração com um comando: Implantação completa em minutos
• 🔧 Integração com systemd: Inicialização automática no boot com hardening

​

Requisitos

• SO: Debian 11+ ou Ubuntu 20.04+
• Acesso: Privilégios de root ou sudo
• Rede: Conexão com a internet para instalação de pacotes
• Ansible: 2.14+ (instalado automaticamente pelo script de início rápido)

​

O que é instalado

1. Tailscale (VPN mesh para acesso remoto seguro)
2. Firewall UFW (apenas portas de SSH + Tailscale)
3. Docker CE + Compose V2 (para sandboxes de agentes)
4. Node.js 22.x + pnpm (dependências de runtime)
5. OpenClaw (baseado no host, não containerizado)
6. Serviço systemd (inicialização automática com hardening de segurança)

​

Configuração pós-instalação

sudo -i -u openclaw

1. Assistente de onboarding: Configurar as definições do OpenClaw
2. Login de provedor: Conectar WhatsApp/Telegram/Discord/Signal
3. Teste do Gateway: Verificar a instalação
4. Configuração do Tailscale: Conectar à sua malha VPN

​

Comandos rápidos

# 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

​

Arquitetura de segurança

​

Defesa em 4 camadas

1. Firewall (UFW): Apenas SSH (22) + Tailscale (41641/udp) expostos publicamente
2. VPN (Tailscale): Gateway acessível apenas pela malha VPN
3. Isolamento do Docker: A chain DOCKER-USER do iptables impede a exposição externa de portas
4. Hardening do systemd: NoNewPrivileges, PrivateTmp, usuário sem privilégios

​

Verificação

nmap -p- YOUR_SERVER_IP

​

Disponibilidade do Docker

​

Instalação manual

# 1. Install prerequisites
sudo apt update && sudo apt install -y ansible git

# 2. Clone repository
git clone https://github.com/openclaw/openclaw-ansible.git
cd openclaw-ansible

# 3. Install Ansible collections
ansible-galaxy collection install -r requirements.yml

# 4. Run playbook
./run-playbook.sh

# Or run directly (then manually execute /tmp/openclaw-setup.sh after)
# ansible-playbook playbook.yml --ask-become-pass

​

Atualizando o OpenClaw

cd openclaw-ansible
./run-playbook.sh

​

Solução de problemas

​

O firewall bloqueia minha conexão

• Certifique-se de conseguir acessar primeiro via VPN Tailscale
• O acesso SSH (porta 22) é sempre permitido
• O gateway é acessível apenas via Tailscale por design

​

O serviço não inicia

# Check logs
sudo journalctl -u openclaw -n 100

# Verify permissions
sudo ls -la /opt/openclaw

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

​

Problemas com sandbox do Docker

# Verify Docker is running
sudo systemctl status docker

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

# Build sandbox image if missing
cd /opt/openclaw/openclaw
sudo -u openclaw ./scripts/sandbox-setup.sh

​

Falha no login do provedor

sudo -i -u openclaw
openclaw channels login

​

Configuração avançada

• Arquitetura de segurança
• Detalhes técnicos
• Guia de solução de problemas

​

Relacionado

• openclaw-ansible — guia completo de implantação
• Docker — configuração de gateway containerizado
• Sandboxing — configuração de sandbox de agentes
• Multi-Agent Sandbox & Tools — isolamento por agente