跳转到主要内容
接入AI工具

Hermes Agent

在 Hermes Agent 中使用千问AI平台模型

使用 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。

快速接入

选择你使用的客户端,完成配置。
  • CLI
  • 桌面版
1

获取 API Key

2

配置模型

运行 hermes model,按计费方案选择 provider,输入 API Key 并选择模型。
  • Token Plan
  • 按量计费
  1. 选择 Qwen > Alibaba Cloud (Token Plan, China)。
  2. 输入 Token Plan API Key,Base URL 保持默认。
  3. 选择模型。支持的模型见个人版支持的模型和团队版支持的模型。
provider 列表中的模型可能多于当前套餐支持的模型,实际可用模型以套餐支持列表为准。
3

验证

运行以下命令验证:
hermes chat -q "你好"

通过配置文件接入

hermes model 的 provider 列表从 v2026.8.31 起包含千问AI平台。列表中没有时,按以下步骤接入。
1

打开或新建配置文件

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

写入配置

将 YOUR_API_KEY 替换为对应方案的 API Key。将配置写入 model 部分。
  • Token Plan
  • 按量计费
OpenAI 兼容协议
model:
  default: auto
  provider: custom
  base_url: https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1
  api_key: YOUR_API_KEY
Anthropic 兼容协议
model:
  default: auto
  provider: custom
  base_url: https://token-plan.maas.qianwenaiapi.com/apps/anthropic
  api_mode: anthropic_messages
  api_key: YOUR_API_KEY
3

验证

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

错误码

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

常见问题

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