UCloud星图AstraFlow接入Hermes Agent教程

UCloud星图AstraFlow是面向企业AI开发者提供模型推理服务等的一站式模型服务平台，一个API KEY直连200+主流大模型。本文主要为大家介绍UCloud星图AstraFlow安装Hermes Agent，并使其通过UModelverse平台调用模型教程。

Hermes Agent是Nous Research推出的开源自主AI Agent，可长期驻留服务器，支持持久记忆、定时任务、并行子代理等能力，并能接入Telegram、Discord等多个消息渠道。

点击进入：UCloud星图AstraFlow官网

一、前提条件

1、系统要求

Windows：Windows 10或Windows 11（需通过WSL2使用）。
macOS：macOS 10.15(Catalina)或更高版本。
Linux：Ubuntu 18.04+、CentOS 7+、Debian 9+。

2、所有平台均需要网络连接。安装脚本会自动准备Python、Git等依赖。

二、安装Hermes Agent

1、macOS/Linux

在终端执行安装脚本（会自动安装所需依赖）：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

重新加载终端环境，使命令生效：

source ~/.bashrc # 使用 zsh 时改为 source ~/.zshrc

查看版本号，能正常输出即安装成功：

hermes –version

2、Windows

Windows暂不支持原生安装，需先安装WSL2，再在WSL2终端中按上面macOS/Linux的步骤操作。

三、配置UModelverse API

1、获取API Key

访问UModelverse控制台获取您的API密钥。

2、写入配置

Hermes默认使用OpenRouter作为推理来源，接入UModelverse时需把model.provider设为custom。可以用命令逐项写入（将YOUR_API_KEY替换为实际Key）：

hermes config set model.provider custom
hermes config set model.base_url https://api.modelverse.cn
hermes config set model.api_mode anthropic_messages
hermes config set model.api_key YOUR_API_KEY
hermes config set model.default qwen3.7-max

上述命令会把配置写入~/.hermes/config.yaml。你也可以直接编辑该文件，效果相同：

model:
default: qwen3.7-max
provider: custom
base_url: https://api.modelverse.cn
api_mode: anthropic_messages
api_key: YOUR_API_KEY

model.default这里以qwen3.7-max为例，可替换为UModelverse平台支持的模型中的任意一个。

3、验证配置

发送一条测试消息：

hermes chat -q “你好”

能收到正常回复即配置成功。需要临时换模型时，用-m指定：

hermes chat -m deepseek-v4-pro