1. 项目概述：一键部署安全的私有AI助手

如果你正在寻找一个能帮你自动处理网页任务、分析文档、甚至管理社交媒体聊天的AI助手，但又对直接将这类工具暴露在公网上感到不安，那么你找对地方了。最近的安全事件已经敲响了警钟：大量未经保护的AI助手实例正暴露在互联网上，API密钥、对话记录和个人数据一览无余。这正是我花时间折腾 RareCloudio/openclaw-setup 这个项目的初衷——它不是一个简单的安装脚本，而是一个为开发者量身定制的、开箱即用的安全部署方案。

简单来说，这个项目提供了一个全自动、非交互式的脚本，能在你的Ubuntu VPS上，用一条命令完成从系统初始化、OpenClaw（原MoltBot/ClawdBot）安装到八层安全加固的全过程。它的核心目标很明确：让你能安心地7x24小时运行一个自托管的AI助手，而无需在繁琐的服务器安全配置上耗费数小时。无论是用于个人自动化流程，还是作为团队内部工具，它都提供了一个坚实且安全的起点。接下来，我将带你深入拆解这个方案的每一个环节，分享我在部署和测试过程中积累的实操细节与避坑经验。

2. 核心架构与安全设计解析

2.1 为什么选择“网关隔离”而非直接暴露？

在传统部署中，很多人会直接让OpenClaw的网关服务监听在 0.0.0.0 （即所有网络接口）上，并配上一个简单的密码。这种做法看似方便，实则隐患巨大。一旦密码被爆破或服务存在未公开的漏洞，攻击者就能直接控制你的AI助手，访问其背后的所有能力和数据。

openclaw-setup 采用了一种更聪明的“网关隔离”架构。它将OpenClaw网关严格绑定在 127.0.0.1:18789 ，即本地回环地址。这意味着， 从互联网的任何角落都无法直接访问到这个网关端口 。那么，我们如何管理它呢？答案是通过唯一的入口——经过加固的SSH服务。

互联网 --> SSH (自定义端口，如41722) --> 服务器命令行
                                          |
                          网关 (127.0.0.1:18789) <--+
                                    |
                           Docker沙箱 (运行AI智能体会话)

这种设计将攻击面压缩到了极致。攻击者必须先攻破你的SSH防线（这本身已被多重加固），才能接触到内部的OpenClaw服务。这相当于给你的AI助手加装了一道厚重的保险门，而钥匙只有你手里的SSH密钥。

2.2 八层安全模型逐层拆解

这个项目的精髓在于其纵深防御策略。它不像很多教程只改个SSH端口了事，而是构建了一个从网络到应用层的完整防护体系。下面我们来逐层分析其作用和配置逻辑：

第一层：网络防火墙 (nftables) 脚本会清空默认规则，并设置一个“默认拒绝所有入站，允许所有出站”的策略。然后，它只放行你指定的自定义SSH端口（默认41722）。这意味着，除了SSH，服务器上的所有其他端口（包括常见的22、80、443）对互联网都是不可见的。这是最外也是最关键的一道屏障。

第二层：暴力破解防护 (fail2ban) 仅仅开放端口还不够，fail2ban会持续监控SSH登录日志。如果检测到来自同一IP在短时间内多次认证失败，它会自动将该IP加入防火墙的禁止列表一段时间。这能有效抵御自动化密码爆破工具。

第三层：SSH服务加固 这包括多项措施：1) 禁用密码登录，强制使用SSH密钥认证，从根本上杜绝密码被猜解的可能；2) 禁止root用户直接登录，降低特权账户暴露风险；3) 特别地，禁止名为 openclaw 的系统用户通过SSH登录，这是为了防止万一该用户凭证泄露被用于横向移动。

第四层：网关令牌认证 OpenClaw网关本身需要令牌才能访问。脚本会生成一个64位的随机十六进制字符串作为令牌。任何通过SSH隧道访问WebUI或直接调用网关API的请求，都必须携带这个令牌。这确保了即使有人通过其他途径接触到网关服务，没有令牌依然无法使用。

第五层：内核级强制访问控制 (AppArmor) AppArmor是一个Linux安全模块，它可以为特定程序定义其可以访问的文件、目录、网络端口等能力。脚本为OpenClaw的Node.js进程配置了一个限制性策略，防止其越权访问系统关键文件（如 /etc/passwd , /etc/shadow ），即使该进程被攻陷，其破坏力也被限制在最小范围。

