Ansible

​

前置要求

​

你将获得

• 防火墙优先的安全设计：UFW + Docker 隔离（仅可访问 SSH + Tailscale）
• 使用 Tailscale VPN 进行远程访问，无需向公网暴露服务
• 用于隔离沙箱容器的 Docker，仅绑定到 localhost
• 集成经过安全加固的 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 和 pnpm（OpenClaw 要求 Node 22.22.3+、24.15+ 或 25.9+；推荐使用 Node 24）
5. OpenClaw，直接安装在主机上，而非容器化部署
6. 经过安全加固的 systemd 服务

​

安装后设置

sudo -i -u openclaw

openclaw channels login --channel <name>

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 --channel <name>

​

安全架构

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
# 对于没有源代码检出的 npm 安装，请参阅
# https://docs.openclaw.ai/gateway/sandboxing#images-and-setup

sudo -i -u openclaw
openclaw channels login --channel <name>

​

高级配置

• 安全架构
• 技术细节
• 故障排查指南

​

相关内容

• openclaw-ansible：完整部署指南
• Docker：容器化 Gateway 网关设置
• 沙箱隔离：智能体沙箱配置
• 多 Agent 沙盒和工具：按智能体隔离