tech

VPS 一站式部署：1Panel + OpenClaw + Hermes 简明教程

· 3 min read

目标读者：想在一台全新 VPS（Ubuntu 22.04 / Debian 12 等）上，用最短路径搭好一套「服务器面板 + AI 编码代理 + 个人 AI 助理」的开发者。

成品：1Panel 管服务器、OpenClaw 让本地 IDE 远程接管 VPS 干活、Hermes Agent 让你在终端 / Telegram / 网页里跟 AI 聊天并使用工具。

0. 准备工作

  • 一台 VPS：2 核 / 2G 内存 / 20G 硬盘起步（Hermes + 一两个 Docker 服务够用）。系统建议 Ubuntu 22.04 LTS 或 Debian 12。
  • root 权限（或 sudo）。
  • 一个可解析到 VPS 的域名（可选，但强烈建议 —— 用来给 1Panel 装 HTTPS 面板）。
  • 本地一台 Mac / Linux / Windows 电脑，装有 SSH。

先登录 VPS，把系统更新一下：

apt update && apt upgrade -y
apt install -y curl wget git ufw sudo vim

打开常用端口（如果启用了 ufw）：

ufw allow 22/tcp        # SSH
ufw allow 80,443/tcp    # Web
ufw allow 18789/tcp     # OpenClaw 网关
ufw --force enable

1. 安装 1Panel（服务器面板）

1Panel 是国产开源的现代化服务器面板，比宝塔更清爽，天然支持 Docker、应用商店、防火墙、SSL 证书、网站托管。

一键安装

curl -sSL https://resource.1panel.pro/quick_start.sh -o quick_start.sh
bash quick_start.sh

脚本会问你几个问题，建议这样填：

| 提示 | 建议值 |
|---|---|
| 安装目录 | /opt （默认） |
| 面板端口 | 随机 5 位数（避免被扫） |
| 面板入口目录 | 随机字符串，例如 admin1panel |
| 用户名 / 密码 | 自定义，别用 admin/123456 |

装完后，脚本会输出：

面板地址: http://<你的IP>:<端口>/<入口目录>
用户名: xxx
密码:   xxx

浏览器打开这个地址就能进管理界面。第一件事：在「面板设置 → 面板 SSL」里申请 Let's Encrypt 证书，或者绑定你的域名。

装点常用应用

登录后左侧「应用商店」搜索并一键安装：

  • Docker —— 后面 Hermes / OpenClaw 也用得上（1Panel 会自动装）
  • Caddy 或 OpenResty —— 反向代理
  • MySQL / Redis —— 按需
  • Portainer —— 如果习惯图形化管 Docker

2. 安装 OpenClaw（远程代码代理）

OpenClaw 让你的本地 IDE（Cursor / VSCode / Zed）能直接连到 VPS 上的一个网关，代替你在 VPS 里执行 shell、读写文件、跑构建 —— 相当于把「远程开发」自动化了。

在 VPS 上安装

# 先装 Node.js 20 LTS
curl -fsSL https://deb.nodesource.com/setup_20.x | bash -
apt install -y nodejs

# 全局装 OpenClaw
npm install -g openclaw

# 初始化配置（会在 ~/.openclaw/openclaw.json 生成配置）
openclaw init

关键配置：改成 LAN 绑定

默认 OpenClaw 只监听 127.0.0.1，本地机器连不进来。编辑配置：

vim ~/.openclaw/openclaw.json

把 gateway.bind 改成 "lan"：

{
  "gateway": {
    "port": 18789,
    "bind": "lan"
  }
}

用 systemd 让它开机自启

创建用户级 service：

mkdir -p ~/.config/systemd/user
cat > ~/.config/systemd/user/openclaw-gateway.service <<'EOF'
[Unit]
Description=OpenClaw Gateway
After=network.target

[Service]
ExecStart=/usr/bin/node /usr/lib/node_modules/openclaw/dist/index.js gateway --port 18789
Restart=on-failure
RestartPreventExitStatus=78

[Install]
WantedBy=default.target
EOF

# 启用 + 启动
systemctl --user daemon-reload
systemctl --user enable --now openclaw-gateway.service

# 关键：允许用户 systemd 在没登录时也运行（否则重启后不会自启）
sudo loginctl enable-linger $USER

验证

ss -tlnp | grep 18789          # 应看到 0.0.0.0:18789
curl http://127.0.0.1:18789/   # 应返回 200

从本地机器：

