腾讯云 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 的方式把模型切换成