⚕️ Hermes Agent 腾讯云服务器部署全指南

本指南针对腾讯云（Lighthouse/CVM）国内节点环境进行了特别优化，旨在解决常见的网络封锁与 API 地区限制问题。

1. 基础环境配置

在开始之前，确保你的系统（Ubuntu 22.04+ 推荐）已更新并安装了基础工具。

Bash

sudo apt update && sudo apt upgrade -y
sudo apt install -y git python3-pip python3-venv build-essential unzip nodejs npm

2. 获取代码（避开网络波动）

由于国内直接连接 GitHub 不稳定，建议使用加速代理下载。

Bash

cd ~
# 使用加速镜像下载主分支压缩包
wget --no-check-certificate https://github.moeyy.xyz/https://github.com/NousResearch/hermes-agent/archive/refs/heads/main.zip

# 解压并重命名
unzip main.zip
mv hermes-agent-main hermes-agent
cd hermes-agent

3. 建立隔离的 Python 环境

注意： 务必使用虚拟环境，否则可能会导致 hermes 命令冲突或无法找到。

Bash

python3 -m venv venv
source venv/bin/activate

# 必须使用国内镜像源安装依赖，否则下包会极慢或超时
pip install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple
pip install -e . -i https://pypi.tuna.tsinghua.edu.cn/simple

4. 核心功能配置 (hermes setup)

执行 hermes setup 进入交互界面。以下是针对腾讯云用户的最优选：

A. 模型选择 (Provider)

• 服务商：推荐 OpenRouter。
• 模型避坑：不要选 Gemini 或 Claude（由于腾讯云 IP 限制，会报 403 Forbidden）。
• 推荐模型：deepseek/deepseek-chat 或 qwen/qwen-2.5-72b-instruct。

B. 语音设置 (TTS)

• 选择 Edge TTS (free)。它无需 Key 且中文合成效果极佳。

C. 消息网关 (Messaging Gateway)

• 操作技巧：在菜单中移动到目标平台（如 WeCom/Feishu），必须先按 Space（空格） 选中，看到选项变色或圆圈变实心后，再按 Enter（回车）。
• 安全模式：建议选择 Use DM pairing approval（配对码模式）。

5. 腾讯云安全组配置

Agent 运行网关时需要监听端口。

1. 登录腾讯云后台。
2. 进入“安全组” -> “添加规则”。
3. 开放 3000 端口（TCP），来源地址设为 0.0.0.0/0。

6. 微信连通与配对流程

当你在微信中首次向机器人发送消息时：

1. 机器人会回复一个 8 位配对码（如 RLRR8YHK）。

2. 回到服务器终端，在 venv 激活状态下输入：

   Bash

   # 示例命令，平台名根据你 setup 时的选择而定
   hermes pairing approve weixin RLRR8YHK
   

3. 显示 Pairing approved! 后，即可开始微信聊天。

7. 持久化与后台守护 (PM2)

为了防止退出 SSH 后机器人离线，使用 PM2 进行进程管理。

Bash

# 全局安装 pm2
sudo npm install pm2 -g

# 启动网关服务
pm2 start "hermes gateway" --name hermes-bot

# 设置开机自启
pm2 save
pm2 startup

8. 常用维护命令

任务	命令
重新进入交互配置	hermes setup
检查系统健康状态	hermes doctor
查看机器人实时日志	pm2 logs hermes-bot
重启网关服务	pm2 restart hermes-bot
修改 API Key 或环境变量	nano ~/.hermes/.env

---

🎓 开发者结语

此方案不仅适用于日常对话，更适合作为我的 YOLOv11 监控助手 或 网络安全分析助手。你可以通过 hermes 的终端控制能力，在微信上远程执行 Linux 命令或查看科研任务进度。