技术百科首页 >在腾讯云轻量应用服务器上部署并使用 Hermes Agent

在腾讯云轻量应用服务器上部署并使用 Hermes Agent

(Telegram、Discord 与电子邮件设置完整指南)

作者: Pavol Labuda (aclassickoder)

⏱️ 所需时间: 15 分钟 📋 你需要准备: 腾讯云账号 + LLM API Key ✅ 最终效果: 7×24 小时运行的 Hermes Agent,并可通过 Telegram/Discord/Email 访问

目录

  1. Hermes Agent 简介
  2. 为什么部署在腾讯云轻量应用服务器?
  3. 前置条件
  4. 通过应用模板部署 Hermes Agent(简易方式)
  5. 配置 Hermes Agent(使用 DeepSeek 设置 LLM)
  6. 接入消息平台
  7. 开发者社区与支持
  8. 最终提示与故障排查

1. Hermes Agent 简介

Nous Research 于 2026 年 4 月正式发布开源 Hermes Agent,这是一款真正的自主 AI Agent,区别于绑定在 IDE 内的代码助手或单一 API 聊天机器人。传统聊天机器人通常只会响应用户的直接提示,而 Hermes Agent 可以在你的服务器上独立运行,具备持久化记忆和完整的自学习闭环。它能够自主创建新技能,在使用过程中改进已有技能,并在不同会话之间保留记忆——真正做到“越用越聪明”。

核心能力包括:

  • 持久化记忆与闭环学习:在你的服务器上 7×24 小时运行,记住过往交互,并在无需人工干预的情况下持续提升表现。
  • 兼容 OpenClaw:内置 hermes claw migrate 命令,可一键迁移所有 OpenClaw 设置、记忆、技能和 API Key,让现有 OpenClaw 用户平滑切换。
  • 跨平台集成:可无缝连接 Telegram、Discord、Slack、WhatsApp、Email、Microsoft Teams 以及其他 10+ 消息平台。
  • LLM 灵活性:支持来自主流服务商的 200+ 大语言模型(LLM),让你完全掌控 AI 的“大脑”。
  • 完整系统自动化:只需用自然语言输入简单指令,即可自动化复杂任务,例如日程安排、网页抓取、终端命令执行等。
  • 可扩展工具生态:自带 11 类内置工具,包括视觉分析、浏览器自动化、终端访问、文本转语音等。

🔒 重要部署提示:Hermes Agent 需要完整系统权限(终端执行、文件读写、浏览器自动化等)才能发挥全部能力。为最大化安全性,请将其部署在与你个人主力电脑隔离的环境中。官方支持 Linux(最推荐)、macOS、WSL2 和 Android(Termux)——不支持原生 Windows(Windows 用户必须先安装 WSL2)。


2. 为什么部署在腾讯云轻量应用服务器?

腾讯云轻量应用服务器是运行 Hermes Agent 的理想平台。它是一款面向开发者、初创团队和小型企业的轻量、低成本云服务器产品——无需复杂的云计算知识即可上手。

Hermes Agent 部署在轻量应用服务器上的主要优势:

  • 快速部署:使用官方预构建应用模板,5 分钟内即可启动 Hermes Agent——无需手动安装 Docker 或配置依赖。
  • 极高性价比:套餐价格低至每月几美元,并提供灵活配置以匹配不同性能需求。
  • 7×24 小时在线:持续运行 Hermes Agent,无需担心断电、断网,或必须让个人电脑一直开机。
  • 安全隔离:云端环境与本地机器完全隔离,即使 Hermes 执行潜在高风险命令,也能保护你的个人数据。
  • 全球地域覆盖:可选择多个海外地域(包括新加坡、硅谷、法兰克福),稳定连接 Discord、WhatsApp 等国际平台。
  • 简化管理:提供直观的网页控制台、内置终端访问(OrcaTerm)、一键备份,以及按需轻松扩容。

💡 专属优惠:通过我的推荐链接购买轻量应用服务器实例,可获得 双倍代金券奖励,并叠加额外折扣!👉 领取腾讯云轻量应用服务器专属奖励


3. 前置条件

