Hermes Agent - 大模型服务平台百炼

安装 Hermes Agent

在终端中执行以下命令安装 Hermes Agent，安装脚本会自动安装 Python、Git 等依赖。
```
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
```
说明
Windows 不支持原生安装，请先安装 WSL2，在 WSL2 中运行以上命令。

安装完成后，重新加载终端环境。

source ~/.bashrc    # 如果使用 zsh，改为 source ~/.zshrc

运行以下命令验证安装。若有版本号输出，则表示安装成功。
```
hermes --version
```

配置接入凭证

通过 hermes config set 命令配置接入参数，根据所选方案填入对应的 Base URL 和 API Key：

Coding Plan：固定月费订阅，按模型调用次数计量。
按量计费：按实际调用量后付费。

Coding Plan

将 YOUR_API_KEY 替换为 Coding Plan 专属 API Key。可用模型请参考 Coding Plan 支持的模型。

hermes config set model.provider custom
hermes config set model.base_url https://coding-intl.dashscope.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。也可以直接编辑该文件，写入以下内容：

config.yaml 配置示例

model:
  default: qwen3.6-plus
  provider: custom
  base_url: https://coding-intl.dashscope.aliyuncs.com/compatible-mode/v1
  api_key: YOUR_API_KEY

按量计费

将 YOUR_API_KEY 替换为阿里云百炼 API Key。可用模型请参考OpenAI 兼容 - 支持的模型。

base_url 按地域设置，API Key 需与所选地域对应：

华北2（北京）：https://dashscope.aliyuncs.com/compatible-mode/v1
新加坡：https://dashscope-intl.aliyuncs.com/compatible-mode/v1
美国（弗吉尼亚）：https://dashscope-us.aliyuncs.com/compatible-mode/v1

hermes config set model.provider custom
hermes config set model.base_url https://dashscope-intl.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。也可以直接编辑该文件，写入以下内容：

config.yaml 配置示例

model:
  default: qwen3.6-plus
  provider: custom
  base_url: https://dashscope-intl.aliyuncs.com/compatible-mode/v1
  api_key: YOUR_API_KEY

验证配置

配置完成后，执行以下命令发送一条测试消息：

hermes chat -q "你好"

如果返回正常的 AI 回复，则配置成功。如需切换模型，通过 -m 参数指定：

hermes chat -m qwen3.6-plus

常见问题

错误码

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

按量付费：Anthropic API 兼容 - 错误码
Coding Plan：Coding Plan 常见问题

配置后仍连接到 OpenRouter

Hermes Agent 默认使用 OpenRouter 作为推理提供商。接入阿里云百炼时，model.provider 必须设置为 custom。请执行以下命令确认：

hermes config set model.provider custom