第六层：Docker沙箱隔离 OpenClaw的“智能体”（Agent）是在独立的Docker容器中运行的。脚本配置的容器默认丢弃所有Linux能力（ cap_drop: ALL ），并设置资源限制（CPU、内存）。这意味着，即使AI智能体执行的代码存在恶意行为或漏洞，它也无法逃逸出容器去影响宿主机或其他容器，也无法耗尽服务器所有资源。

第七层：系统服务隔离 (systemd) 通过为OpenClaw网关创建systemd服务单元，可以利用systemd的内置安全特性。例如： NoNewPrivileges=true 防止服务提升权限； ProtectSystem=strict 使根文件系统只读； PrivateTmp=true 使用私有的临时目录。这些措施在操作系统层面进一步限制了进程的行为。

第八层：桌面环境屏幕锁 (仅桌面模式) 在启用 --desktop 模式时，脚本会安装轻量级XFCE桌面和浏览器。一个关键的安全细节是：系统设置为自动登录到桌面，但 立即自动锁屏 。这意味着，即使你通过VPS提供商的控制台使用VNC连接，看到的也是一个锁屏界面，必须输入密码才能操作。这防止了未授权的图形界面访问，同时允许OpenClaw在后台使用有图形界面的浏览器进行工作。

这八层防御并非简单堆砌，而是环环相扣，共同构成了一个难以逾越的防御体系。在实际测试中，这种配置能够有效抵御绝大部分自动化扫描和常规攻击手段。

3. 自动化安装流程与核心配置详解

3.1 环境准备与脚本执行细节

项目明确要求一个全新的 Ubuntu 24.04 LTS 系统。这是为了避免旧系统残留配置或不同版本间的包依赖冲突，确保自动化脚本的稳定运行。在购买或创建VPS后，你需要使用root权限通过SSH密钥登录。

执行安装的命令极其简单：

curl -fsSL https://raw.githubusercontent.com/RareCloudio/openclaw-setup/main/setup.sh | bash

这条命令背后的 curl 参数 -f （失败时静默）、 -s （静默模式）、 -S （显示错误）、 -L （跟随重定向）确保了下载的可靠性。通过管道直接交给 bash 执行，实现了真正的“一键化”。

注意：在生产环境，我个人的习惯是先审查脚本内容。 虽然本项目是开源的，但安全最佳实践是，对于任何从网络直接下载并执行的脚本，都应该先检查其内容。你可以使用 curl -fsSL [URL] -o setup.sh 下载，用 cat setup.sh 快速浏览，确认无恶意操作后再用 bash setup.sh 执行。

脚本开始运行后，它会依次执行以下关键操作，全程无需人工干预：

1. 系统更新与基础包安装 ：更新apt源，安装 curl 、 git 、 ufw （后期会被nftables替代）、 software-properties-common 等必要工具。
2. 安装核心运行时 ：包括Node.js 22（OpenClaw的运行环境）、Docker（用于智能体沙箱）以及Chrome或Chromium的headless版本（用于浏览器自动化工具）。
3. 创建专用系统用户 ：创建一个名为 openclaw 的非登录用户，所有OpenClaw相关进程都将以此用户身份运行，实现权限分离。
4. 安装与配置OpenClaw ：通过npm全局安装 @openclaw/cli ，并初始化其配置文件。关键一步是将网关的监听地址设置为 127.0.0.1 。
5. 部署安全加固配置 ：这是脚本最核心的部分，它会依次配置前面提到的nftables、fail2ban、SSH、AppArmor等。
6. 配置系统服务与工具 ：创建 openclaw-gateway 的systemd服务，并设置开机自启。同时，在 /usr/local/bin/ 下安装几个便捷的管理脚本，如 openclaw-status 、 openclaw-security-check 。
7. 设置每日自动备份 ：通过cron job，每天凌晨3点自动备份OpenClaw的配置、工作区和数据库到 /opt/openclaw-setup/backups/ 目录，保留最近7天的备份。
8. 修改SSH端口并重启服务 ：应用新的SSH配置，并将防火墙规则切换为只允许新的自定义端口。 这一步会断开当前的SSH连接 。脚本会给出明确提示，告诉你需要用新端口重新连接。

3.2 桌面模式与服务器模式的选择

脚本提供了两种运行模式，适用于不同场景：