在腾讯云轻量应用服务器上部署 Hermes Agent 前,请确保满足以下要求:


组件 规格


操作系统 Ubuntu Server 24.04 LTS 64-bit(预装 Hermes Agent 模板)

内存 最低 2GB RAM(推荐 4GB,以便多工具流畅运行)

磁盘空间 至少 30GB SSD(足够存放 Hermes Agent、日志和缓存数据)

LLM API Key 有效的 LLM 服务商 API Key(例如 DeepSeek——确保账户余额 > 0)

腾讯云账号 已开通账号并配置支付方式

💡 专业建议:为获得最佳体验,我推荐使用 LH 2C4G Linux 套餐。它在性能与成本之间取得了良好平衡,适合启用 Hermes Agent 的核心功能。你可以通过我的专属链接直接购买该套餐:👉 立即部署 Hermes Agent 到 LH 2C4G Linux 使用该链接可获得 双倍代金券奖励,可用于后续续费或购买其他服务!


4. 通过应用模板部署 Hermes Agent(简易方式)

你可以使用腾讯云官方预构建的 Hermes Agent 应用模板,避免手动安装的麻烦。该方式会自动安装所有必要依赖、Docker 和最新版 Hermes Agent——你可以把精力放在使用 AI Agent 上,而不是配置服务器。

Step 1: 购买轻量应用服务器实例

  1. 打开 腾讯云轻量应用服务器优惠页,获取专属折扣和双倍代金券奖励。
  2. 登录你的腾讯云账号(如果还没有账号,则先创建)。
  3. 浏览可用轻量应用服务器套餐,并选择最适合你的配置(推荐 LH 2C4G Linux)。
  4. 选择偏好的地域(如果计划频繁使用 Discord 或 WhatsApp,建议选择 Singapore 或其他海外地域)。
  5. 完成付款流程。

💡 重要提示:使用上方链接可确保你获得最高可用折扣和 双倍代金券奖励。这些代金券可用于未来续费或实例升级。

Step 2: 创建 Hermes Agent 实例

  1. 购买完成后,你会被重定向到 腾讯云轻量应用服务器控制台
  2. 点击 Create Instance
  3. Application Creation Method 下选择 Application template
  4. 在模板列表中滚动查找 Hermes Agent(会带有清晰的官方 Hermes 标识)。
  5. 确认地域和服务器套餐(即你之前购买的套餐)。
  6. 点击 Create Instance,等待约 30 秒,让服务器启动并初始化 Hermes Agent 环境。

分步截图: 腾讯云轻量应用服务器控制台概览 - Hermes Agent 部署 图 1:腾讯云轻量应用服务器主控制台,展示账号概览与实例管理入口

Hermes Agent 应用模板选择界面 图 2:应用模板选择页面,突出显示官方 Hermes Agent 模板

轻量应用服务器控制台中的创建实例按钮 图 3:蓝色“Create Instance”按钮,用于开始创建 Hermes Agent 服务器

Hermes Agent 模板预览与配置\ 图 4:部署前的最终确认页面,展示 Hermes Agent 模板详情


5. 配置 Hermes Agent(使用 DeepSeek 设置 LLM)

Hermes Agent 不内置 AI 模型——它需要连接外部大语言模型(LLM)来提供智能能力。本节以 DeepSeek 作为示例服务商,因为它性能优秀、成本较低,并且 API 稳定可靠。

Step 1: 登录轻量应用服务器

  1. 在腾讯云控制台中,在实例列表里找到刚创建的 Hermes Agent 实例。
  2. 点击实例卡片上的 Login 按钮。
  3. 浏览器会自动跳转到 OrcaTerm,即腾讯云内置网页终端工具。
  4. 在弹窗中配置登录设置:
    • Protocol: 选择 Password-free Login
    • Username: 改为 ubuntu(Hermes Agent 预装在该用户账号下)
  5. 点击 Log in 进入服务器终端。

分步截图: Hermes Agent 实例卡片上的登录按钮 图 5:实例卡片显示“Login”按钮,用于访问网页终端

