Hermes + 阿里 DashScope 配置指南

本文档介绍如何将 Hermes Agent 配置使用阿里云 DashScope通义千问作为推理后端包括 Credential Pool凭证池多 Key 轮询配置。目录环境要求配置步骤Credential Pool 多 Key 配置Coding Plan 配置国内版 vs 国际版常用模型列表使用方法故障排查环境要求Hermes Agent 已安装位于~/.hermes/hermes-agent/Python 3.11阿里云 DashScope API Key可在 阿里云 DashScope 控制台 获取配置步骤Step 1: 配置环境变量编辑~/.hermes/.env文件如果不存在从.env.example复制# 阿里 DashScope API Key国内版DASHSCOPE_API_KEYsk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxDASHSCOPE_BASE_URLhttps://dashscope.aliyuncs.com/compatible-mode/v1# Coding Plan API Key可选用于 coder 模型ALIBABA_CODING_PLAN_API_KEYsk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxALIBABA_CODING_PLAN_BASE_URLhttps://coding.dashscope.aliyuncs.com/v1注意:.env文件权限应设为600仅 owner 可读chmod600~/.hermes/.envStep 2: 配置 config.yaml编辑~/.hermes/config.yamlmodel:qwen-plus# 默认模型providers:alibaba:api_key_env:DASHSCOPE_API_KEYbase_url:https://dashscope.aliyuncs.com/compatible-mode/v1credential_pool_strategies:alibaba:round_robin# 多 Key 轮询策略Step 3: 验证配置hermes config check输出应显示✓ DASHSCOPE_API_KEY ✓ DASHSCOPE_BASE_URLCredential Pool 多 Key 配置Hermes 支持Credential Pool凭证池可以为同一个 Provider 配置多个 API Key实现轮询使用round_robin- 依次使用各个 Key故障转移failover- 主 Key 失败时切换到备用 Key负载均衡- 分散请求避免单 Key 限流添加多个 Key# 添加第一个 Keyhermes authaddalibaba--typeapi-key --api-keysk-xxxx1--labeldashscope-key-1# 添加第二个 Keyhermes authaddalibaba--typeapi-key --api-keysk-xxxx2--labeldashscope-key-2# 添加更多 Key...hermes authaddalibaba--typeapi-key --api-keysk-xxxx3--labeldashscope-key-3查看已添加的 Credentialshermes auth list输出alibaba (3 credentials): #1 dashscope-key-1 api_key manual ← #2 dashscope-key-2 api_key manual #3 dashscope-key-3 api_key manual配置轮询策略在~/.hermes/config.yaml中设置credential_pool_strategies:alibaba:round_robin# 或 failoverCoding Plan 配置阿里云 Coding Plan 提供专门的代码生成模型如qwen3-coder-plus适合编程场景。配置方法# 添加 Coding Plan Keyhermes authaddalibaba-coding-plan--typeapi-key --api-keysk-xxxx--labelcoding-plan-key使用 Coding 模型hermes chat-q写一个 Python 快速排序函数-mqwen3-coder-plus国内版 vs 国际版版本API Endpoint适用场景国内版dashscope.aliyuncs.com国内用户无需代理国际版dashscope-intl.aliyuncs.com海外用户需要国际版 Key注意: 国内版和国际版的 API Key不互通请根据你的 Key 类型选择正确的 endpoint。国内版配置DASHSCOPE_BASE_URLhttps://dashscope.aliyuncs.com/compatible-mode/v1ALIBABA_CODING_PLAN_BASE_URLhttps://coding.dashscope.aliyuncs.com/v1国际版配置DASHSCOPE_BASE_URLhttps://dashscope-intl.aliyuncs.com/compatible-mode/v1ALIBABA_CODING_PLAN_BASE_URLhttps://coding-intl.dashscope.aliyuncs.com/v1常用模型列表通用对话模型模型 ID说明qwen-turbo快速响应成本低qwen-plus平衡性能与成本推荐qwen-max最强通用模型qwen3-maxQwen3 系列最强qwen3.5-plusQwen3.5 平衡版qwen3.7-maxQwen3.7 最新旗舰代码生成模型模型 ID说明qwen-coder-plus代码生成优化qwen-coder-turbo快速代码生成qwen3-coder-plusQwen3 代码版qwen3-coder-nextQwen3 代码版 Next推理模型模型 ID说明qwq-plus推理增强版deepseek-r1DeepSeek 推理模型deepseek-v3DeepSeek V3其他模型DashScope 还提供视觉模型:qwen-vl-max,qwen-vl-plus数学模型:qwen-math-plus,qwen-math-turbo语音模型:qwen-tts-*,qwen3-tts-*第三方模型:glm-5,kimi-k2.5,MiniMax-M2.5使用方法交互式聊天hermes chat单次查询hermes chat-q解释什么是递归-mqwen-plus指定模型hermes chat-mqwen3-coder-plus-q写一个 React 组件切换默认模型交互式hermes model静默模式适合脚本调用hermes chat-q你的问题-Q故障排查问题: “No inference provider configured”原因:.env文件未正确配置或位置不对解决方案:# 确保 .env 在正确位置cp~/.hermes/hermes-agent/.env ~/.hermes/.envchmod600~/.hermes/.env# 验证配置hermes config check问题: API Key 认证失败 (401)原因: Key 类型与 endpoint 不匹配国内版 Key 用了国际版 endpoint解决方案:检查你的 Key 是国内版还是国际版设置正确的DASHSCOPE_BASE_URL。问题: 模型不可用原因: 模型名称错误或该模型需要特定 Key解决方案:# 查看可用模型curl-HAuthorization: Bearer sk-xxxx\https://dashscope.aliyuncs.com/compatible-mode/v1/models查看 Credential Pool 状态hermes auth status alibaba配置文件示例~/.hermes/.env# 阿里 DashScope国内版DASHSCOPE_API_KEYsk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxDASHSCOPE_BASE_URLhttps://dashscope.aliyuncs.com/compatible-mode/v1# Coding PlanALIBABA_CODING_PLAN_API_KEYsk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxALIBABA_CODING_PLAN_BASE_URLhttps://coding.dashscope.aliyuncs.com/v1~/.hermes/config.yaml关键配置model:qwen-plusproviders:alibaba:api_key_env:DASHSCOPE_API_KEYbase_url:https://dashscope.aliyuncs.com/compatible-mode/v1credential_pool_strategies:alibaba:round_robinterminal:backend:localcwd:.timeout:180相关链接Hermes Agent GitHub阿里云 DashScope 控制台DashScope API 文档提示: Credential Pool 功能让你的 API Key 使用更加灵活当某个 Key 达到限额时会自动切换提高服务的可用性。