服务器模式 (默认) 这是推荐的生产环境模式。它不安装图形界面，所有操作通过SSH命令行完成。OpenClaw使用headless（无头）浏览器运行，资源占用低（约2-4GB RAM），适合长期稳定运行在性价比高的VPS上。你通过 openclaw 命令来管理一切，日志输出到终端或文件。

桌面模式 (通过 --desktop 参数启用) 这个模式非常适合开发、演示或调试。它会安装XFCE桌面环境、Firefox和Chrome浏览器（带有真实图形界面）。OpenClaw将被配置为使用有界面的浏览器（ headless: false ），这样你就可以通过VPS提供商控制面板里的VNC功能，实时看到浏览器窗口，观察AI助手是如何一步步操作网页的。

启用桌面模式的命令：

curl -fsSL https://raw.githubusercontent.com/RareCloudio/openclaw-setup/main/setup.sh -o setup.sh
chmod +x setup.sh
sudo bash setup.sh --desktop

桌面模式访问实操要点 ： 安装完成后，桌面会自动启动并立即锁屏。你需要：

1. 登录你的VPS云服务商控制台（如AWS的EC2实例连接、DigitalOcean的Console、Linode的LISH等）。
2. 找到类似“VNC”、“Console”、“Web Terminal”的选项并打开。
3. 你会看到一个锁屏界面，输入你的服务器root密码即可解锁。
4. 解锁后，你就能看到完整的桌面。OpenClaw在后台运行，当它需要操作浏览器时，窗口会自动弹出并工作。这对于调试复杂的网页交互流程非常直观。

3.3 关键配置文件与路径解析

了解脚本创建的关键文件和目录，对于后续管理和故障排查至关重要：

路径	用途说明	管理要点
/home/openclaw/.openclaw/openclaw.json	OpenClaw主配置文件。定义了网关地址、端口、插件、浏览器设置等。	大部分配置已由脚本优化。如需修改，建议先备份。桌面模式下， browser.headless 会被设为 false 。
/home/openclaw/.env	环境变量文件，用于存储AI服务商的API密钥（如OpenAI、Anthropic Claude等）。	这是最敏感的文件！ 权限为600，仅 openclaw 用户可读。切勿泄露。
/home/openclaw/workspace	OpenClaw智能体的工作目录。智能体读写文件、下载内容都在这里。	每日备份的目标之一。注意磁盘空间，可定期清理或挂载更大容量存储。
/opt/openclaw-setup/.credentials	安装脚本保存的凭证文件，包含自动生成的网关令牌和SSH端口信息。	权限为600。首次SSH登录后，MOTD（每日提示信息）会从这里读取并显示连接指南。
/etc/nftables.conf	nftables防火墙的主配置文件。定义了仅允许自定义SSH端口的规则。	不要随意用 ufw 或其他工具修改防火墙，以免规则冲突。所有修改应通过此文件进行。
/etc/fail2ban/jail.local	fail2ban的监控与封禁规则。主要针对SSH登录失败进行防护。	可以在此调整封禁时间（ bantime ）、查找时间（ findtime ）和最大重试次数（ maxretry ）。

4. 安装后配置与日常管理实操

4.1 首次登录与密钥配置

安装脚本运行完毕并断开连接后，你需要使用新的端口重新SSH登录：

ssh -p 41722 root@你的VPS_IP地址

成功登录后，你会看到一段醒目的MOTD信息，其中包含了你的网关令牌（Gateway Token）和后续步骤的简明指南。请务必保存好这个令牌。

接下来是核心的两步配置：

第一步：添加AI模型API密钥 OpenClaw本身不提供AI能力，它需要接入像Anthropic Claude、OpenAI GPT这样的模型。使用以下命令启动一个交互式向导：

su - openclaw -c “openclaw models auth add”

这个命令会切换到 openclaw 用户并执行添加认证的命令。你会被提示选择提供商（如Anthropic），然后输入对应的API密钥。密钥会被安全地存储到 /home/openclaw/.env 文件中。你可以根据需要添加多个模型的密钥。

第二步：连接消息通道 要让AI助手能响应你的消息，你需要连接一个通讯平台。同样使用交互式命令：

su - openclaw -c “openclaw channels login”

例如，选择WhatsApp后，脚本会启动一个QR码生成进程。你需要用手机上的WhatsApp扫描这个QR码来链接设备。对于Telegram、Discord或Slack，流程类似，通常是通过机器人令牌（Bot Token）进行认证。

完成这两步后，你的私有AI助手就基本就绪了。可以运行 su - openclaw -c “openclaw health” 来检查所有服务是否正常。

