第 02 课 基础设施：部署 Hermes Agent 与配置 Claude Opus 4.7 API
第 02 课 基础设施：部署 Hermes Agent 与配置 Claude Opus 4.7 API
本课目标
读完这一课，你将完成：
- 在你的电脑上部署 Hermes Agent v0.8.0
- 获取并配置 Claude Opus 4.7 API 密钥
- 通过 OpenRouter 配置多模型切换
- 连接 Telegram 作为你的远程控制台
- 发送第一条指令，验证系统运行正常
2.1 环境准备
硬件要求
| 配置 | 最低要求 | 推荐配置 |
|---|---|---|
| CPU | 2核 | 4核+ |
| 内存 | 4GB | 8GB+ |
| 存储 | 10GB | 50GB+（存放分析报告） |
| 网络 | 能访问国际网络 | 稳定的国际网络 |
软件要求
- Python 3.10+
- Git
- Node.js 18+（部分 MCP Server 需要）
- 一个 Telegram 账号
2.2 部署 Hermes Agent
步骤一：克隆仓库
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
步骤二：创建虚拟环境
python -m venv venv
# Windows
venv\Scripts\activate
# Mac/Linux
source venv/bin/activate
步骤三：安装依赖
pip install -r requirements.txt
步骤四：创建配置文件
cp .env.example .env
编辑 .env 文件：
# LLM 配置（通过 OpenRouter）
OPENROUTER_API_KEY=sk-or-xxxxx
DEFAULT_MODEL=anthropic/claude-opus-4-7
# Telegram 网关
TELEGRAM_BOT_TOKEN=123456:ABC-DEF
TELEGRAM_ALLOWED_USERS=your_telegram_id
# 工作目录
WORKSPACE_DIR=./workspace
2.3 获取 Claude Opus 4.7 API 密钥
方式一：直接通过 Anthropic（推荐）
- 访问 https://console.anthropic.com
- 注册/登录
- 创建 API Key
- 模型 ID：
claude-opus-4-7
# 直接调用示例
import anthropic
client = anthropic.Anthropic(api_key="sk-ant-xxxxx")
response = client.messages.create(
model="claude-opus-4-7",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello!"}]
)
print(response.content[0].text)
方式二：通过 OpenRouter（多模型切换）
- 访问 https://openrouter.ai
- 注册并充值
- 获取 API Key
OpenRouter 的优势：一个 API Key 可以切换 200+ 模型。
# 日常客服用便宜模型
CUSTOMER_SERVICE_MODEL = "anthropic/claude-sonnet-4-6"
# 选品分析用最强模型
PRODUCT_RESEARCH_MODEL = "anthropic/claude-opus-4-7"
# 简单翻译用最快模型
TRANSLATION_MODEL = "anthropic/claude-haiku-4-5"
2.4 配置 Telegram 网关
步骤一：创建 Telegram Bot
- 在 Telegram 搜索
@BotFather - 发送
/newbot - 输入 Bot 名称（如
MyEcommerceAgent） - 获取 Bot Token
步骤二：获取你的 Telegram ID
- 搜索
@userinfobot - 发送任意消息
- 获取你的 User ID
步骤三：配置并启动
将 Token 和 User ID 填入 .env 文件，然后启动：
python main.py --gateway telegram
步骤四：验证
在 Telegram 中向你的 Bot 发送：
你好，请告诉我你是谁，你能做什么？
如果收到回复，恭喜！你的 AI Agent 已经上线了。
2.5 配置 SOUL.md（Agent 人格）
Hermes 使用 SOUL.md 文件定义 Agent 的性格和行为规则。
创建 workspace/SOUL.md：
# 我的电商运营 Agent
## 身份
你是一个专业的跨境电商运营助手，服务于一个经营亚马逊和 Shopify 的中国卖家。
## 行为准则
- 所有分析都要基于数据，不要猜测
- 涉及金额超过100美元的操作需要我确认
- 发现竞品异常变动时立即通知我
- 日常汇报用中文，对外客户邮件用对应语言
- 保守估计利润，不要过度乐观
## 业务信息
- 主营品类：[你的品类]
- 主营市场：美国、日本
- 月销售目标：$XX,XXX
- 利润率底线：25%
## 工作节奏
- 早上6点：发送早间简报
- 白天：处理客户邮件和即时任务
- 晚上10点：发送日报
- 每周三：生成选品分析报告
2.6 首次运行测试清单
| 测试项 | 命令/操作 | 预期结果 |
|---|---|---|
| Hermes 启动 | python main.py |
无报错，显示 Ready |
| Telegram 连接 | 发送"你好" | 收到 Agent 回复 |
| Opus 4.7 调用 | 发送"帮我分析一下 portable blender 这个品类" | 收到详细分析 |
| 文件操作 | 发送"把刚才的分析保存到文件" | workspace 目录下出现文件 |
| 代码执行 | 发送"用 Python 生成一个 1-100 的随机数" | 返回一个数字 |
本课小结
- Hermes Agent 是你的远程操控框架，Telegram 是遥控器
- Claude Opus 4.7 通过 API 或 OpenRouter 接入
- SOUL.md 定义了 Agent 的"性格"和"规矩"
- 下一课我们将加上"记忆"——让 Agent 不再是金鱼记忆
下一课预告：第03课 — 用 OpenClaw 构建客户画像引擎，让你的 Agent 记住每一个客户。