{"id":153,"date":"2026-03-21T22:47:20","date_gmt":"2026-03-21T14:47:20","guid":{"rendered":"https:\/\/pa.yingzhi8.cn\/index.php\/2026\/03\/21\/install-ansible\/"},"modified":"2026-03-21T23:23:48","modified_gmt":"2026-03-21T15:23:48","slug":"install-ansible","status":"publish","type":"post","link":"https:\/\/pa.yingzhi8.cn\/index.php\/2026\/03\/21\/install-ansible\/","title":{"rendered":"Ansible"},"content":{"rendered":"

Ansible<\/h1>\n

Ansible 安装<\/h1>\n

将 OpenClaw 部署到生产服务器的推荐方式是通过 openclaw-ansible<\/a><\/strong> — 一个安全优先架构的自动化安装程序。<\/p>\n

快速开始<\/h2>\n

一条命令安装：<\/p>\n

“`bash theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}}
\ncurl -fsSL https:\/\/raw.githubusercontent.com\/openclaw\/openclaw-ansible\/main\/install.sh | bash<\/p>\n

\n> **📦 完整指南：[github.com\/openclaw\/openclaw-ansible](https:\/\/github.com\/openclaw\/openclaw-ansible)**\n>\n> openclaw-ansible 仓库是 Ansible 部署的权威来源。本页是快速概述。\n\n## 你将获得\n\n* 🔒 **防火墙优先安全**：UFW + Docker 隔离（仅 SSH + Tailscale 可访问）\n* 🔐 **Tailscale VPN**：安全远程访问，无需公开暴露服务\n* 🐳 **Docker**：隔离的沙箱容器，仅绑定 localhost\n* 🛡️ **纵深防御**：4 层安全架构\n* 🚀 **一条命令设置**：几分钟内完成部署\n* 🔧 **Systemd 集成**：带加固的开机自启动\n\n## 要求\n\n* **操作系统**：Debian 11+ 或 Ubuntu 20.04+\n* **访问权限**：Root 或 sudo 权限\n* **网络**：用于包安装的互联网连接\n* **Ansible**：2.14+（由快速启动脚本自动安装）\n\n## 安装内容\n\nAnsible playbook 安装并配置：\n\n1. **Tailscale**（用于安全远程访问的 mesh VPN）\n2. **UFW 防火墙**（仅允许 SSH + Tailscale 端口）\n3. **Docker CE + Compose V2**（用于智能体沙箱）\n4. **Node.js 22.x + pnpm**（运行时依赖）\n5. **OpenClaw**（基于主机，非容器化）\n6. **Systemd 服务**（带安全加固的自动启动）\n\n注意：Gateway 网关**直接在主机上运行**（不在 Docker 中），但智能体沙箱使用 Docker 进行隔离。详情参见[沙箱隔离](\/gateway\/sandboxing)。\n\n## 安装后设置\n\n安装完成后，切换到 openclaw 用户：\n\n```bash  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\nsudo -i -u openclaw\n<\/code><\/pre>\n
安装后脚本将引导你完成：<\/p>\n
    \n
  1. 新手引导向导<\/strong>：配置 OpenClaw 设置<\/li>\n
  2. 提供商登录<\/strong>：连接 WhatsApp\/Telegram\/Discord\/Signal<\/li>\n
  3. Gateway 网关测试<\/strong>：验证安装<\/li>\n
  4. Tailscale 设置<\/strong>：连接到你的 VPN mesh<\/li>\n<\/ol>\n
    常用命令<\/h3>\n
    “`bash  theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}}<\/p>\n
    检查服务状态<\/h1>\n
    sudo systemctl status openclaw<\/p>\n
    查看实时日志<\/h1>\n
    sudo journalctl -u openclaw -f<\/p>\n
    重启 Gateway 网关<\/h1>\n
    sudo systemctl restart openclaw<\/p>\n
    提供商登录（以 openclaw 用户运行）<\/h1>\n
    sudo -i -u openclaw
    \nopenclaw channels login<\/p>\n
    \n## 安全架构\n\n### 4 层防御\n\n1. **防火墙（UFW）**：仅公开暴露 SSH（22）+ Tailscale（41641\/udp）\n2. **VPN（Tailscale）**：Gateway 网关仅通过 VPN mesh 可访问\n3. **Docker 隔离**：DOCKER-USER iptables 链防止外部端口暴露\n4. **Systemd 加固**：NoNewPrivileges、PrivateTmp、非特权用户\n\n### 验证\n\n测试外部攻击面：\n\n```bash  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\nnmap -p- YOUR_SERVER_IP\n<\/code><\/pre>\n
    应该显示仅端口 22<\/strong>（SSH）开放。所有其他服务（Gateway 网关、Docker）都被锁定。<\/p>\n
    Docker 可用性<\/h3>\n
    Docker 用于智能体沙箱<\/strong>（隔离的工具执行），而不是用于运行 Gateway 网关本身。Gateway 网关仅绑定到 localhost，通过 Tailscale VPN 访问。<\/p>\n
    沙箱配置参见多智能体沙箱与工具<\/a>。<\/p>\n
    手动安装<\/h2>\n
    如果你更喜欢手动控制而非自动化：<\/p>\n
    “`bash  theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}}<\/p>\n
    1. 安装先决条件<\/h1>\n
    sudo apt update && sudo apt install -y ansible git<\/p>\n
    2. 克隆仓库<\/h1>\n
    git clone https:\/\/github.com\/openclaw\/openclaw-ansible.git
    \ncd openclaw-ansible<\/p>\n
    3. 安装 Ansible collections<\/h1>\n
    ansible-galaxy collection install -r requirements.yml<\/p>\n
    4. 运行 playbook<\/h1>\n
    .\/run-playbook.sh<\/p>\n
    或直接运行（然后手动执行 \/tmp\/openclaw-setup.sh）<\/h1>\n
    ansible-playbook playbook.yml –ask-become-pass<\/h1>\n
    \n## 更新 OpenClaw\n\nAnsible 安装程序设置 OpenClaw 为手动更新。标准更新流程参见[更新](\/install\/updating)。\n\n要重新运行 Ansible playbook（例如，用于配置更改）：\n\n```bash  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\ncd openclaw-ansible\n.\/run-playbook.sh\n<\/code><\/pre>\n
    注意：这是幂等的，可以安全地多次运行。<\/p>\n
    故障排除<\/h2>\n
    防火墙阻止了我的连接<\/h3>\n
    如果你被锁定：<\/p>\n