跳转到主要内容

​
Ansible 安装

将 OpenClaw 部署到生产服务器的推荐方式是使用 openclaw-ansible — 一个采用安全优先架构的自动化安装工具。

​
快速开始

一条命令安装： 
curl -fsSL https://raw.githubusercontent.com/openclaw/openclaw-ansible/main/install.sh | bash
📦 完整指南：github.com/openclaw/openclaw-ansible openclaw-ansible 仓库是 Ansible 部署的权威来源。本页面仅为简要概览。

​
你将获得

  • 🔒 防火墙优先的安全策略：UFW + Docker 隔离（仅 SSH + Tailscale 可访问）
  • 🔐 Tailscale VPN：安全的远程访问，无需公开暴露服务
  • 🐳 Docker：隔离的沙箱容器，仅绑定 localhost
  • 🛡️ 纵深防御：4 层安全架构
  • 🚀 一条命令部署：几分钟内完成完整部署
  • 🔧 Systemd 集成：开机自启并带有安全加固

​
前置要求

  • 操作系统：Debian 11+ 或 Ubuntu 20.04+
  • 访问权限：Root 或 sudo 权限
  • 网络：用于安装软件包的互联网连接
  • Ansible：2.14+（快速启动脚本会自动安装）

​
安装内容

Ansible playbook 会安装并配置以下组件：
  1. Tailscale（用于安全远程访问的 mesh VPN）
  2. UFW 防火墙（仅开放 SSH + Tailscale 端口）
  3. Docker CE + Compose V2（用于智能体沙箱）
  4. Node.js 22.x + pnpm（运行时依赖）
  5. OpenClaw（基于主机安装，非容器化）
  6. Systemd 服务（带安全加固的自动启动）
注意：Gateway网关 直接运行在主机上（不在 Docker 中），但智能体沙箱使用 Docker 进行隔离。详见 沙箱。

​
安装后设置

安装完成后，切换到 openclaw 用户： 
sudo -i -u openclaw
安装后脚本将引导你完成：
  1. 新手引导向导：配置 OpenClaw 设置
  2. 提供商登录：连接 WhatsApp/Telegram/Discord/Signal
  3. Gateway网关测试：验证安装
  4. Tailscale 设置：连接到你的 VPN mesh 网络

​
常用命令

# 检查服务状态
sudo systemctl status openclaw

# 查看实时日志
sudo journalctl -u openclaw -f

# 重启 Gateway网关
sudo systemctl restart openclaw

# 提供商登录（以 openclaw 用户运行）
sudo -i -u openclaw
openclaw channels login

​
安全架构

​
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（SSH）为开放状态。所有其他服务（Gateway网关、Docker）均已锁定。

​
Docker 可用性

Docker 用于智能体沙箱（隔离的工具执行），而非运行 Gateway网关本身。Gateway网关仅绑定到 localhost，通过 Tailscale VPN 访问。 沙箱配置详见 多智能体沙箱与工具。

​
手动安装

如果你希望手动控制而非使用自动化： 
# 1. 安装前置依赖
sudo apt update && sudo apt install -y ansible git

# 2. 克隆仓库
git clone https://github.com/openclaw/openclaw-ansible.git
cd openclaw-ansible

# 3. 安装 Ansible 集合
ansible-galaxy collection install -r requirements.yml

# 4. 运行 playbook
./run-playbook.sh

# 或直接运行（之后手动执行 /tmp/openclaw-setup.sh）
# ansible-playbook playbook.yml --ask-become-pass

​
更新 OpenClaw

Ansible 安装程序将 OpenClaw 设置为手动更新。标准更新流程详见 更新。 重新运行 Ansible playbook（例如配置变更时）： 
cd openclaw-ansible
./run-playbook.sh
注意：此操作是幂等的，可以安全地多次运行。

​
故障排除

​
防火墙阻止了我的连接

如果你被锁定在外：
  • 确保先通过 Tailscale VPN 访问
  • SSH 访问（端口 22）始终是允许的
  • Gateway网关 仅可通过 Tailscale 访问，这是设计如此

​
服务无法启动

# 检查日志
sudo journalctl -u openclaw -n 100

# 验证权限
sudo ls -la /opt/openclaw

# 测试手动启动
sudo -i -u openclaw
cd ~/openclaw
pnpm start

​
Docker 沙箱问题

# 验证 Docker 是否运行
sudo systemctl status docker

# 检查沙箱镜像
sudo docker images | grep openclaw-sandbox

# 如果缺少沙箱镜像则构建
cd /opt/openclaw/openclaw
sudo -u openclaw ./scripts/sandbox-setup.sh

​
提供商登录失败

确保你以 openclaw 用户运行： 
sudo -i -u openclaw
openclaw channels login

​
高级配置

有关详细的安全架构和故障排除：

​
相关内容