OrcaTerm 网页终端登录配置窗口 图 6:OrcaTerm 登录设置,已预配置 ubuntu 用户的免密访问

成功登录后的 OrcaTerm 终端界面 图 7:可正常使用的 OrcaTerm 终端,可开始执行 Hermes Agent 配置命令

Step 2: 获取 DeepSeek API Key

  1. 打开 DeepSeek Platform 并登录,或注册新账号。
  2. 进入 API Keys 页面。
  3. 点击 Create API Key,并为该 Key 输入一个便于识别的名称(例如 “Hermes Agent”)。
  4. 系统会生成一个以 sk-api- 开头的 Key 字符串。请立即复制并安全保存——关闭页面后将无法再次查看完整 Key。
  5. 确认你的 DeepSeek 账户有正余额。如果余额为零,即使 API Key 配置正确,Hermes Agent 也无法调用模型。你可以在 DeepSeek Billing Center 查看并充值余额。

分步截图: DeepSeek Platform 中的新建 API Key 按钮 图 8:DeepSeek API Keys 页面,突出显示“Create new API key”按钮

DeepSeek Platform 中的新建 API Key 按钮 图 8.1:DeepSeek API Keys 页面,突出显示“Create new API key”按钮

DeepSeek API Key 复制提示 - 仅显示一次 图 9:生成的 DeepSeek API Key 仅显示一次,请立即复制

Step 3: 运行 hermes setup 配置 LLM

在服务器终端中运行以下命令,启动交互式配置向导:

hermes setup

Step 3.1: 选择快速设置

使用上下方向键移动菜单,选择:Quick setup — provider, model & messaging (recommended) 然后按 Enter 确认。

Hermes Agent 设置向导主菜单 图 10:Hermes 设置向导,显示推荐的 Quick Setup 选项

Step 3.2: 选择 LLM 服务商

在支持的模型服务商列表中滚动并选择 DeepSeek。按 Enter 确认。

LLM 服务商选择菜单 - DeepSeek 被选中 图 11:完整 LLM 服务商列表,DeepSeek 被选为当前选项

Step 3.3: 输入 DeepSeek API Key

当终端提示 DeepSeek API key: 时,粘贴之前复制的 API Key。可以使用 Ctrl+Shift+V,也可以在终端窗口中右键粘贴。

🔒 安全提示:出于安全原因,输入 API Key 时屏幕不会显示任何字符(包括星号)。直接粘贴 Key 并按 Enter 即可。

你会看到确认信息:

API Key Saved.

按 Enter 确认默认 Base URL(DeepSeek 无需修改)。

DeepSeek Base URL 确认界面 图 12:Base URL 配置界面,显示默认 DeepSeek API 端点

Step 3.4: 选择默认模型

向导会展示 DeepSeek 支持的模型列表:

Select default model:
-> deepseek-v4-flash <- currently in use
      deepseek-chat
      deepseek-reasoner
      deepseek-v4-pro
      Enter custom model name
      Skip (keep current)

使用方向键选择 deepseek-v4-flash(推荐,速度、性能和成本平衡优秀),然后按 Enter。

确认信息:

✓ Default model set to: deepseek-v4-flash

DeepSeek 模型选择菜单 - 推荐 deepseek-v4-flash 图 13:模型选择界面,突出显示推荐的 deepseek-v4-flash 模型

Step 3.5: 暂时跳过消息平台设置

当系统询问是否连接消息平台时,选择:Skip — set up later with 'hermes setup gateway' 按 Enter 完成初始设置向导。

Step 4: 验证 LLM 配置

检查 LLM 连接是否正常:

  1. 当终端提示 Launch hermes chat now? [Y/n]: 时,输入 Y 并按 Enter。
  2. Hermes 命令行聊天界面(TUI)会启动。
  3. 发送一条测试消息(例如 “Hi, introduce yourself”),确认 Hermes 能正常回复。

如果一切正常,就可以开始连接消息平台,并从任何地方使用你的 Hermes Agent!

Hermes Agent TUI 命令行聊天界面 图 14:Hermes Agent 的交互式文本聊天界面,显示 LLM 连接成功

工具可用性说明