4.2 三种访问与管理方式

1. 纯命令行管理 (主要方式) ： 所有管理都通过SSH连接后，使用 openclaw 命令或其包装脚本来完成。这是最安全、最直接的方式。

   # 查看网关状态和最近日志
   openclaw-status
   # 运行完整的安全检查（共11项）
   openclaw-security-check
   # 手动触发立即备份
   openclaw-backup
   

2. 通过SSH隧道访问Web控制界面 (可选) ： 如果你更喜欢图形化的控制台，可以在本地电脑上建立一条SSH隧道，将服务器的本地端口映射到你电脑上。

   # 在本地终端执行
   ssh -p 41722 -L 18789:127.0.0.1:18789 root@你的VPS_IP地址
   # 保持这个终端窗口打开
   

   然后，在本地浏览器中访问 http://localhost:18789/?token=你的网关令牌 。这样，你就在本地安全地访问到了服务器上只监听在127.0.0.1的WebUI。

3. 桌面模式下的VNC监控 (仅桌面模式) ： 如前所述，通过云服务商的VNC控制台直接观看AI助手在浏览器中的实时操作。这只用于监控和调试，不适合作为常规管理入口。

4.3 备份、更新与维护

备份 ： 脚本已配置每日自动备份（凌晨3点）。备份文件位于 /opt/openclaw-setup/backups/ ，以日期命名。建议定期将这些备份文件下载到本地或其他云存储。手动备份命令就是 openclaw-backup 。

更新OpenClaw ： 由于OpenClaw是通过npm全局安装的，更新它需要在 openclaw 用户下进行：

su - openclaw -c “npm update -g @openclaw/cli”

更新后，需要重启网关服务以生效：

systemctl restart openclaw-gateway

更新系统与安全补丁 ： 作为服务器管理员，定期更新系统基础包至关重要：

apt update && apt upgrade -y

更新后，如果涉及到内核或关键库，可能需要重启服务器 ( reboot )。建议在维护窗口进行。

5. 深度排查与常见问题解决实录

即使自动化程度很高，在实际部署中仍可能遇到问题。以下是我在多次部署和测试中遇到的典型情况及其解决方法。

5.1 安装阶段问题

问题1：脚本执行中途失败，报错“无法定位软件包”或“依赖关系问题”。

• 原因 ：这通常发生在非全新的Ubuntu 24.04系统上，或者系统的apt源列表有问题。
• 排查 ：查看完整日志 /var/log/openclaw-setup.log 。错误通常出现在最底部。
• 解决 ：
  1. 尝试手动更新源列表： apt update --fix-missing 。
  2. 如果问题与特定包（如 docker.io ）有关，可以尝试手动安装后再重新运行脚本。
  3. 最彻底的方法是：使用一个全新的、干净的Ubuntu 24.04 LTS镜像重试。这是脚本设计所依赖的基础。

问题2：安装完成后，无法用新端口SSH连接。

• 原因 ：防火墙（nftables）规则未正确应用；SSH服务配置错误；云服务商安全组/防火墙未放行新端口。
• 排查步骤 ：
  1. 检查云服务商安全组 ：这是最常见的原因。登录你的VPS提供商控制台，确保入站规则允许你自定义的TCP端口（如41722）。
  2. 尝试通过VNC/控制台登录 ：如果提供商支持，通过网页控制台直接登录服务器。
  3. 登录后，检查防火墙状态： nft list ruleset 。确认是否有接受新SSH端口的规则。
  4. 检查SSH配置： cat /etc/ssh/sshd_config | grep Port ，确认端口号已更改。
  5. 检查SSH服务状态： systemctl status ssh 。
• 解决 ：根据排查结果修正。如果是安全组问题，在控制台添加规则。如果是本地配置问题，修正后重启服务： systemctl restart ssh 和 systemctl restart nftables 。

5.2 运行阶段问题

问题3：OpenClaw网关服务启动失败。

• 排查 ：使用 journalctl 查看详细日志。

  journalctl -u openclaw-gateway -f --no-pager
  

• 常见原因与解决 ：
  • 端口占用 ：日志显示“address already in use”。检查18789端口是否被其他进程占用： ss -tlnp | grep :18789 。如果是，停止该进程或修改OpenClaw配置中的端口。
  • 权限问题 ： openclaw 用户无权访问某些目录。确保 /home/openclaw 及其下的 .openclaw 、 workspace 目录的所有者和权限正确。
  • Node.js环境问题 ：可能是Node.js版本不对或模块损坏。尝试切换回 openclaw 用户重装： su - openclaw -c “npm install -g @openclaw/cli” 。

