浏览

设置

深色模式

VPS 部署 Hermes Agent（一）：一分钟安装开源 AI 智能体

3 9 月, 2026 VPS教程 Digwall

Hermes Agent 是开源大模型团队 Nous Research出品的自主 AI 智能体（Agent）：它不止是聊天机器人，而是能调用工具、跑代码、连消息平台、跨会话学习成长的“虚拟助手”。装在自己的 VPS 上 = 数据不出门、随时在线、想接什么平台接什么。

这是系列第一篇，讲是什么 + 一分钟安装 + 基础配置。后续：第二篇《模型接入与消息网关》、第三篇《Docker 生产级部署》。

快速上手：30 秒看懂

你的 VPS（Ubuntu/Debian）
   └─ 一行命令安装 → hermes 命令可用 → 选模型 → 开始对话/配网关

本质：一个装在服务器上的 AI Agent 程序（模型走云端 API，VPS 不用 GPU）
门槛：1-2GB 内存的小鸡就够跑（推荐 2GB+）
模型：默认接 Nous Portal 或任意 OpenAI 兼容 API（本地不跑模型）

一、Hermes Agent 是什么？

Hermes Agent（GitHub：NousResearch/hermes-agent）是 Nous Research（开源社区知名的 Hermes 大模型系列团队）发布的自托管开源 AI Agent。

和 ChatGPT、Claude 等网页版 AI 相比，最大的区别如下：

维度	网页版 AI	Hermes Agent（自托管）
运行位置	厂商云端	你的 VPS
数据	进入厂商服务器	留在你的机器（`~/.hermes/`）
在线状态	打开网页才在	7×24 常驻
能力	单会话聊天	调用工具、跑代码、连 Telegram/WhatsApp/飞书/微信、跨会话学习
可配置性	厂商说了算	全开放

核心能力

自主执行：不只是“回答”，还能调用工具完成任务，例如写代码、搜索网页、执行命令等。
跨平台消息网关：可接入 Telegram、WhatsApp 、飞书等，在聊天软件中直接指挥它工作。
跨会话学习循环：可将经验沉淀下来，下次遇到相似任务时直接复用。
多模型路由：一套配置可切换主流大模型；Nous Portal 一个订阅覆盖 300+ 款模型，也支持自行接入 OpenAI 兼容 API。

二、为什么放在 VPS 上跑？

7×24 在线：网页版关闭后会中断，VPS 上运行可以长期在线；接入 Telegram、飞书后可随时调用。
数据自主：你的对话、技能、知识库等数据均保存在自己的服务器中。
API 中转友好：如果你已有多个模型 API，可通过 VPS 上的 Agent 统一调用和管理。
成本可控：VPS 月费加上模型 API 按量计费，通常比多个 AI 平台订阅更灵活。

三、准备工作

VPS 要求（建议配置）

项目	建议
系统	Ubuntu 20.04+ / Debian 11+（其他 Linux 发行版也可以）
内存	2GB+（1GB 小鸡偏紧，Agent 本体不大但运行工具时会占用资源）
磁盘	10GB+（代码、工具缓存和个人数据）
网络	能访问 GitHub / Nous Portal（国内 VPS 建议先测试连通性）

系统依赖（只需这几样）

官方安装器会自动处理 Python 3.11、Node.js、ripgrep、ffmpeg 等依赖。你只需要确保以下基础工具可用：

# Debian/Ubuntu
sudo apt update && sudo apt install -y git curl xz-utils
git --version   # 确认 git 可用

如果后续需要使用桌面 App 或浏览器自动化功能，可额外安装 build-essential；仅使用命令行时不需要。

四、安装 Hermes Agent（一行命令）

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

如果想给所有用户安装，可使用 root 模式。此方式更适合共享机器：

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

安装器会自动完成以下工作：

拉取 Hermes Agent 代码；
创建虚拟环境（uv + Python 3.11）；
安装 Node.js、ripgrep、ffmpeg 等依赖；
生成全局 hermes 命令；
提示你进行模型配置。

安装后目录布局（了解即可）

安装模式	代码位置	hermes 命令	你的数据
普通用户	`~/.hermes/hermes-agent/`	`~/.local/bin/hermes`	`~/.hermes/`
root 模式	`/usr/local/lib/hermes-agent/`	`/usr/local/bin/hermes`	`/root/.hermes/`

五、首次运行与基础配置

1. 让 hermes 命令生效

source ~/.bashrc   # 或 source ~/.zshrc
hermes --version   # 确认安装成功

2. 启动并进入配置向导

hermes setup

首次运行会进入一个分步配置向导：

方向键 ↑ / ↓：选择选项；
回车：确认并进入下一步；
多选列表中按空格：勾选或取消勾选；
Ctrl + C：随时退出；未保存的步骤不会写入配置。

如果机器上已有旧配置，hermes setup 会显示当前值作为默认项，直接回车即可保留。只想补充未配置项目，可使用 hermes setup --quick。

第 1 步：选择配置方式

首次安装时会出现三个配置选项：

选项	含义	适合谁
Quick Setup (Nous Portal)	通过 OAuth 登录 Nous 账号，无需手动填写 API Key，模型与工具可快速配置。	想快速开始，或已有 Nous Portal 账号的用户。
Full setup	自行选择模型提供商、填写 Key、逐项开启或关闭工具。	已有 OpenAI 兼容 API、DeepSeek、OpenRouter 等 Key 的用户。
Blank Slate	仅启用文件、终端、模型等最基础功能，其他能力默认关闭。	希望最小化部署、后续按需配置的用户。

