腾讯云 Ubuntu 服务器部署 Hermes Agent 详细安装教程

一、部署目的

在腾讯云 Ubuntu 云服务器上，完整安装、配置并启动 Hermes Agent AI 智能体，通过 OpenRouter 平台接入大模型（以 stepfun/step-3.5-flash 为例），搭建可执行对话、代码运行、文件操作、网页浏览等任务的 AI 智能体环境，实现稳定、长期在线运行。

二、前提说明

1. 1. 本环境为腾讯云远程 Ubuntu 服务器，本身已是完整 Linux 系统，无需安装 WSL2（WSL2 仅适用于 Windows 本地）。
2. 2. 全程使用服务器终端（OrcaTerm）操作，所有命令均在 Linux 环境下执行。
3. 3. 本文档不含真实密钥，仅保留配置格式，需自行注册 OpenRouter 并获取 API Key。

---

三、OpenRouter 注册与获取 API Key 教程

1. 注册 OpenRouter 账号

1. 1. 打开浏览器访问：https://openrouter.ai
2. 2. 点击右上角 Sign in / Sign up
3. 3. 支持使用 Google、GitHub、Discord 或邮箱注册
4. 4. 按提示完成邮箱验证、登录

2. 获取 API Key

1. 1. 登录后点击右上角头像 → API Keys
2. 2. 点击 Create API key
3. 3. 设置名称（如 hermes-agent），按需设置限额
4. 4. 点击 Create
5. 5. 复制生成的 Key（只显示一次，务必保存）

3. 充值与模型权限（可选）

• OpenRouter 部分模型免费，高阶模型需充值
• 支持信用卡、支付宝等方式
• 确保账户有余额，避免调用时报额度错误

---

四、服务器环境准备

1. 更新系统软件源

sudo apt update && sudo apt upgrade -y

2. 安装基础依赖工具

sudo apt install git curl python3 python3-pip -y

---

五、下载与安装 Hermes Agent

1. 克隆项目代码

git clone https://github.com/nousresearch/hermes-agent.git

2. 进入项目目录

cd hermes-agent

3. 安装 Python 依赖包

pip3 install -r requirements.txt

说明：若出现"以 root 运行 pip"警告，云服务器环境可忽略，不影响功能。

---

六、模型接入配置（OpenRouter）

1. 配置 OpenRouter API Key

将下方命令中的 你的OpenRouter_API_Key 替换为你自己的密钥：

export OPENROUTER_API_KEY="你的OpenRouter_API_Key"

2. 指定使用模型

本文档以阶跃星辰 stepfun/step-3.5-flash 为例：

export OPENROUTER_MODEL="stepfun/step-3.5-flash"

如需更换其他模型，可在 OpenRouter 官网模型页面复制模型标识替换即可。

---

七、启动 Hermes Agent

1. 正确启动方式

该项目无 main.py，入口文件为 cli.py：

python3 cli.py

2. 启动成功标志

• 出现金色 Hermes ASCII 艺术 Logo
• 显示 Welcome to Hermes Agent!
• 列出可用工具：browser、code_execution、file 等
• 底部出现当前使用模型名称与输入光标

---

八、终端界面颜色调整

当前浅色终端+黄色状态栏可能刺眼，可调整终端主题：

1. 1. 点击腾讯云 OrcaTerm 右上角 齿轮设置图标
2. 2. 进入 外观 / 主题
3. 3. 选择深色主题：
   • 黑色背景
   • Dracula
   • Monokai
4. 4. 保存后，整体界面更柔和，黄色状态栏显示更舒适

---

九、常见问题与解决方案

1. 错误：can't open file 'main.py'

• 原因：项目启动文件不是 main.py
• 解决：使用 python3 cli.py 启动

2. 错误：AuthenticationError [HTTP 401]

• 原因：API Key 未配置或错误
• 解决：重新执行 export OPENROUTER_API_KEY="xxx"

3. 错误：BadRequestError [HTTP 400] No models provided

• 原因：未指定模型
• 解决：执行 export OPENROUTER_MODEL="stepfun/step-3.5-flash" 后重启

4. 关闭终端后程序停止

• 解决：使用 screen 后台运行

  screen -S hermes

  在新窗口中执行启动命令

  python3 cli.py

  按 Ctrl+A 再按 D 挂后台

---

十、使用说明

启动成功后，直接在光标处输入问题即可使用：

• 普通对话
• 代码编写与执行
• 文件读写
• 联网搜索
• 复杂任务规划

输入 /help 可查看 Hermes 内置命令列表。

换模型打开使用

下面这两段读不懂可以问一下ai

python3 cli.py --model "deepseek/deepseek-chat"用minimax/minimax-m2.5:free

minimax/minimax-m2.5:free用 export 的方式把模型切换成