第 2 课快速部署：连接 Telegram 和 WhatsApp

本课目标

在 VPS / 本地环境完成 Hermes Agent 安装与首次对话
配置 Telegram Bot 网关，实现手机远程控制
配置 WhatsApp Business 网关，用于客户沟通场景
完成电商运营专属的 SOUL.md 人格定制

2.1 安装环境准备

Hermes Agent 支持以下操作系统：

Linux（Ubuntu 22.04+ / Debian 12+ / CentOS 9+）— 推荐，也是 VPS 的首选
macOS（Ventura 13+）— 本地开发测试
WSL2（Windows 用户）— Windows 原生不支持，必须通过 WSL2
Android Termux — 移动端调试，功能受限

硬件要求

Hermes Agent 本身是一个 Python 应用，非常轻量。真正消耗资源的是你选择运行的本地模型（如果有的话）。对于大多数电商用户，推荐使用云端 API（OpenRouter / Nous Portal），此时硬件要求极低：

配置	最低要求	推荐配置
CPU	1 核	2 核
内存	512 MB	1-2 GB
磁盘	2 GB	10 GB（含日志和缓存）
网络	稳定的外网访问	低延迟网络

推荐 VPS 方案（电商卖家）：

DigitalOcean / Vultr / Linode：$5-6/月，1 核 1GB，足够运行 Hermes + 网关
Hetzner Cloud：€4.51/月（约 $5），性价比最高的欧洲节点
Oracle Cloud Free Tier：永久免费的 ARM 实例（1 核 6GB），适合预算紧张的新卖家

⚠️ 注意： 如果你的主要客户在北美/欧洲，请选择相应地区的 VPS 机房，以减少网关消息延迟。

前置依赖

Hermes Agent 需要 Python 3.11+。安装脚本会自动处理依赖，但请确保你的系统有基础的构建工具：

# Ubuntu / Debian
sudo apt update && sudo apt install -y curl git build-essential

# macOS（已有 Xcode Command Line Tools）
xcode-select --install  # 如果尚未安装

2.2 一键安装 Hermes Agent

Hermes 提供了官方安装脚本，一行命令完成全部安装：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

安装脚本会自动完成以下操作：

检测操作系统和 Python 版本
使用 uv（Astral 出品的超快 Python 包管理器）创建虚拟环境
安装 Hermes Agent 及其所有依赖
将 hermes 命令加入系统 PATH

安装完成后，重新加载 Shell：

source ~/.bashrc    # bash 用户
# 或
source ~/.zshrc     # zsh 用户

验证安装：

hermes --version
# 输出示例：hermes-agent v0.8.0 (v2026.4.8)

首次运行设置向导

hermes setup

设置向导会引导你完成以下配置：

第一步：选择 LLM 提供商

推荐电商卖家使用以下方案：

提供商	价格	推荐模型	适合场景
OpenRouter	按 token 计费	Claude 3.5 Sonnet / GPT-4o	通用方案，200+ 模型可选
Nous Portal	按 token 计费	Hermes 系列模型	Nous 官方，支持 RL 训练的模型
z.ai / GLM	部分免费额度	GLM-4 系列	中文电商场景成本低

💡 成本提示： 日常电商运营（选品分析 + 竞品监控 + 邮件回复），每天约消耗 50k-200k token，使用 OpenRouter 的 Claude Sonnet 约 $0.3-1.0/天。

第二步：选择工具集

hermes tools

对于电商场景，建议启用以下工具集：

✅ web_search — 竞品调研、选品分析必备
✅ code_execution — 数据分析、报表生成
✅ file_operations — 读写 CSV/Excel 报表
✅ terminal — 执行系统命令
⚠️ browser — 需要时再启用，消耗更多资源

第三步：开始第一次对话

hermes

试试输入：

你好！我是一个跨境电商卖家，主要在亚马逊美国站和 TikTok Shop 运营。
请记住我的基本情况，后续我们会频繁交流运营相关的问题。

Hermes 会把这段信息存入记忆系统，未来每次对话都能基于这个上下文来回答。

2.3 配置 Telegram Bot 网关

Telegram 是跨境卖家使用 Hermes 最常用的网关——它免费、全球可用、支持富文本消息和文件传输。配置完成后，你可以随时随地用手机 Telegram 与 Hermes 对话。