设置完成后,你可能会看到已启用和未启用工具的摘要:

◆ Tool Availability Summary
  6/11 tool categories available:
   ✓ Vision (image analysis)
   ✗ Mixture of Agents (missing OPENROUTER_API_KEY)
   ✗ Web Search & Extract (missing EXA_API_KEY, PARALLEL_API_KEY, FIRECRAWL_API_KEY/FIRECRAWL_API_URL, or TAVILY_API_KEY)
   ✓ Browser Automation (Local browser)
   ✗ Image Generation (missing FAL_KEY or OPENAI_API_KEY)
   ✓ Text-to-Speech (Edge TTS)
   ✗ RL Training (Tinker) (missing TINKER_API_KEY)
   ✗ Skills Hub (GitHub) (missing GITHUB_TOKEN)
   ✓ Terminal/Commands
   ✓ Task Planning (todo)
   ✓ Skills (view, create, edit)

如需启用更多工具,运行:

hermes setup tools  # Interactive tool configuration wizard

或者直接编辑配置文件:

nano /home/ubuntu/.hermes/.env       # Store API keys here
nano /home/ubuntu/.hermes/config.yaml # Core Hermes configuration

6. 接入消息平台

Hermes Agent 的真正优势在于,你可以通过常用消息应用随时随地与它交互。要连接平台,请运行网关设置向导:

hermes setup gateway

向导会显示所有支持的消息平台列表:

┌─────────────────────────────────────────────────────────┐
│     ⚕ Hermes Setup — Messaging Platforms (Gateway)      │
└─────────────────────────────────────────────────────────┘

◆ Messaging Platforms
  Connect to messaging platforms to chat with Hermes from anywhere.
  Toggle with Space, confirm with Enter.

  Select platforms to configure:
  Toggle by number, Enter to confirm.

  [✓]  1. 📱 Telegram  (configured)
  [✓]  2. 💬 Discord  (configured)
  [ ]  3. 💼 Slack  (not configured)
  [ ]  4. 🔐 Matrix  (not configured)
  [ ]  5. 💬 Mattermost  (not configured)
  [ ]  6. 📲 WhatsApp  (enabled, not paired)
  [ ]  7. 📡 Signal  (not configured)
  [ ]  8. 📧 Email  (not configured)
  [ ]  9. 📱 SMS (Twilio)  (not configured)
  [ ] 10. 💬 DingTalk  (not configured)
  [ ] 11. 🪽 Feishu / Lark  (not configured)
  [ ] 12. 💬 WeCom (Enterprise WeChat)  (not configured)
  [ ] 13. 💬 WeCom Callback (Self-Built App)  (not configured)
  [ ] 14. 💬 Weixin / WeChat  (not configured)
  [ ] 15. 💬 BlueBubbles (iMessage)  (not configured)
  [ ] 16. 🐧 QQ Bot  (not configured)
  [ ] 17. 💎 Yuanbao  (not configured)
  [ ] 18. 💬 IRC  (not configured)
  [ ] 19. 💼 Microsoft Teams  (not configured)

  Toggle # (or Enter to confirm):

Hermes Agent 消息网关设置菜单 图 15:可用于集成的 19 个消息平台完整列表


6.1 Telegram(推荐)

Telegram 是与 Hermes Agent 集成最稳定、可靠、也最简单的平台。它性能优秀、延迟低,并完整支持 Hermes 的各项功能,包括文件上传、图像分析和语音消息。

Step 1: 创建 Telegram Bot

  1. 打开 Telegram 应用,在搜索栏中查找 @BotFather
  2. 发送 /start 启动 BotFather 交互界面。
  3. 发送 /newbot 创建新机器人:
    • 输入机器人的 名称(例如 “My Hermes Assistant”)。
    • 输入机器人的 用户名。用户名必须以 bot 结尾(例如 my_hermes_ai_bot)。
  4. BotFather 会为你的机器人生成一个 HTTP API Token。复制该 Token 并妥善保存——它是 Hermes 控制机器人的认证密钥。

通过 @BotFather 创建 Telegram Bot 的完整流程 图 16:6 图分步指南,展示 Telegram Bot 创建全过程