curl http://<VPS-IP>:18789/    # 应返回 200

打开本地 IDE（Cursor / VSCode 装 OpenClaw 扩展），填入 http://<VPS-IP>:18789 和设备配对码，就能开始远程干活。

⚠️ 安全提示：OpenClaw 网关默认有设备鉴权。不要开启 dangerouslyDisableDeviceAuth，也不要把它裸露在公网。生产环境建议只在内网 / VPN 里暴露，或用 Caddy 反代加基础认证。

3. 安装 Hermes Agent（AI 助理）

Hermes Agent 是 Nous Research 的开源 AI 智能体框架 —— 一个可以在终端、Telegram、Discord、Slack 等平台聊天，同时能读写文件、跑命令、开浏览器的 AI 助手。跨会话记忆、技能系统、多模型接入，全都开源。

一键安装

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

脚本会：

  1. 装 Python 依赖 + Hermes CLI 本体
  2. 引导你选模型 / 提供商（OpenRouter / Anthropic / OpenAI / DeepSeek / 本地模型 …）
  3. 建好 ~/.hermes/ 配置目录

装完后，输入 hermes 进入交互界面。

首次配置

hermes setup          # 交互式向导（模型、终端、网关、工具）
hermes model          # 单独换模型 / 提供商
hermes doctor         # 体检：依赖、Key、连通性

如果只是想试用，可以直接：

export OPENROUTER_API_KEY=sk-or-xxx
hermes chat -q "你好，介绍下自己"

让 Hermes 常驻 Telegram（可选，强推）

在手机上跟你的 VPS 上的 AI 聊天：

hermes gateway setup     # 选 Telegram，粘贴 BotFather 的 Token
hermes gateway install   # 安装成后台服务
hermes gateway start
hermes gateway status

之后在 Telegram 里跟 Bot 说话，Hermes 会用完整工具集（终端 / 文件 / 浏览器 / 图像 …）在你的 VPS 上帮你干活。

常用命令速查

hermes                       # 进交互模式
hermes chat -q "..."         # 单条查询
hermes --resume <session>    # 恢复某次会话
hermes tools                 # 管理工具集
hermes skills list           # 看已装技能
hermes cron list             # 定时任务
hermes gateway status        # 网关状态

4. 三件套如何协作

一个典型的日常工作流：

  1. 1Panel 管服务器 —— 建站、Docker 应用、SSL、监控。
  2. OpenClaw 让本地 Cursor / VSCode 直接在 VPS 上写代码、跑构建、部署。
  3. Hermes 长期挂着 Telegram 网关，你在手机上就能让 AI 帮你查日志、改配置、发通知、写脚本。

三者互不冲突：1Panel 用它的面板端口，OpenClaw 用 18789，Hermes 只是本地进程 + 出站 API 调用。

5. 常见坑

| 现象 | 原因 | 处理 |
|---|---|---|
| curl http://<VPS-IP>:18789/ 无响应 | OpenClaw 绑到了 127.0.0.1 | 改 gateway.bind 为 lan，重启服务 |
| 重启 VPS 后 OpenClaw 没自启 | 没开 linger | sudo loginctl enable-linger $USER |
| 端口 18789 被占用 | 多用户各起了一份 | 保留一份，systemctl --user disable 掉其它 |
| Hermes 语音 / 视觉功能报错 | 缺少辅助模型 Key | hermes config set auxiliary.vision.provider ... 或装 OPENROUTER_API_KEY |
| Hermes Gateway 掉线 | SSH 登出后 user manager 退出 | 同样 enable-linger；WSL2 需 systemd=true |
| 1Panel 忘了入口路径 | 面板端口是随机的 | 在 VPS 跑 1pctl user-info 找回 |

6. 下一步玩什么

  • 用 1Panel 装个 WordPress / Ghost / Halo 建博客
  • 让 Hermes 自动做定时任务（hermes cron create '0 9 * * *' '早安播报'）
  • 用 OpenClaw 从本地 IDE 直接 push 代码到 VPS 上的 Git 仓库并触发部署
  • 给 Hermes 装技能：hermes skills browse，官方技能市场覆盖 GitHub / 图像生成 / Notion / WordPress / OCR 等

总结：三条命令覆盖 90% 的场景 ——

bash <(curl -sSL https://resource.1panel.pro/quick_start.sh)   # 1Panel
npm install -g openclaw && openclaw init                        # OpenClaw
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash   # Hermes

祝玩得开心 🚀