适用版本：Hermes Agent v0.13.0+
更新日期：2026年5月13日
适用场景：Windows WSL + Ubuntu 26.04 环境
一、新增 LongCat 模型完整命令流程
按顺序执行以下命令，1 分钟完成配置。
1. 编辑密钥文件（最关键！变量名不能错）
nano~/.hermes/.env必须添加以下内容（变量名必须是OPENAI_API_KEY，不能是LONGCAT_API_KEY）：
# 阿里云通义千问（原有保留） DASHSCOPE_API_KEY=sk-你的阿里云密钥 DASHSCOPE_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1 # LongCat 模型（新增） OPENAI_API_KEY=你的longcat密钥按Ctrl+O保存 →Ctrl+X退出。
2. 编辑主配置文件
nano~/.hermes/config.yaml全选原有内容，粘贴以下双模型自动故障转移配置：
model:# 一键切换：只改这2行default:LongCat-模型名称provider:openaiproviders:# 模型1：阿里云通义千问alibaba:{}# 模型2：LongCat（OpenAI兼容接口）openai:base_url:https://api.longcat.chat/openai/v1# 唯一正确路径# 自动故障转移：LongCat失败自动切到阿里云fallback_providers:-alibabacredential_pool_strategies:{}toolsets:-hermes-cliagent:max_turns:90gateway_timeout:1800restart_drain_timeout:180api_max_retries:5# 增加重试次数service_tier:''tool_use_enforcement:autogateway_timeout_warning:900gateway_notify_interval:180gateway_auto_continue_freshness:3600image_input_mode:autodisabled_toolsets:[]retry_backoff_factor:2# 指数退避重试retry_jitter:trueterminal:backend:localmodal_mode:autocwd:.timeout:180env_passthrough:[]shell_init_files:[]auto_source_bashrc:truedocker_image:nikolaik/python-nodejs:python3.11-nodejs20docker_forward_env:[]docker_env:{}singularity_image:docker://nikolaik/python-nodejs:python3.11-nodejs20modal_image:nikolaik/python-nodejs:python3.11-nodejs20daytona_image:nikolaik/python-nodejs:python3.11-nodejs20vercel_runtime:node24container_cpu:1container_memory:512container_disk:51200container_persistent:truedocker_volumes:[]docker_mount_cwd_to_workspace:falsedocker_run_as_host_user:falsepersistent_shell:true按Ctrl+O保存 →Ctrl+X退出。
3. 重启 Hermes 验证
hermes chat发送消息：
你现在使用的是什么模型？正常回复即配置成功。
二、多模型一键切换方法
1. 手动切换（10秒完成）
只需要修改config.yaml前 2 行，其他所有内容都不用动：
| 切换到哪个模型 | 修改为 |
|---|---|
| LongCat | ```yaml |
| model: | |
| default: LongCat-Flash-Thinking-2601 | |
| provider: openai |
| **阿里云通义千问** | ```yaml model: default: qwen3.6-plus provider: alibaba ```| 修改保存后，**重启 Hermes 立即生效**。 --- ### 2. 自动故障转移（推荐） 上面的配置已经开启了自动故障转移： - **优先使用 LongCat 模型** - 当 LongCat 遇到 429限流、404、500服务器错误时 - **Hermes 会自动切换到阿里云通义千问**，不需要任何手动操作 - 完全不影响使用体验 --- ## 三、所有踩过的坑避坑清单 | 错误类型 | 原因 | 解决方法 | |:---|:---|:---| | **404 Not Found** | 接口路径错误 | 必须用 `https://api.longcat.chat/openai/v1` | | **401 密钥错误** | 环境变量名写错 | `.env` 里必须是 `OPENAI_API_KEY`，不能是 `LONGCAT_API_KEY` | | **.venv 不存在** | 虚拟环境路径问题 | 使用 `source hermes-agent/bin/activate` 激活后再执行命令 | | **hermes 命令不存在** | 未在虚拟环境中 | 先 `cd ~/ai/hermes/hermes-agent-main` 再 `source hermes-agent/bin/activate` | | **API Key 为空** | 变量引用格式错误 | 使用 `${OPENAI_API_KEY}` 格式引用 | | **限流后卡死** | 未配置故障转移 | 在 `fallback_providers` 中添加 `alibaba` | --- ## 四、LongCat 模型可选列表 | 模型名称 | 说明 | 上下文长度 | |:---|:---|:---| | `LongCat-Flash-Thinking-2601` | 深度思考模型（推荐） | 256K | | `LongCat-Flash-Chat` | 高性能通用对话模型 | 256K | | `LongCat-Flash-Lite` | 轻量化 MoE 模型 | 256K | | `LongCat-2.0-Preview` | 高性能 Agentic 模型 | 1M | --- ## 五、验证配置是否正确 配置完成后，可以发送以下消息测试：你好，请介绍一下自己，并告诉我你使用的是什么模型。
正常回复模型名称即为配置成功。 --- > **项目地址**：https://github.com/NousResearch/hermes-agent > > **LongCat API 平台**：https://longcat.chat/platform --- **如果本文对你有帮助，欢迎点赞、收藏！**