Step 2: 在 Hermes 中配置 Telegram

  1. 回到服务器终端中的 hermes setup gateway 菜单。
  2. 输入 1 选择 Telegram,并按 Enter。
  3. 按提示粘贴从 BotFather 复制的 API Token。
  4. 向导会保存 Token,并自动启动 Telegram 网关。

Step 3: 测试 Telegram Bot

  1. 在 Telegram 中使用你创建的用户名搜索机器人(例如 @my_hermes_ai_bot)。
  2. 发送 /start 开始对话。
  3. 发送 /new 创建一个带有全新上下文的聊天线程。
  4. 发送测试消息(例如 “Hi, what can you do?”)——Hermes 应在几秒内回复。

Telegram 中成功运行的 Hermes Agent Bot 测试聊天 图 17:Telegram 中的成功测试对话,显示 Hermes Agent 正常回复


6.2 Discord

Discord 非常适合在团队或社区中使用 Hermes Agent。它支持斜杠命令、基于线程的对话以及私信。


Phase 1: 创建 Discord Application 与 Bot

  1. 使用你的 Discord 账号登录 Discord Developer Portal
  2. 点击右上角的 New Application 按钮。
  3. 输入 “Hermes” 作为应用名称,然后点击 Create

分步截图: Discord Developer Portal 中的新建应用按钮 图 18:Discord Developer Portal 首页,突出显示“New Application”按钮

Discord 应用创建窗口 - 为你的 Bot 命名 图 19:输入 Discord Bot 应用名称的弹窗

Step 1: 自定义 Bot(可选)
  1. General Information 标签页中,可以为 Bot 上传头像(例如官方 Hermes Logo)。
  2. 点击 Save Changes 应用修改。

Discord 应用 General Information 标签页 图 20:General Information 页面,可上传自定义 Bot 头像

Discord Bot 头像上传与裁剪编辑器 图 21:用于裁剪和调整 Bot 头像的图片编辑器

Step 2: 配置安装与权限
  1. 进入左侧菜单中的 Installation 标签页:
    • Installation Contexts 下,勾选 User InstallGuild Install
    • Guild Install 下,选择 scopes:botapplications.commands
    • 选择 bot 后,会出现 Permissions 区域。勾选以下权限:
      • Add Reactions
      • Embed Links
      • Read Message History
      • Send Messages
      • Send Messages in Threads
      • Send TTS Messages
      • Send Voice Messages
      • Use Application Commands
      • View Channels
  2. 点击页面底部的 Save Changes

Discord 应用 Installation 标签页 - 权限配置 图 22:Installation 标签页,显示默认权限设置

完整 Discord Bot 权限配置 图 23:完整配置后的权限列表,展示 Hermes Agent 所需全部权限

Step 3: 启用特权 Gateway Intents

为了让 Hermes 正常读取消息并与用户互动,需要启用特权 Gateway Intents:

  1. 进入左侧菜单中的 Bot 标签页。
  2. 滚动到 Privileged Gateway Intents 区域。
  3. 将以下 intents 切换为 ON 状态(开关会变成蓝色):
  • Presence Intent
  • Server Members Intent
  • Message Content Intent(这是读取聊天消息的关键)
  1. 如有提示,请保存修改。

Discord Bot 特权 Gateway Intents - 全部启用 图 24:关键的 Privileged Gateway Intents 区域,显示三个 intents 均已启用

Step 4: 生成 Bot Token
  1. Bot 标签页顶部,点击 Reset Token 按钮。
  2. 在警告弹窗中点击 “Yes, do it!” 确认操作。
  3. 如果你的 Discord 账号启用了 2FA,系统会要求输入验证码。
  4. 系统会生成一个新的 Token。点击 Copy 按钮复制到剪贴板。

🔒 严重安全警告:请把该 Token 当作主密码一样保护。不要分享给任何人,并尽快粘贴到 Hermes 配置中。如果 Token 泄露,任何人都可能接管你的 Bot。

Discord Bot 标签页中的 Reset Token 按钮 图 25:Bot 标签页,突出显示用于生成认证密钥的“Reset Token”按钮

