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

科技前沿 • 2026-04-14 12:43 • 阅读 2

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

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

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

1. 注册 OpenRouter 账号

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

2. 获取 API Key

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

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

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

1. 更新系统软件源

sudo apt update && sudo apt upgrade -y

2. 安装基础依赖工具

sudo apt install git curl python3 python3-pip -y

1. 克隆项目代码

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

2. 进入项目目录

cd hermes-agent

3. 安装 Python 依赖包

pip3 install -r requirements.txt

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

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 官网模型页面复制模型标识替换即可。

1. 正确启动方式

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

python3 cli.py

2. 启动成功标志

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

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

1. 点击腾讯云 OrcaTerm 右上角齿轮设置图标
2. 进入外观 / 主题
3. 选择深色主题：
- 黑色背景
- Dracula
- Monokai
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 的方式把模型切换成