Ansible 自动化部署

通过 openclaw-ansible 自动化部署 OpenClaw 到生产服务器，内置安全加固架构。

前置条件

要求	详情
OS	Debian 11+ 或 Ubuntu 20.04+
权限	root 或 sudo
网络	可访问互联网
Ansible	2.14+（快速启动脚本自动安装）

一键安装

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

安装内容

1. Tailscale — 安全远程访问的 mesh VPN
2. UFW 防火墙 — 仅开放 SSH + Tailscale 端口
3. Docker CE + Compose V2 — 默认 agent sandbox 后端
4. Node.js 24 + pnpm — 运行时依赖
5. OpenClaw — 直接运行在宿主机（非容器化）
6. Systemd service — 开机自启，含安全加固

Gateway 直接运行在宿主机，Docker 仅用于 agent sandbox。

安装后配置

# 切换到 openclaw 用户
sudo -i -u openclaw
 
# 连接 messaging providers
openclaw channels login
 
# 验证安装
sudo systemctl status openclaw
sudo journalctl -u openclaw -f

安全架构（4 层防御）

1. 防火墙（UFW） — 仅公开 SSH(22) + Tailscale(41641/udp)
2. VPN（Tailscale） — Gateway 仅通过 VPN mesh 访问
3. Docker 隔离 — DOCKER-USER iptables 链阻止外部端口暴露
4. Systemd 加固 — NoNewPrivileges、PrivateTmp、非特权用户

验证外部攻击面：

nmap -p- YOUR_SERVER_IP
# 只有端口 22 应该开放

手动安装

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

更新

cd openclaw-ansible
./run-playbook.sh  # 幂等，可多次运行

相关链接

• install-docker — Docker 容器化安装
• install-updating — 标准更新流程