Skip to main content

Ansible 安裝

將 OpenClaw 部署到正式環境伺服器的建議方式,是使用 openclaw-ansible —— 一個以安全優先架構為核心的自動化安裝器。

快速開始

單一指令安裝:
📦 完整指南:github.com/openclaw/openclaw-ansible The openclaw-ansible repo is the source of truth for Ansible deployment. 安裝內容

你會得到什麼

  • 🔒 防火牆優先的安全性:UFW + Docker 隔離(僅開放 SSH + Tailscale)
  • 🔐 Tailscale VPN:在不公開服務的情況下,提供安全的遠端存取
  • 🐳 Docker:隔離的沙箱容器,僅繫結至 localhost
  • 🛡️ 縱深防禦:4 層安全架構
  • 🚀 單一指令完成設定:數分鐘內完成完整部署
  • 🔧 Systemd 整合:開機自動啟動並套用安全性強化

需求

  • 作業系統:Debian 11+ 或 Ubuntu 20.04+
  • 存取權限:Root 或 sudo 權限
  • 網路:可連線至網際網路以安裝套件
  • Ansible:2.14+(由快速開始腳本自動安裝)

詳情請參閱 Sandboxing

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 進行隔離。詳細說明請參考 Sandboxing。 安裝後腳本將引導你完成: 詳情請參閱 Sandboxing

安裝後設定

安裝完成後,切換至 openclaw 使用者:
應該 只開放 22 埠(SSH)。
  1. 入門引導精靈:設定 OpenClaw
  2. 提供者登入:連接 WhatsApp/Telegram/Discord/Signal
  3. Gateway 測試:驗證安裝是否成功
  4. Tailscale 設定:連線至你的 VPN Mesh

快速指令

安全性架構

4 層防禦

  1. 防火牆(UFW):僅公開 SSH(22)+ Tailscale(41641/udp)
  2. VPN(Tailscale):Gateway 僅能透過 VPN Mesh 存取
  3. Docker 隔離:DOCKER-USER iptables 鏈防止外部連接埠暴露
  4. Systemd 強化:NoNewPrivileges、PrivateTmp、非特權使用者

驗證

測試外部攻擊面:
應該 只開放 22 埠(SSH)。 Docker 是為了 agent sandboxes(隔離的工具執行)而安裝的,並非用來執行 gateway 本身。

Docker 可用性

所有其他服務(gateway、Docker)都已鎖定。 Docker 是為了 agent sandboxes(隔離的工具執行)而安裝的,並非用來執行 gateway 本身。 標準更新流程請參閱 Updating 請參考 Multi-Agent Sandbox & Tools 以了解沙箱設定。

手動安裝

如果你偏好對自動化流程有完全的手動控制:

更新 OpenClaw

Ansible 安裝器會將 OpenClaw 設定為手動更新。標準更新流程請參考 Updating。 疑難排解 疑難排解 若要重新執行 Ansible playbook(例如套用設定變更):
注意:此操作具備冪等性,可安全地重複執行多次。

相關

防火牆阻擋了我的連線

如果你被鎖在外部:
  • 請先確認可以透過 Tailscale VPN 存取
  • SSH 存取(連接埠 22)始終允許
  • Gateway 依設計 僅能 透過 Tailscale 存取

服務無法啟動

Docker 沙箱問題

提供者登入失敗

請確認你是以 openclaw 使用者身分執行:

進階設定

如需深入了解安全性架構與疑難排解:

你遇到了 Bun 安裝/修補/生命週期腳本的問題