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 (mesh VPN for secure remote access)
2. UFW firewall (SSH + Tailscale ports only)
3. Docker CE + Compose V2 (default agent sandbox backend)
4. Node.js and pnpm (OpenClaw requires Node 22.22.3+, 24.15+, or 25.9+; Node 26 is recommended)
5. OpenClaw, installed host-based, not containerized
6. A systemd service with security hardening

​

安装后设置

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

# 重启网关
sudo systemctl restart openclaw

# 渠道登录（以 openclaw 用户身份运行）
sudo -i -u openclaw
openclaw channels login --channel <name>

​

安全架构

1. 防火墙（UFW）：仅对外开放 SSH（22）和 Tailscale（41641/udp）
2. VPN（Tailscale）：网关只能通过 VPN mesh 访问
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: 容器化网关设置
• Sandboxing: 代理沙盒配置
• Multi-Agent Sandbox and Tools: 按代理隔离