跳到主要内容

Ansible 安装

向生产服务器部署 Clawdbot 的推荐方式是通过 clawdbot-ansible —— 一个采用安全优先架构的自动化安装程序。

快速开始​

一键安装：

curl -fsSL https://raw.githubusercontent.com/clawdbot/clawdbot-ansible/main/install.sh | bash

📦 完整指南：github.com/clawdbot/clawdbot-ansible

clawdbot-ansible 仓库是 Ansible 部署的权威来源。本页面仅提供快速概览。

你将获得​

  • 🔒 防火墙优先的安全策略：UFW + Docker 隔离（仅允许 SSH + Tailscale 访问）
  • 🔐 Tailscale VPN：安全的远程访问，无需公开暴露服务
  • 🐳 Docker：隔离的沙箱容器，仅限本地回环绑定
  • 🛡️ 纵深防御：4 层安全架构
  • 🚀 一键设置：几分钟内完成完整部署
  • 🔧 Systemd 集成：开机自启动并带有安全强化

要求​

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

安装内容​

Ansible playbook 将安装并配置：

  1. Tailscale（用于安全远程访问的网状 VPN）
  2. UFW 防火墙（仅开放 SSH + Tailscale 端口）
  3. Docker CE + Compose V2（用于代理沙箱）
  4. Node.js 22.x + pnpm（运行时依赖）
  5. Clawdbot（基于主机的安装，非容器化）
  6. Systemd 服务（开机自启动并带有安全强化）

注意：网关 直接在主机上 运行（不在 Docker 中），但代理沙箱使用 Docker 进行隔离。详情请参阅 沙箱。

安装后设置​

安装完成后，切换到 clawdbot 用户：

sudo -i -u clawdbot

安装后脚本将引导你完成：

  1. 新手引导向导：配置 Clawdbot 设置
  2. Provider 登录：连接 WhatsApp/Telegram/Discord/Signal
  3. 网关测试：验证安装
  4. Tailscale 设置：连接到你的 VPN 网状网络

快速命令​

# 检查服务状态
sudo systemctl status clawdbot

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

# 重启网关
sudo systemctl restart clawdbot

# Provider 登录（以 clawdbot 用户身份运行）
sudo -i -u clawdbot
clawdbot channels login

安全架构​

4 层防御​

  1. 防火墙 (UFW)：仅公开暴露 SSH (22) + Tailscale (41641/udp)
  2. VPN (Tailscale)：网关仅能通过 VPN 网状网络访问
  3. Docker 隔离：DOCKER-USER iptables 链防止外部端口暴露
  4. Systemd 强化：NoNewPrivileges, PrivateTmp, 非特权用户

验证​

测试外部攻击面：

nmap -p- YOUR_SERVER_IP

应该显示 仅 22 端口 (SSH) 开放。所有其他服务（网关、Docker）都已被锁定。

Docker 可用性​

安装 Docker 是为了用于 代理沙箱（隔离的工具执行），而不是为了运行网关本身。网关仅绑定到 localhost，并通过 Tailscale VPN 访问。

有关沙箱配置，请参阅 多代理沙箱与工具。

手动安装​

如果你更喜欢手动控制而非自动化：

# 1. 安装前提条件
sudo apt update && sudo apt install -y ansible git

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

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

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

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

更新 Clawdbot​

Ansible 安装程序将 Clawdbot 设置为手动更新。有关标准更新流程，请参阅 更新。

若要重新运行 Ansible playbook（例如更改配置）：

cd clawdbot-ansible
./run-playbook.sh

注意：这是幂等的，多次运行是安全的。

疑难解答​

防火墙阻止了我的连接​

如果你被锁定在外面：

  • 确保你首先能通过 Tailscale VPN 访问
  • 始终允许 SSH 访问（22 端口）
  • 按照设计，网关 仅 能通过 Tailscale 访问

服务无法启动​

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

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

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

Docker 沙箱问题​

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

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

# 如果镜像缺失，构建沙箱镜像
cd /opt/clawdbot/clawdbot
sudo -u clawdbot ./scripts/sandbox-setup.sh

Provider 登录失败​

确保你正在以 clawdbot 用户身份运行：

sudo -i -u clawdbot
clawdbot channels login

高级配置​

有关详细的安全架构和疑难解答：

相关内容​