Hermes Agent第三方模型接入

更新时间:
复制为 MD 格式

Hermes Agent 默认使用阿里云百炼 Coding Plan 模型,如需接入其他厂商的模型套餐,可按本文方式配置。本文以百炼 Token Plan 团队版、MiniMax Token Plan、火山引擎 Agent Plan、腾讯 Token Plan 四种接入方式为例进行说明。

各供应商接入步骤

百炼 Token Plan 团队版

  1. 免密登录终端:登录 轻量应用服务器控制台,找到目标服务器卡片,单击远程连接,在Workbench 一键连接区域单击立即登录

  2. 请确保账号已订阅 Token Plan 团队版 套餐,并获取专属 API Key。

  3. 配置接入凭证:在终端依次执行以下命令(将 YOUR_API_KEY 替换为 Token Plan 团队版的 API Key):

    hermes config set model.provider custom
    hermes config set model.base_url https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
    hermes config set model.api_key YOUR_API_KEY
    hermes config set model.default qwen3.6-plus

    以上命令将配置写入 ~/.hermes/config.yaml。也可以直接编辑该文件,写入以下内容:

    model:
      default: qwen3.6-plus
      provider: custom
      base_url: https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
      api_key: YOUR_API_KEY
  4. 验证配置:配置完成后,执行以下命令发送一条测试消息:

    hermes chat -q "你好"

    如果返回正常的回复,则配置成功。

  5. 切换模型:如需切换模型,可通过 -m 参数指定:

    hermes chat -m deepseek-v4-pro

Token Plan 团队版支持的模型

模型名称

模型厂商

qwen3.6-plus

通义千问

qwen3.6-flash

通义千问

deepseek-v4-pro

DeepSeek

deepseek-v4-flash

DeepSeek

deepseek-v3.2

DeepSeek

kimi-k2.6

Moonshot

kimi-k2.5

Moonshot

glm-5.1

智谱

glm-5

智谱

MiniMax-M2.5

MiniMax

MiniMax Token Plan

  1. 免密登录终端:登录 轻量应用服务器控制台,找到目标服务器卡片,单击远程连接,在Workbench 一键连接区域单击立即登录

  2. 请确保账号已订阅 MiniMax Token Plan 套餐,并获取 API Key。

  3. 配置模型:在终端执行以下命令启动模型配置向导。

    hermes model

    在交互式配置中,依次按照以下步骤选择:

    Select model provider  → MiniMax China (mainland China endpoint)
    Enter API Key          → 粘贴上一步获取的 MiniMax Token Plan API Key
    Default model          → MiniMax-M2.7
    说明

    海外用户请选择 MiniMax Global 端点。

  4. 验证配置:配置完成后,执行以下命令验证连接状态。

    hermes doctor
  5. 启动 Hermes Agent:验证通过后,在终端执行以下命令启动 Hermes Agent。

    hermes

火山引擎 Agent Plan

  1. 免密登录终端:登录 轻量应用服务器控制台,找到目标服务器卡片,单击远程连接,在Workbench 一键连接区域单击立即登录

  2. 请确保账号已订阅方舟 Agent Plan 套餐,并前往火山引擎控制台获取 API Key。

  3. 配置接入凭证:在终端依次执行以下命令(将 YOUR_ARK_API_KEY 替换为上一步获取的 API Key):

    警告

    请勿使用 https://ark.cn-beijing.volces.com/api/v3 作为 Base URL,该地址不会消耗 Agent Plan 额度,而是会产生额外费用。

    hermes config set model.provider custom
    hermes config set model.base_url https://ark.cn-beijing.volces.com/api/plan/v3
    hermes config set model.api_key YOUR_ARK_API_KEY
    hermes config set model.default doubao-seed-2.0-pro

    以上命令将配置写入 ~/.hermes/config.yaml。也可以直接编辑该文件,写入以下内容:

    model:
      default: doubao-seed-2.0-pro
      provider: custom
      base_url: https://ark.cn-beijing.volces.com/api/plan/v3
      api_key: YOUR_ARK_API_KEY
  4. 验证配置:配置完成后,执行以下命令发送一条测试消息:

    hermes chat -q "你好"

    如果返回正常的回复,则配置成功。

  5. 切换模型:如需切换模型,可通过 -m 参数指定:

    hermes chat -m glm-5.1

Agent Plan 支持的模型

模型名称

模型厂商

ark-code-latest

火山引擎

doubao-seed-2.0-code

字节跳动

doubao-seed-2.0-pro

字节跳动

doubao-seed-2.0-lite

字节跳动

doubao-seed-2.0-mini

字节跳动

glm-5.1

智谱

deepseek-v3.2

DeepSeek

minimax-2.7

MiniMax

kimi-k2.6

Moonshot

腾讯 Token Plan

  1. 免密登录终端:登录 轻量应用服务器控制台,找到目标服务器卡片,单击远程连接,在Workbench 一键连接区域单击立即登录

  2. 请确保账号已订阅腾讯云 Token Plan 套餐,并在 TokenHub 控制台生成 API Key(格式为 sk-tp-xxx)。

  3. 配置接入凭证:在终端依次执行以下命令(将 YOUR_API_KEY 替换为上一步获取的 API Key):

    说明

    配置 Model ID 时必须使用全小写格式。

    hermes config set model.provider custom
    hermes config set model.base_url https://api.lkeap.cloud.tencent.com/plan/v3
    hermes config set model.api_key YOUR_API_KEY
    hermes config set model.default hunyuan-2.0-thinking

    以上命令将配置写入 ~/.hermes/config.yaml。也可以直接编辑该文件,写入以下内容:

    model:
      default: hunyuan-2.0-thinking
      provider: custom
      base_url: https://api.lkeap.cloud.tencent.com/plan/v3
      api_key: YOUR_API_KEY
  4. 验证配置:配置完成后,执行以下命令发送一条测试消息:

    hermes chat -q "你好"

    如果返回正常的回复,则配置成功。

  5. 切换模型:如需切换模型,可通过 -m 参数指定:

    hermes chat -m kimi-k2.5

Token Plan 支持的模型

模型名称

模型厂商

tc-code-latest

腾讯

hunyuan-2.0-instruct

腾讯

hunyuan-2.0-thinking

腾讯

hunyuan-t1

腾讯

hunyuan-turbos

腾讯

minimax-m2.5

MiniMax

kimi-k2.5

Moonshot

glm-5

智谱