选择 Quick Setup：按下文“路径 A”操作；
选择 Full setup：按下文“路径 B”操作；
Blank Slate 与 Full setup 类似，只是默认关闭 Web 搜索、浏览器、记忆等功能；需要时后续再开启即可。

路径 A：Quick Setup（推荐新手，无需填写 API Key，需要授权Nous Portal 账号）

Quick Setup 会依次完成以下配置：

Nous Portal 登录
按提示自动打开浏览器，或获取登录链接完成 OAuth 授权。VPS 没有浏览器时，可将链接和验证码复制到本地电脑浏览器中完成登录。
选择默认模型
登录后会列出可用模型。使用方向键选择模型后按回车确认。免费账号无法使用的付费模型通常会显示为灰色，也可以选择底部的 Enter custom model name 手动输入模型名称。
终端后端（Terminal Backend）
此项决定 Hermes 在哪里执行命令或代码。新机器默认选项通常是 Local，即直接在 VPS 本机运行，推荐直接回车确认。
消息平台配置
向导会询问是否立即配置 Telegram、Discord 等消息平台。想从手机端随时使用可选择“Set up messaging now”；如果暂时不需要，选择“Skip”即可，后续可用 hermes setup gateway 补配。

看到 Setup complete! 后，即可进入下一步开始对话。

路径 B：Full setup（已有 API Key 的用户）

Full setup 通常按模型 → 终端后端 → 消息平台 → 工具四个小节依次询问。

① 模型提供商与模型

这是必配项；没有配置模型就无法对话。

先选择模型提供商，例如 Nous Portal、OpenRouter、Anthropic Claude、OpenAI、Gemini、DeepSeek、Qwen、Kimi、MiniMax 等；
如果使用 OpenAI 兼容中转服务或自建网关，应选择 Custom endpoint；
根据提示粘贴 API Key。输入过程通常不会回显，粘贴后直接回车即可；
若提示填写 Base URL，使用官方接口时可直接回车；只有第三方中转或自建网关才需要填写自己的接口地址；
最后选择默认模型，或使用 Enter custom model name 手动输入模型名。

以 Full setup 中选择 DeepSeek 为例，实际界面大致如下：

  Current model:    (not set)
  Active provider:  none

  Select provider:
  > Nous Portal ...
    OpenRouter ...
    DeepSeek ...
    ...
    Custom endpoint (enter URL manually)
    Leave unchanged

  No DeepSeek API key configured.
  DEEPSEEK_API_KEY (or Enter to cancel):

  Select default model:
  > deepseek-v4-flash
    deepseek-v4-pro
    Enter custom model name

如果使用 Custom endpoint（OpenAI 兼容中转或自建网关），通常会依次要求填写：

API base URL [e.g. https://api.example.com/v1]:
API key [optional]:

多数 OpenAI 兼容中转服务要求 Base URL 以 /v1 结尾。填写完成后，向导通常会自动探测可用模型，并让你为该连接设置显示名称。

② 终端后端（Terminal Backend）

选项	说明	VPS 推荐
Local	命令和代码直接在当前 VPS 上执行。	✅ 首选
Docker	命令运行在隔离容器中。	追求隔离时再选
Modal / SSH / Daytona 等	使用云沙箱或其他远程机器执行命令。	一般用户用不上

③ 消息平台网关（Messaging Platforms）

向导会列出 Telegram、Discord、Slack、WhatsApp、Matrix 等可接入平台；
使用空格键勾选需要的平台，按回车继续；
Telegram 通常可选择自动扫码托管，或手动从 @BotFather 获取 Bot Token；
Discord、Slack 等平台则需要填写对应的 Bot Token；
如果暂时不需要，直接回车跳过即可，后续可运行 hermes setup gateway 配置。

第一次使用建议先跳过消息网关，先确认 Hermes 能正常对话。Telegram、WhatsApp 等网关配置可在系列第二篇中继续完成。

④ 工具（Tools）

工具配置页面会列出可启用或禁用的能力，例如：

Web 搜索；
浏览器自动化；
代码执行；
图片生成；
语音 TTS；
技能库；
记忆功能。

使用空格键勾选所需工具即可。部分工具需要额外第三方 API Key；没有 Key 时可直接跳过，不影响基本对话，后续运行 hermes tools 或 hermes setup tools 随时补开。

向导各步骤推荐选择

向导环节	推荐选择
配置方式	有 Nous 账号：Quick Setup；已有自己的 API Key：Full setup
模型提供商	选择手上已有 Key 的提供商；中转或自建网关选择 Custom endpoint
API Key	直接粘贴；没有时回车跳过
终端后端	Local
消息平台	首次建议跳过，后续单独配置
工具	保留默认勾选即可；没有对应 Key 的工具先跳过

最快路径：已有 Nous Portal 账号的用户，可以直接使用以下命令完成登录、模型选择和工具网关配置：

hermes setup --portal

3. 开始对话

hermes

直接进入交互对话——现在你已经拥有一个运行在自己 VPS 上的 AI Agent。

六、日常管理命令

命令	作用
`hermes model`	切换或配置模型提供商与模型。
`hermes setup model`	只重跑“模型提供商”配置小节。
`hermes setup gateway`	只配置或重配消息网关，例如 Telegram。
`hermes setup tools`	只开关工具或补充工具 API Key。
`hermes setup --quick`	已有配置时，仅补充未配置项目。
`hermes tools`	启用或禁用工具，例如搜索、代码、图像等。
`hermes gateway setup`	配置消息网关，例如 Telegram、WhatsApp。
`hermes config set <键> <值>`	修改单项配置。
`hermes config get`	查看当前配置。
`hermes setup --portal`	一键接入 Nous Portal。
`hermes desktop`	需要桌面版时执行。