Token 重置确认警告弹窗 图 26:确认重置 Token 的警告弹窗,说明旧 Token 将失效

复制新的 Discord Bot Token 按钮 图 27:已生成 Bot Token 的界面,可点击“Copy”保存密钥


Phase 2: 邀请 Bot 加入你的 Discord 服务器

  1. 回到 Discord Developer Portal 的 Installation 标签页。
  2. Install Link 区域复制生成的 URL。
  3. 将该链接粘贴到任意 Discord 频道并点击打开。
  4. Discord 授权弹窗会出现。在 “Add to server:” 下选择你想添加 Bot 的服务器。
  5. 点击 Continue,然后点击 Authorize
  6. 如有提示,完成真人验证 Captcha。
  7. 你会看到 “Success!” 页面。Hermes 已成功加入你的服务器!
  8. 若要将 Hermes Agent Discord Bot 添加到你的个人应用以便访问:
  9. 在成功页面点击 Add to My Apps
  10. 你会看到第二个 “Success!” 页面,确认 Hermes 已添加到你的账号应用中。

分步截图: Discord Bot 安装链接复制 图 28:Installation 标签页,显示生成的 Bot 邀请链接

Discord 授权界面的服务器选择下拉框 图 29:授权界面,可选择将 Bot 添加到哪个服务器

Discord Bot 权限授权界面 图 30:最终授权界面,展示 Bot 将获得的所有权限

成功页面上的 Add to My Apps 按钮 图 31:成功页面,可选择将 Bot 添加到个人应用

应用添加成功确认界面 图 32:最终确认界面,显示 Bot 已成功添加到你的账号