第一步：创建 Telegram Bot

打开 Telegram，搜索 @BotFather
发送 /newbot
输入 Bot 名称，例如 My Ecommerce Agent
输入 Bot 用户名（需要以 bot 结尾），例如 my_ecom_agent_bot
BotFather 会返回一个 API Token，格式类似 7123456789:AAH...

⚠️ 安全提醒： 妥善保管这个 Token。任何拥有 Token 的人都能控制你的 Bot。不要将其提交到公开的 Git 仓库。

第二步：获取你的 Telegram User ID

你需要知道自己的 Telegram 数字 ID，以便在 Hermes 中配置"仅允许特定用户发送指令"。

搜索 @userinfobot 并发送 /start
它会返回你的 User ID，例如 123456789

第三步：运行 Hermes Gateway 设置

hermes gateway setup

选择 Telegram，然后依次输入：

Bot Token：粘贴 BotFather 给你的 Token
Allowed Users：输入你的 Telegram User ID（多个用户用逗号分隔）

第四步：启动网关

hermes gateway start

你会看到类似输出：

✓ Telegram gateway connected
✓ Listening for messages from user 123456789
✓ Gateway running. Press Ctrl+C to stop.

第五步：测试

打开 Telegram，向你的 Bot 发送：

/status

Hermes 应该回复当前状态信息。然后试试电商相关的指令：

帮我搜索一下 Amazon US 上 "portable blender" 这个品类的竞争情况

保持网关后台运行

为了让网关在你关闭 SSH 后继续运行，使用 systemd 或 screen/tmux：

# 方法一：使用 screen（简单）
screen -S hermes-gw
hermes gateway start
# 按 Ctrl+A 然后 D 来分离会话

# 方法二：使用 systemd（推荐，开机自启）
sudo cp ~/.hermes/hermes-gateway.service /etc/systemd/system/
sudo systemctl enable hermes-gateway
sudo systemctl start hermes-gateway

2.4 配置 WhatsApp Business 网关

WhatsApp 在东南亚、中东、拉美市场是客户沟通的第一渠道。配置 WhatsApp 网关后，Hermes 可以自动处理客户发来的消息。

方案选择

方案	成本	适合场景
WhatsApp Business API（官方）	按消息计费	大卖家、需要大量客户触达
WhatsApp Web Bridge（社区）	免费	个人卖家、测试用途

方案 A：WhatsApp Business API（推荐生产用途）

注册 Meta Business 账号：https://business.facebook.com/
在 Meta for Developers 创建应用：https://developers.facebook.com/
添加 WhatsApp 产品，获取 Phone Number ID 和 Access Token
配置 Webhook URL（指向你的 Hermes 服务器）

hermes gateway setup
# 选择 WhatsApp
# 输入 Phone Number ID
# 输入 Access Token
# 输入 Webhook Verify Token（自定义一个安全字符串）

方案 B：WhatsApp Web Bridge（快速测试）

Hermes 社区提供了基于 whatsapp-web.js 的 Bridge，通过扫码登录你的 WhatsApp 账号：

hermes gateway setup
# 选择 WhatsApp Web
# 扫描终端显示的二维码

⚠️ 注意： WhatsApp Web Bridge 方案适合测试和个人使用，不适合大规模客户服务。WhatsApp 对自动化消息有严格的反滥用政策，频繁发送可能导致封号。

2.5 配置 Email 网关

Email 是跨境电商客户沟通的基础渠道。配置 Email 网关后，你可以让 Hermes 自动处理和回复客户邮件。

hermes gateway setup
# 选择 Email

需要配置以下信息：

# IMAP（接收邮件）
imap_server: imap.gmail.com
imap_port: 993
email_address: your-shop@gmail.com
email_password: xxxx-xxxx-xxxx-xxxx  # Gmail 需使用应用专用密码

# SMTP（发送邮件）
smtp_server: smtp.gmail.com
smtp_port: 587

💡 建议： 为 Hermes 创建一个专用邮箱（如 agent@yourdomain.com），将客户咨询邮件转发到这个邮箱。这样可以与你的个人邮件隔离。

