Hermes Agent

更新时间:
复制 MD 格式

在 Hermes Agent 中使用阿里云百炼模型。

快速接入

选择你使用的客户端,完成配置。

CLI

  1. 1

    获取 API Key

  2. 2

    配置模型

    运行 hermes model,按计费方案选择 provider,输入 API Key 并选择模型。

    Token Plan

    1. 选择 Qwen > Alibaba Cloud (Token Plan, China)。
    2. 输入 Token Plan API Key,Base URL 保持默认。
    3. 选择模型。支持的模型见个人版支持的模型和团队版支持的模型。

    按量计费

    1. 选择 Qwen > Alibaba Cloud DashScope (China)。
    2. 输入百炼 API Key。
    3. 以下以华北2(北京)为例,Base URL 填写 https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1,将 {WorkspaceId} 替换为真实的 Workspace ID。
    4. 选择模型。支持的模型见支持的模型。

    Coding Plan

    1. 选择 Qwen > Alibaba Cloud (Coding Plan, China)。
    2. 输入 Coding Plan 专属 API Key,Base URL 保持默认。
    3. 选择模型。支持的模型见 Coding Plan 支持的模型。

    说明provider 列表中的模型可能多于当前套餐支持的模型,实际可用模型以套餐支持列表为准。

  3. 3

    验证

    运行以下命令验证:

    hermes chat -q "你好"
    

桌面版

  1. 1

    配置模型

    按通过配置文件接入写入对应方案的配置,或先在 CLI 中完成配置。

  2. 2

    选择模型

    打开 Hermes Desktop,进入 Settings → Model,选择同名 provider 和模型。

通过配置文件接入

hermes model 的 provider 列表从 v2026.8.31 起包含阿里云百炼。列表中没有时,按以下步骤接入。

  1. 1

    打开或新建配置文件

    • macOS / Linux / WSL2:~/.hermes/config.yaml
    • Windows:%LOCALAPPDATA%\hermes\config.yaml
  2. 2

    写入配置

    将 YOUR_API_KEY 替换为对应方案的 API Key;按量计费还需将 {WorkspaceId} 替换为实际值。将配置写入 model 部分。

    Token Plan

    OpenAI 兼容协议

    model:
      default: auto
      provider: custom
      base_url: https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
      api_key: YOUR_API_KEY
    

    Anthropic 兼容协议

    model:
      default: auto
      provider: custom
      base_url: https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic
      api_mode: anthropic_messages
      api_key: YOUR_API_KEY
    

    按量计费

    以下示例使用华北2(北京)。

    OpenAI 兼容协议

    model:
      default: qwen3.8-max
      provider: custom
      base_url: https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
      api_key: YOUR_API_KEY
    

    Anthropic 兼容协议

    model:
      default: qwen3.8-max
      provider: custom
      base_url: https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic
      api_mode: anthropic_messages
      api_key: YOUR_API_KEY
    

    Coding Plan

    OpenAI 兼容协议

    model:
      default: qwen3.7-plus
      provider: custom
      base_url: https://coding.dashscope.aliyuncs.com/v1
      api_key: YOUR_API_KEY
    

    Anthropic 兼容协议

    model:
      default: qwen3.7-plus
      provider: custom
      base_url: https://coding.dashscope.aliyuncs.com/apps/anthropic
      api_mode: anthropic_messages
      api_key: YOUR_API_KEY
    

    说明使用 qwen4-max-preview 时,provider 必须保持 custom,不要设为 anthropic,否则模型名会被改写并返回 400。

    说明使用 qwen4-max 时,provider 必须保持 custom,不要设为 anthropic,否则模型名会被改写并返回 400。qwen4-max 的上下文长度为 1M Token;非思考模式最大输出 131,072 Token,思考与最终回答合计最大 262,144 Token;默认 reasoning_effort=high,thinking_budget=131072。

  3. 3

    验证

    保存后运行 hermes chat -q "你好" 验证。

错误码

配置过程中遇到报错,参考对应计费方案的常见问题文档:

常见问题

hermes model 中没有阿里云百炼

模型不可用

hermes model 的模型列表可能包含当前套餐不支持的模型。按对应套餐的支持列表选择,或选择 Enter custom model name 后输入模型 ID。

节省计划和资源包如何接入

节省计划和资源包的接入方式同按量计费,会自动抵扣符合条件的调用费用。抵扣规则见节省计划与资源包。