Phase 3: 在 Hermes 中配置 Discord 并测试

  1. 回到服务器终端中的 hermes setup gateway 菜单。
  2. 输入 2 选择 Discord,并按 Enter。
  3. 粘贴从 Discord Developer Portal 复制的 Bot Token。
  4. 向导会保存 Token 并启动 Discord 网关。
  5. 在你的 Discord 服务器中进入一个频道(例如 #hermes),输入 / 查看 Hermes 的斜杠命令。
  6. 选择 /new 开始一个新会话——Hermes 会回复 “✨ New session started!”。
  7. 发送测试消息(例如 “Hi”),确认 Bot 正常回复。
Step 9: 测试私信(DM)
  1. 点击服务器中 Hermes 的头像,打开它的资料卡。
  2. 在 “Message @Hermes” 输入框中输入消息,即可发送私信。
  3. ⚠️ 重要:首次给 Bot 发送私信时,Discord 的反垃圾系统可能弹出 “Wait! Are you human?” 提示。勾选 Captcha 继续。
  4. 验证完成后,Hermes 会在私信线程中回复你。在 DM 中输入 /,可能会显示特定管理命令(如 /agents/branch)。

分步截图: Discord 斜杠命令测试 - /new 命令 图 33:Discord 聊天中显示 Hermes Agent 可用斜杠命令

Discord 频道聊天测试 - 完整对话 图 34:Discord 频道中的成功测试对话,显示 Hermes Agent 正常回复

Hermes Bot 资料卡与消息按钮 图 35:Bot 资料卡,显示可开启私信的“Message”按钮

Discord 私信(DM)测试对话 图 36:私信中的成功测试对话,显示 Hermes Agent 正常回复

Bonus: 启用 Discord Developer Mode

为了更方便进行 Bot 开发:

  1. 打开 Discord → 点击左下角 User Settings
  2. 进入 Advanced → 开启 Developer Mode
  3. 右键点击用户、频道或服务器即可复制 ID(对自定义代码很有用)。

6.3 Email(IMAP/SMTP)

将 Hermes Agent 部署为邮件实体后,你可以通过标准邮件协议与它交互,因此任何带有邮件客户端的设备都能访问它——无需额外安装应用。这对于异步沟通和长时间运行的任务尤其有用。

⚠️ 重要域名说明:下方所有示例都使用我的个人域名 aclassickoder.tk 进行演示。实际操作时必须将 aclassickoder.tk 替换为你自己的真实域名。不要将我的域名用于你的部署。

Phase 1: 准备邮件基础设施

  1. DNS 配置:如果使用自定义域名(例如 bot.aclassickoder.tk——请替换成你自己的域名),请在邮件服务商处配置以下 DNS 记录:
    • MX 记录,指向邮件服务商的接收服务器。
    • SPF、DKIM 和 DMARC TXT 记录,防止外发邮件被标记为垃圾邮件。
  2. 创建专用邮箱:为 Hermes Agent 创建一个全新、独立的邮箱(例如 hermes@bot.aclassickoder.tk)。 > 🔒 安全警告:不要将 Hermes 绑定到你的个人邮箱。该 Agent 需要不受限制的 IMAP 读取权限来解析邮件,这会让你的全部个人邮件暴露给 Agent。
  3. 启用协议:确认该专用邮箱已启用 IMAP(通常为 993/SSL)和 SMTP(通常为 587/STARTTLS)。

为 Hermes Agent 创建专用邮箱 图 37:邮箱创建表单,展示 hermes@bot.aclassickoder.tk 专用邮箱设置

Phase 2: 配置 Email 网关

  1. 在服务器终端中运行:

    hermes setup gateway
    
  2. 输入 8 选择 Email 平台,并按 Enter。

Hermes 网关设置中的 Email 平台选择 图 38:Gateway setup 菜单,显示已选择 Email 作为待配置平台

Phase 3: 输入 Email 凭证

向导会提示你输入以下信息:

  1. Email address:你创建的 Hermes 专用邮箱地址(例如 hermes@bot.aclassickoder.tk——请替换为你自己的邮箱)。
  2. Email password:邮箱账号密码。如果你的服务商使用 OAuth2 或 2FA,则必须在此处使用应用专用密码。
  3. IMAP host:邮件服务商的 IMAP 服务器地址(例如 Gmail 为 imap.gmail.com)。
  4. SMTP host:邮件服务商的 SMTP 服务器地址(例如 Gmail 为 smtp.gmail.com)。
  5. Allowed sender emails:留空并按 Enter,以启用 Zero-Trust DM Pairing Mode。该模式可确保只有明确授权的用户才能与 Hermes Agent 交互。
  6. 当提示是否重启网关时,输入 Y 并按 Enter。

Email 凭证配置向导 - 完整设置 图 39:Email 配置界面,显示所有凭证已输入并成功保存

Phase 4: 完成 Zero-Trust 配对握手

由于我们启用了 Zero-Trust 模式,因此需要安全地将你的个人邮箱与 Hermes 配对:

  1. 打开你的个人邮件客户端,向 Hermes 邮箱地址(例如 hermes@bot.aclassickoder.tk)发送一封测试邮件(例如 “Hi!”)。
  2. Hermes 会拦截邮件,识别出你的地址尚未授权,并自动回复一封包含唯一配对 Token 的邮件(例如 69RVKU5P)。
  3. 回到服务器终端并运行:sh hermes pairing approve email 69RVKU5P(将 69RVKU5P 替换为你实际收到的 Token。)
  4. 你会看到确认信息:Approved! User... on email can now use the bot

Hermes 自动发送的配对 Token 请求邮件 图 40:Hermes 自动邮件,包含用于授权的唯一配对 Token

Phase 5: 测试 Email 集成

  1. 回复配对邮件线程,输入提示词(例如 “Hi, how are you? What can you do?”)。
  2. Hermes 会解析邮件头(In-Reply-ToReferences),以保持对话上下文。
  3. 处理完成后,Hermes 会直接回复到该邮件线程中。

发送给 Hermes Agent 的测试邮件提示词 图 41:准备发送给 Hermes Agent 邮箱的测试邮件

Hermes Agent 成功邮件回复 图 42:Hermes Agent 的成功回复,显示 Email 集成正常工作

Phase 6: 为异步通知设置 Home Channel

Email 是无状态协议。为了确保 Hermes 能主动向你发送通知(例如后台任务、Cron job 或告警结果),你需要将你的邮箱设置为 “home channel”:

  1. 第一次成功邮件交互后,Hermes 会自动发送系统消息: > 📭 No home channel is set for Email. A home channel is where Hermes delivers cron job results and cross-platform messages. > Type /sethome to make this chat your home channel, or ignore to skip.
  2. 在该邮件线程中回复准确命令:/sethome
  3. Hermes 会永久将你的邮箱地址注册为所有异步输出的默认接收位置。

Hermes Agent 的 Home Channel 警告消息 图 43:系统消息说明 home channel 功能以及如何启用


7. 开发者社区与支持

加入不断壮大的 Hermes Agent 社区,获取高级技巧、分享技能、寻求故障排查帮助,并及时了解最新进展:

7.1 OpenClaw Developer Discord

这是 OpenClaw 和 Hermes Agent 用户的官方社区。你可以在这里找到:

  • 最新插件模板和自定义技能
  • 高级部署指南和最佳实践
  • 来自开发者和资深用户的直接支持
  • 新功能和更新的早期体验机会

7.2 专属支持渠道

如需直接技术支持,请加入以下渠道:


平台 加入链接/二维码


Discord Discord 社区二维码
社区


8. 最终提示与故障排查

Hermes CLI 常用命令(快速参考)


任务 命令


运行完整设置向导 hermes setup

重新配置 LLM 模型 hermes setup model

连接消息平台 hermes setup gateway

启用/禁用工具 hermes setup tools

查看当前配置 hermes config

在默认编辑器中编辑配置 hermes config edit

设置指定配置项 hermes config set <key> <value>

启动命令行聊天 hermes

启动消息网关 hermes gateway

诊断系统问题 hermes doctor

批准邮件配对 hermes pairing approve email <TOKEN>

从 OpenClaw 迁移 hermes claw migrate

性能优化建议

  • 为获得最佳性能,请使用腾讯云轻量应用服务器 LH 2C4G Linux 套餐。你可以通过这里获取专属折扣和双倍代金券奖励:👉 领取 LH 2C4G Linux 专属奖励

  • 如果响应较慢,可以尝试切换到更快的 LLM 模型,例如 deepseek-v4-flash

  • 定期清理旧会话日志以释放磁盘空间:

    rm -rf ~/.hermes/sessions/*
    
  • 对于长时间运行的任务,可使用 /background 命令在后台运行,避免阻塞聊天。

常见问题排查

  1. Hermes 不回复消息
    • 检查网关是否正在运行:

      hermes gateway
      
    • 确认你的 API Key 有效且账户余额为正\

    • 运行 hermes doctor 诊断系统问题

  2. Discord Bot 无法读取消息
    • 确保已在 Discord Developer Portal 中启用 Message Content Intent
    • 确认 Bot 在服务器中拥有正确权限
  3. Email 集成无法工作
    • 检查邮箱账号是否已启用 IMAP 和 SMTP
    • 确认 DNS 记录(SPF/DKIM/DMARC)配置正确
    • 确保已完成 Zero-Trust 配对流程
  4. 工具未启用
    • 运行 hermes setup tools 配置更多工具服务商
    • 将所需 API Key 添加到 ~/.hermes/.env,并重启 Hermes
  5. 收不到异步通知
    • 确保已使用 /sethome 命令为消息平台设置 home channel
    • 确认网关服务持续运行

最后说明

  • 请始终妥善保护 API Key 和 Bot Token。不要公开分享,也不要提交到版本控制系统。
  • 为确保 7×24 小时在线,请使用 systemdscreen 将 Hermes 网关作为后台服务运行。
  • 定期检查 Hermes Agent 更新,以获取新功能、性能改进和安全补丁。
  • 如果后续需要升级轻量应用服务器实例,可在腾讯云控制台中几次点击完成——别忘了使用首次购买获得的专属代金券!

💡 最后提醒:如果你还没有购买轻量应用服务器实例,请使用我的专属链接获得最优价格和 双倍代金券奖励:👉 立即在腾讯云轻量应用服务器部署你的 Hermes Agent

祝你使用愉快,享受这个每天都在变聪明的自进化 AI Agent!🚀