2.6 电商运营专属 SOUL.md 定制

SOUL.md 是 Hermes Agent 的"人格文件"，定义了 Agent 的行为方式、回复风格和核心约束。对于电商运营场景，我们需要定制一份专属的 SOUL.md。

创建或编辑 ~/.hermes/SOUL.md：

# 跨境电商运营助手

## 身份
你是一位经验丰富的跨境电商运营专家和 AI 助手。
你精通亚马逊、TikTok Shop、速卖通等平台的运营规则。
你能流利使用中文、英文、日文进行工作。

## 行为准则
- 数据驱动：所有建议都基于数据分析，而非主观判断
- 风险意识：涉及价格调整、邮件发送等敏感操作时，主动提醒确认
- 合规优先：任何建议都不能违反平台政策
- 成本敏感：优先推荐性价比最高的方案

## 回复风格
- 使用简洁的运营术语，不做过多解释
- 数据分析结果用表格呈现
- 给出明确的 Action Item，而非笼统建议

## 核心约束
- 绝不自动发送客户邮件——必须人工确认后再发
- 绝不自动修改 Listing 或价格
- 涉及金额的建议必须标注数据来源和置信度

保存后，Hermes 会在每次对话中遵循这些规则。

2.7 验证全部网关

配置完成后，执行一次全面验证：

hermes gateway start

你应该看到类似输出：

✓ Telegram gateway connected (Bot: @my_ecom_agent_bot)
✓ WhatsApp gateway connected
✓ Email gateway connected (agent@yourdomain.com)
✓ All gateways running. Press Ctrl+C to stop.

验证清单

测试项	操作	预期结果
Telegram 连通	发送 `/status`	收到状态回复
WhatsApp 连通	发送 `hello`	收到欢迎回复
Email 连通	发送一封测试邮件	收到自动回复
记忆验证	在 Telegram 问"我做什么品类？"	回忆起之前的对话
跨平台验证	CLI 中创建记忆，Telegram 中查询	信息一致

2.8 动手练习：完成部署并发送你的第一条电商指令

目标： 在 VPS 或本地环境完成 Hermes 安装，配置至少一个消息网关（推荐 Telegram），并验证以下场景。

练习步骤：

执行安装命令并运行 hermes setup
配置 Telegram Bot 网关
通过 Telegram 发送以下指令并截图保存结果：

请帮我搜索 Amazon US 上 "desk organizer" 品类前 10 名的产品，
列出它们的价格、评分和 Review 数量，并分析竞争强度。

验收标准：

[ ] hermes --version 输出正确版本
[ ] Telegram Bot 能正常收发消息
[ ] SOUL.md 已定制为电商运营专属
[ ] 成功完成一次选品搜索指令

本课小结

要点	说明
一键安装	`curl -fsSL ...install.sh \| bash` 即可完成
推荐 VPS	$5/月即可运行 Hermes + 网关
Telegram 网关	免费、全球可用、配置最简单
WhatsApp 网关	适合客户沟通，注意反滥用政策
SOUL.md	电商专属人格 = 更精准的运营建议

下一课，我们将使用 Hermes 的 Web 搜索和代码执行能力，构建系统化的 AI 选品分析工作流。

第 2 课 快速部署：连接 Telegram 和 WhatsApp

第 2 课 快速部署：连接 Telegram 和 WhatsApp

本课目标

2.1 安装环境准备

硬件要求

前置依赖

2.2 一键安装 Hermes Agent

首次运行设置向导

2.3 配置 Telegram Bot 网关

第一步：创建 Telegram Bot

第二步：获取你的 Telegram User ID

第三步：运行 Hermes Gateway 设置

第四步：启动网关

第五步：测试

保持网关后台运行

2.4 配置 WhatsApp Business 网关

方案选择

方案 A：WhatsApp Business API（推荐生产用途）

方案 B：WhatsApp Web Bridge（快速测试）

2.5 配置 Email 网关

2.6 电商运营专属 SOUL.md 定制

2.7 验证全部网关

验证清单

2.8 动手练习：完成部署并发送你的第一条电商指令

本课小结

第 2 课快速部署：连接 Telegram 和 WhatsApp

第 2 课快速部署：连接 Telegram 和 WhatsApp