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

一、部署目的在腾讯云 Ubuntu 云服务器上完整安装、配置并启动 Hermes Agent AI 智能体通过 OpenRouter 平台接入大模型以 stepfun/step-3.5-flash 为例搭建可执行对话、代码运行、文件操作、网页浏览等任务的 AI 智能体环境实现稳定、长期在线运行。二、前提说明1. 本环境为腾讯云远程 Ubuntu 服务器本身已是完整 Linux 系统无需安装 WSL2WSL2 仅适用于 Windows 本地。2. 全程使用服务器终端OrcaTerm操作所有命令均在 Linux 环境下执行。3. 本文档不含真实密钥仅保留配置格式需自行注册 OpenRouter 并获取 API Key。三、OpenRouter 注册与获取 API Key 教程1. 注册 OpenRouter 账号1. 打开浏览器访问https://openrouter.ai2. 点击右上角 Sign in / Sign up3. 支持使用 Google、GitHub、Discord 或邮箱注册4. 按提示完成邮箱验证、登录2. 获取 API Key1. 登录后点击右上角头像 → API Keys2. 点击 Create API key3. 设置名称如 hermes-agent按需设置限额4. 点击 Create5. 复制生成的 Key只显示一次务必保存3. 充值与模型权限可选OpenRouter 部分模型免费高阶模型需充值支持信用卡、支付宝等方式确保账户有余额避免调用时报额度错误四、服务器环境准备1. 更新系统软件源sudo apt update sudo apt upgrade -y2. 安装基础依赖工具sudo apt install git curl python3 python3-pip -y五、下载与安装 Hermes Agent1. 克隆项目代码git clone https://github.com/nousresearch/hermes-agent.git2. 进入项目目录cd hermes-agent3. 安装 Python 依赖包pip3 install -r requirements.txt说明若出现“以 root 运行 pip”警告云服务器环境可忽略不影响功能。六、模型接入配置OpenRouter1. 配置 OpenRouter API Key将下方命令中的 你的OpenRouter_API_Key 替换为你自己的密钥export OPENROUTER_API_KEY你的OpenRouter_API_Key2. 指定使用模型本文档以阶跃星辰 stepfun/step-3.5-flash 为例export OPENROUTER_MODELstepfun/step-3.5-flash如需更换其他模型可在 OpenRouter 官网模型页面复制模型标识替换即可。七、启动 Hermes Agent1. 正确启动方式该项目无 main.py入口文件为 cli.pypython3 cli.py2. 启动成功标志出现金色 Hermes ASCII 艺术 Logo显示 Welcome to Hermes Agent!列出可用工具browser、code_execution、file 等底部出现当前使用模型名称与输入光标八、终端界面颜色调整当前浅色终端黄色状态栏可能刺眼可调整终端主题1. 点击腾讯云 OrcaTerm 右上角 齿轮设置图标2. 进入 外观 / 主题3. 选择深色主题黑色背景DraculaMonokai4. 保存后整体界面更柔和黄色状态栏显示更舒适九、常见问题与解决方案1. 错误cant open file main.py原因项目启动文件不是 main.py解决使用 python3 cli.py 启动2. 错误AuthenticationError [HTTP 401]原因API Key 未配置或错误解决重新执行 export OPENROUTER_API_KEYxxx3. 错误BadRequestError [HTTP 400] No models provided原因未指定模型解决执行 export OPENROUTER_MODELstepfun/step-3.5-flash 后重启4. 关闭终端后程序停止解决使用 screen 后台运行screen -S hermes # 在新窗口中执行启动命令 python3 cli.py # 按 CtrlA 再按 D 挂后台十、使用说明启动成功后直接在光标处输入问题即可使用普通对话代码编写与执行文件读写联网搜索复杂任务规划输入 /help 可查看 Hermes 内置命令列表。换模型打开使用下面这两段读不懂可以问一下aipython3 cli.py --model deepseek/deepseek-chat用minimax/minimax-m2.5:freeminimax/minimax-m2.5:free用 export 的方式把模型切换成