问题4：AI智能体无法运行，报错关于Docker或沙箱。

• 排查 ：查看OpenClaw的详细运行日志。

  su - openclaw -c “openclaw logs --tail 50”
  

• 常见原因与解决 ：
  • Docker守护进程未运行 ： systemctl status docker 。如果未运行，启动它： systemctl start docker 。
  • openclaw 用户不在docker组 ：这会导致无权连接Docker socket。将用户加入组： usermod -aG docker openclaw ，然后需要 完全退出SSH会话再重新登录 （或者重启服务器）以使组生效。
  • 沙箱镜像拉取失败 ：网络问题可能导致拉取OpenClaw的Docker沙箱镜像失败。手动拉取： docker pull openclaw/sandbox:latest （以root或docker组用户身份）。

问题5：桌面模式下，通过VNC看不到浏览器窗口。

• 排查 ：
  1. 确认OpenClaw配置中 browser.headless 为 false 。
  2. 确认桌面确实已启动且解锁。通过VNC连接后，如果看到锁屏，输入密码解锁。
  3. 在服务器上，切换到 openclaw 用户，检查环境变量 DISPLAY 是否设置为 :0 ： su - openclaw -c ‘echo $DISPLAY’ 。
• 解决 ：如果 DISPLAY 未设置，可以在OpenClaw的启动环境或系统服务文件中显式设置 DISPLAY=:0 。对于systemd服务，可以修改 /etc/systemd/system/openclaw-gateway.service ，在 [Service] 部分添加 Environment=“DISPLAY=:0” ，然后 systemctl daemon-reload 并重启服务。

5.3 安全加固检查

脚本提供的 openclaw-security-check 工具是一个很好的起点。它会检查11个项目，包括：

• 防火墙规则是否只允许SSH端口
• SSH密码登录是否已禁用
• fail2ban是否活跃
• AppArmor配置文件是否加载
• 关键文件权限是否正确（如 .env 文件是否为600）

定期运行这个检查，可以确保你的安全配置没有因为后续的误操作而被意外修改。

6. 性能调优与进阶配置建议

基础部署完成后，你可以根据实际使用场景进行一些调优。

资源监控与限制 ： OpenClaw，尤其是桌面模式，可能会占用较多内存。建议安装基础监控工具：

apt install -y htop

使用 htop 可以实时查看CPU、内存和Swap使用情况。如果发现内存经常吃紧，可以考虑升级VPS套餐，或者在Docker的systemd服务中为容器设置更严格的内存限制（修改 docker-compose.yml 或容器运行参数）。

网络优化 ： 如果你的VPS在海外，而主要使用国内的AI服务（如一些国内大模型API），可能会遇到网络延迟。虽然脚本本身不解决此问题，但你可以考虑：

1. 为VPS配置网络优化工具（需自行评估合规性）。
2. 或者，将项目部署在离你目标API服务更近区域的VPS上。

插件与功能扩展 ： OpenClaw支持丰富的插件。安装后，你可以通过 openclaw plugins list 查看可用插件，并通过 openclaw plugins install [plugin-name] 来安装新功能，如连接数据库、支持更多消息平台等。

高可用考虑（进阶） ： 对于非常重要的自动化流程，单点故障是需要考虑的。虽然本项目专注于单机安全部署，但你可以结合此方案构建更高可用的架构：

• 定期备份与快速恢复 ：利用脚本的每日备份，并演练恢复流程。在另一台VPS上预先运行好安装脚本，出现故障时，恢复备份数据即可快速切换。
• 负载均衡与故障转移（复杂） ：可以尝试在多个VPS上部署相同的OpenClaw实例，并通过一个负载均衡器（如Nginx）将消息请求分发到后端的健康实例。这需要额外的架构设计和消息去重机制。

这个开源项目提供了一个极其优秀的起点，它将复杂的DevOps和安全工程知识封装在一条命令之下。它解决的不仅仅是一个“安装”问题，更是一个“如何安全地安装”的问题。对于想要拥有一个私有、可控、安全的AI自动化助手的开发者和技术爱好者来说，它节省了大量的研究、试错和配置时间。你可以直接基于这个坚固的基础，去构建和探索AI智能体应用的无限可能。