​

Cài đặt Ansible

​

Khởi động nhanh

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

📦 Hướng dẫn đầy đủ: github.com/openclaw/openclaw-ansible The openclaw-ansible repo is the source of truth for Ansible deployment. This page is a quick overview.

​

Những gì bạn nhận được

• 🔒 Bảo mật ưu tiên firewall: UFW + cô lập Docker (chỉ cho phép SSH + Tailscale)
• 🔐 VPN Tailscale: Truy cập từ xa an toàn mà không cần phơi bày dịch vụ ra Internet
• 🐳 Docker: Các container sandbox cô lập, chỉ bind localhost
• 🛡️ Phòng thủ nhiều lớp: Kiến trúc bảo mật 4 lớp
• 🚀 Thiết lập một lệnh: Triển khai hoàn chỉnh trong vài phút
• 🔧 Tích hợp systemd: Tự khởi động khi boot kèm tăng cường bảo mật

​

Yêu cầu

• OS: Debian 11+ hoặc Ubuntu 20.04+
• Quyền truy cập: Quyền root hoặc sudo
• Mạng: Kết nối Internet để cài đặt gói
• Ansible: 2.14+ (được cài tự động bởi script khởi động nhanh)

​

Những gì được cài đặt

1. Tailscale (VPN mesh cho truy cập từ xa an toàn)
2. Firewall UFW (chỉ mở cổng SSH + Tailscale)
3. Docker CE + Compose V2 (cho sandbox của tác tử)
4. Node.js 22.x + pnpm (phụ thuộc runtime)
5. OpenClaw (chạy trên host, không container hóa)
6. Dịch vụ systemd (tự khởi động kèm tăng cường bảo mật)

​

Thiết lập sau cài đặt

sudo -i -u openclaw

1. Trình hướng dẫn ban đầu: Cấu hình các thiết lập OpenClaw
2. Đăng nhập nhà cung cấp: Kết nối WhatsApp/Telegram/Discord/Signal
3. Kiểm tra Gateway: Xác minh cài đặt
4. Thiết lập Tailscale: Kết nối vào mesh VPN của bạn

​

Lệnh nhanh

# 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

​

Kiến trúc bảo mật

​

Phòng thủ 4 lớp

1. Firewall (UFW): Chỉ công khai SSH (22) + Tailscale (41641/udp)
2. VPN (Tailscale): Gateway chỉ truy cập được qua mesh VPN
3. Cô lập Docker: Chuỗi iptables DOCKER-USER ngăn phơi bày cổng ra ngoài
4. Tăng cường systemd: NoNewPrivileges, PrivateTmp, người dùng không đặc quyền

​

Xác minh

nmap -p- YOUR_SERVER_IP

​

Khả dụng của Docker

​

Cài đặt thủ công

# 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

​

Cập nhật OpenClaw

cd openclaw-ansible
./run-playbook.sh

​

Xử lý sự cố

​

Firewall chặn kết nối của tôi

• Đảm bảo bạn có thể truy cập qua VPN Tailscale trước
• Truy cập SSH (cổng 22) luôn được cho phép
• Gateway chỉ có thể truy cập qua Tailscale theo thiết kế

​

Dịch vụ không khởi động

# 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

​

Sự cố sandbox 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

​

Đăng nhập nhà cung cấp thất bại

sudo -i -u openclaw
openclaw channels login

​

Cấu hình nâng cao

• Kiến trúc bảo mật
• Chi tiết kỹ thuật
• Hướng dẫn xử lý sự cố

​

Liên quan

• openclaw-ansible — hướng dẫn triển khai đầy đủ
• Docker — thiết lập gateway dạng container
• Sandboxing — cấu hình sandbox của tác tử
• Multi-Agent Sandbox & Tools — cô lập theo từng tác tử