Hermes Agent

Hermes Agent

URL: https://mrxapi.com/docs/docs/tools/hermes

前置准备

开始之前，请确保你已经：

1. 注册并充值了MRXAPI AI 账号（快速开始）
2. 拥有一个 sk- 开头的 API 密钥
3. 已安装 Hermes Agent（GitHub）

配置MRXAPI模型

方式一：一行命令创建配置

打开终端，执行以下命令：

复制mkdir -p ~/.hermes
cat > ~/.hermes/config.yaml << 'EOF'
providers:
  lumai:
    name: lumai
    base_url: https://mrxapi.com/v1
    api_key: 你的API密钥
    model: glm-5.2

model:
  provider: lumai
  model: glm-5.2
EOF

将 你的API密钥 替换为你在MRXAPI后台创建的 sk- 开头的实际密钥。

方式二：手动编辑配置文件

如果 ~/.hermes/config.yaml 已存在，用编辑器打开它：

复制hermes config edit

在文件中添加或修改以下内容：

复制providers:
  lumai:
    name: lumai
    base_url: https://mrxapi.com/v1
    api_key: sk-你的实际密钥
    model: glm-5.2

model:
  provider: lumai
  model: glm-5.2

保存并退出。

可用模型

在 model 字段中，你可以替换为MRXAPI支持的任意模型名称。完整模型列表请前往 模型广场 查看。

验证配置

运行以下命令，测试是否配置成功：

复制hermes chat -q '你好，请用一句话回复' -Q

如果收到 AI 的回复，说明配置成功。

常见问题

报错 401 Unauthorized

API 密钥填写错误或已过期。请到MRXAPI后台确认密钥状态。

报错 404 Not Found

base_url 填写有误。Hermes 使用 OpenAI 协议，地址必须带 /v1 后缀：

复制https://mrxapi.com/v1    ✅ 正确
https://mrxapi.com       ❌ 错误