​

Ansible 安裝

​

必要條件

​

你將獲得

• 防火牆優先安全性──UFW + Docker 隔離（只有 SSH + Tailscale 可存取）
• Tailscale VPN──安全的遠端存取，無需公開暴露服務
• Docker──隔離的沙箱容器，localhost 專用繫結
• 深度防禦──4 層安全架構
• Systemd 整合──開機自動啟動並加強安全性
• 一鍵設定──完整部署只需幾分鐘

​

快速開始

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 24 + pnpm──執行時期相依性（Node 22 LTS，目前 22.16+，仍然支援）
5. OpenClaw──基於主機，非容器化
6. Systemd 服務──開機自動啟動並加強安全性

​

安裝後設定

sudo -i -u openclaw

openclaw channels login

sudo systemctl status openclaw
sudo journalctl -u openclaw -f

​

快速命令

# 檢查服務狀態
sudo systemctl status openclaw

# 查看即時日誌
sudo journalctl -u openclaw -f

# 重啟 gateway
sudo systemctl restart openclaw

# 提供者登入（以 openclaw 使用者執行）
sudo -i -u openclaw
openclaw channels login

​

安全架構

1. **防火牆 (UFW)**──只有 SSH (22) + Tailscale (41641/udp) 公開暴露
2. **VPN (Tailscale)**──gateway 只能通過 VPN 網格存取
3. Docker 隔離──DOCKER-USER iptables 鏈防止外部埠暴露
4. Systemd 強化──NoNewPrivileges、PrivateTmp、無權限使用者

nmap -p- YOUR_SERVER_IP

​

手動安裝

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

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

ansible-galaxy collection install -r requirements.yml

./run-playbook.sh

ansible-playbook playbook.yml --ask-become-pass
# 然後執行: /tmp/openclaw-setup.sh

​

更新

cd openclaw-ansible
./run-playbook.sh

​

故障排除

# 檢查日誌
sudo journalctl -u openclaw -n 100

# 驗證權限
sudo ls -la /opt/openclaw

# 測試手動啟動
sudo -i -u openclaw
cd ~/openclaw
openclaw gateway run

# 驗證 Docker 正在執行
sudo systemctl status docker

# 檢查沙箱映像
sudo docker images | grep openclaw-sandbox

# 如果遺失，建立沙箱映像
cd /opt/openclaw/openclaw
sudo -u openclaw ./scripts/sandbox-setup.sh

sudo -i -u openclaw
openclaw channels login

​

進階配置

• 安全架構
• 技術細節
• 故障排查指南

​

相關

• openclaw-ansible──完整部署指南
• Docker──容器化 gateway 設定
• 沙箱──代理沙箱配置
• 多代理沙箱和工具──個別代理隔離