Hermes Agent 是 Nous Research 开源的自主 AI Agent 框架；Hermes 的核心特色在于其内置的闭环学习（Closed Learning Loop）机制。

部署前准备

1. 七牛云账号，开通两步验证，且账户余额或额度不低于 100 元：完成七牛云账号注册与实名认证（个人 / 企业均可），登录七牛云控制台，并开通两步验证；
2. 已获取七牛云 MaaS API Key
3. 工具准备：本地电脑安装 SSH 远程连接工具（如 FinalShell、Xshell、Putty）；
4. 网络要求：本地设备可访问外网，七牛云 LAS 实例默认放行 22（SSH）端口，无需额外配置防火墙。

基于云主机专属镜像的一键部署

1. 创建 LAS 实例，选择 HermesAgent-v2026.4.13.lf 专属镜像

登录七牛云控制台，进入云基础资源 - 全栈应用服务器 LAS 页面，点击「实例」-「创建服务器」；

2. 实例配置选择

• 地域：按需选择（中国、亚太等多区域已部署，推荐就近选择降低延迟）；
• 实例规格：个人测试推荐轻量型 T1（ecs.t1.c1m2，1 核 2GiB），企业使用可选择计算型 C1 系列（ecs.c1.c2m4，2 核 4GiB）；
• 镜像：必须选择社区镜像 HermesAgent-v2026.4.13.lf，操作系统为 Ubuntu 24.04LTS，已预装 Hermes Agent 核心环境；
• 填写并确认实例密码（需牢记，后续 SSH 登录使用，后续也可重置），点击「立即购买并创建」，等待 1-2 分钟，实例即可运行。
  

3. 本地终端配置配置 Hermes Agent

配置 Hermes Agent说明

说明： 【七牛云 LAS 服务器 IP】 需替换为实际实例的公网 IP。特别的，如果是共享 IP 机型，此处应替换为 公网IP:port。

1、登录服务器（Windows推荐使用PowerShell、xshell工具登录；Mac/Linux系统可直接在本地终端执行命令登录）
ssh root@<七牛云 LAS 服务器 IP>  然后输入服务器登录密码
2、登录成功后，输入以下命令开始配置调用七牛模型
hermes model

注意：
1、API base URL填写：https://api.qnaigc.com/v1 或 https://anthropic.qnaigc.com
2、API key在 七牛控制台 查询获取；
3、模型ID可以在七牛控制台 模型广场 查询



说明：Context length配置可以直接回车，使用默认值；配置信息默认保存位置：.hermes/config.yaml

4. 运行Hermes Agent

在终端中输入以下命令，回车即可
hermes 

常见问题

Q1: SSH 登录失败怎么办？
检查实例是否处于「运行中」状态，公网 IP 是否正确，密码是否输入无误，七牛云 LAS 默认放行 22 端口，无需额外配置；

Q2: 模型调用失败怎么排查
检查七牛云 MaaS API Key 是否正确，是否已领取七牛云 Token 资源包，模型 ID 是否与七牛云模型广场一致；

Q3: 如何切换模型？
编辑 .hermes/config.yaml 配置文件的配置模型参数可以切换模型

• 执行 ssh root@<七牛云 LAS 服务器公网IP> 登录到服务器

• 执行命令打开模型配置文件 vim .hermes/config.yaml 找到 “custom_providers中的model” 字段设置单个模型ID
  

• 如果需要设置多个模型ID，可以把 “custom_providers中的model修改为models” 设置多个
  
  若需使用 DeepSeek、Qwen、Kimi 等其他模型，可在七牛云模型广场复制目标模型的「ID」和「名称」，直接替换上述配置中的 id（模型ID） 和 name（本地模型备注名称） 即可；修改完成之后，按 esc，然后 :x 回车 保存退出。
  之后重新执行 hermes 命令重启hermes即可