Ansible

ปรับใช้ OpenClaw ไปยังเซิร์ฟเวอร์ production ด้วย openclaw-ansible -- ตัวติดตั้งอัตโนมัติที่ออกแบบสถาปัตยกรรมโดยให้ความสำคัญกับความปลอดภัยก่อน

ข้อกำหนดเบื้องต้น

สิ่งที่คุณจะได้รับ

• ความปลอดภัยแบบไฟร์วอลล์ก่อน -- UFW + การแยกด้วย Docker (เข้าถึงได้เฉพาะ SSH + Tailscale)
• Tailscale VPN -- การเข้าถึงระยะไกลที่ปลอดภัยโดยไม่เปิดเผยบริการต่อสาธารณะ
• Docker -- คอนเทนเนอร์แซนด์บ็อกซ์ที่แยกออกจากกัน พร้อมการ bind เฉพาะ localhost
• การป้องกันเชิงลึก -- สถาปัตยกรรมความปลอดภัย 4 ชั้น
• การผสานกับ Systemd -- เริ่มอัตโนมัติเมื่อบูตพร้อมการเสริมความปลอดภัย
• ตั้งค่าด้วยคำสั่งเดียว -- ปรับใช้เสร็จสมบูรณ์ภายในไม่กี่นาที

เริ่มต้นอย่างรวดเร็ว

ติดตั้งด้วยคำสั่งเดียว:

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

สิ่งที่ถูกติดตั้ง

Ansible playbook จะติดตั้งและกำหนดค่า:

1. Tailscale -- mesh VPN สำหรับการเข้าถึงระยะไกลที่ปลอดภัย
2. ไฟร์วอลล์ UFW -- เฉพาะพอร์ต SSH + Tailscale เท่านั้น
3. Docker CE + Compose V2 -- สำหรับ backend แซนด์บ็อกซ์เอเจนต์เริ่มต้น
4. Node.js 24 + pnpm -- dependency สำหรับ runtime (Node 22 LTS ซึ่งปัจจุบันคือ 22.19+ ยังรองรับอยู่)
5. OpenClaw -- ทำงานบนโฮสต์ ไม่ได้อยู่ในคอนเทนเนอร์
6. บริการ Systemd -- เริ่มอัตโนมัติพร้อมการเสริมความปลอดภัย

การตั้งค่าหลังติดตั้ง

sudo -i -u openclaw

openclaw channels login

sudo systemctl status openclawsudo journalctl -u openclaw -f

คำสั่งด่วน

# Check service statussudo systemctl status openclaw # View live logssudo journalctl -u openclaw -f # Restart gatewaysudo systemctl restart openclaw # Provider login (run as openclaw user)sudo -i -u openclawopenclaw channels login

สถาปัตยกรรมความปลอดภัย

การปรับใช้นี้ใช้โมเดลการป้องกัน 4 ชั้น:

1. ไฟร์วอลล์ (UFW) -- เปิดเผยต่อสาธารณะเฉพาะ SSH (22) + Tailscale (41641/udp)
2. VPN (Tailscale) -- Gateway เข้าถึงได้ผ่าน VPN mesh เท่านั้น
3. การแยกด้วย Docker -- เชน iptables แบบ DOCKER-USER ป้องกันการเปิดเผยพอร์ตภายนอก
4. การเสริมความปลอดภัยของ Systemd -- NoNewPrivileges, PrivateTmp, ผู้ใช้ที่ไม่มีสิทธิ์พิเศษ

เพื่อตรวจสอบพื้นผิวการโจมตีภายนอกของคุณ:

nmap -p- YOUR_SERVER_IP

ควรมีเฉพาะพอร์ต 22 (SSH) ที่เปิดอยู่ บริการอื่นทั้งหมด (Gateway, Docker) จะถูกล็อกไว้

Docker ถูกติดตั้งสำหรับแซนด์บ็อกซ์ของเอเจนต์ (การเรียกใช้เครื่องมือแบบแยกส่วน) ไม่ใช่สำหรับเรียกใช้ Gateway เอง ดูการกำหนดค่าแซนด์บ็อกซ์ได้ที่ แซนด์บ็อกซ์และเครื่องมือแบบหลายเอเจนต์

การติดตั้งด้วยตนเอง

หากคุณต้องการควบคุมการทำงานอัตโนมัติด้วยตนเอง:

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

การอัปเดต

ตัวติดตั้ง Ansible จะตั้งค่า OpenClaw สำหรับการอัปเดตด้วยตนเอง ดูขั้นตอนการอัปเดตมาตรฐานได้ที่ การอัปเดต

หากต้องการเรียกใช้ Ansible playbook อีกครั้ง (เช่น สำหรับการเปลี่ยนแปลงการกำหนดค่า):

cd openclaw-ansible./run-playbook.sh

คำสั่งนี้เป็นแบบ idempotent และปลอดภัยที่จะเรียกใช้หลายครั้ง

การแก้ไขปัญหา

# Check logssudo journalctl -u openclaw -n 100 # Verify permissionssudo ls -la /opt/openclaw # Test manual startsudo -i -u openclawcd ~/openclawopenclaw gateway run

# Verify Docker is runningsudo systemctl status docker # Check sandbox imagesudo docker images | grep openclaw-sandbox # Build sandbox image if missing (requires source checkout)cd /opt/openclaw/openclawsudo -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 openclawopenclaw channels login

การกำหนดค่าขั้นสูง

สำหรับสถาปัตยกรรมความปลอดภัยและการแก้ไขปัญหาโดยละเอียด ดูรีโป openclaw-ansible:

• สถาปัตยกรรมความปลอดภัย
• รายละเอียดทางเทคนิค
• คู่มือการแก้ไขปัญหา

ที่เกี่ยวข้อง

• openclaw-ansible -- คู่มือการปรับใช้ฉบับเต็ม
• Docker -- การตั้งค่า Gateway แบบคอนเทนเนอร์
• แซนด์บ็อกซ์ -- การกำหนดค่าแซนด์บ็อกซ์ของเอเจนต์
• แซนด์บ็อกซ์และเครื่องมือแบบหลายเอเจนต์ -- การแยกต่อเอเจนต์