Hermes Agent 接入 LongCat-2.0 配置（官方文档 + Nous Portal 免费入口）

一句话结论

两条命令就能把 Hermes Agent（Nous Research 的开源终端 Agent）接到 LongCat-2.0，且官方在 Nous Portal 上提供免费一周试用，适合零成本体验 1M 上下文的长期 Agent 工作。

适用场景

• 适合的任务：用 Hermes Agent 跑自动化任务、终端交互、跨会话持久记忆的 Agent；把 LongCat-2.0 作为免费/低成本后端做长期项目

• 不适合的任务：不需要 Agent 框架的单轮对话（直接用官网聊天或 API）；Windows 原生环境（Hermes 需 WSL2）

• 适用的模型版本：LongCat-2.0（API 平台当前唯一在售模型）

• 适用的客户端、Agent 或 API：Hermes Agent（Linux / macOS / WSL2）；Nous Portal（免费额度入口，绑定 OpenRouter 渠道）

• 推荐的推理档位和参数：model.provider 必须设为 custom；base_url 指向 OpenAI 兼容端点；注意 Hermes 的 reasoning effort 只支持 low/med/high（见测评目录 06 的 Bug 报告）

可直接使用的内容

1. 安装 Hermes Agent

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc   # 或 source ~/.zshrc
hermes --version   # 输出版本号即安装成功

2. 配置 LongCat（方式 A：命令行）

hermes config set model.provider custom
hermes config set model.base_url https://api.longcat.chat/openai/v1
hermes config set model.api_key <Your LongCat API Key>
hermes config set model.default LongCat-2.0

3. 配置 LongCat（方式 B：直接编辑 ~/.hermes/config.yaml）

model:
  provider: custom
  base_url: https://api.longcat.chat/openai/v1
  api_key: <Your LongCat API Key>
  default: LongCat-2.0

4. 验证并启动

hermes doctor        # 检查配置
hermes               # 经典 CLI 模式
hermes --tui         # 现代 TUI 模式

5. Nous Portal 免费入口（官方公告）

• 2026-08-13 Nous Research 公告：LongCat-2.0 在 Nous Portal 免费使用一周，入口 https://portal.nousresearch.com。

• Nous Portal 模型目录（2026-08-18 采集）同时提供两个条目：

  • Meituan: LongCat 2.0 — IN $0.24 / OUT $0.96 per 1M（OpenRouter 付费版，模型 ID meituan/longcat-2.0-20260720）

  • Meituan: LongCat 2.0 — $0.00/1M（OpenRouter 免费版，模型 ID meituan/longcat-2.0:free）

• 免费周已结束（一周试用），但 OpenRouter 的 :free 端点在采集日仍为 $0.00。

原始数据与复核说明

• 配置命令与 config.yaml 内容逐字抄录自官方文档（2026-08-18 采集）。

• Nous Portal 免费入口同时得到 @NousResearch 与 @Meituan_LongCat 两条官方推文确认（推文 ID 见上文）。

• r/hermesagent 用户实测（2026-07 底）确认该配置链路可用，并报告了一个兼容性 Bug：Hermes 的 reasoning effort 若设为 LongCat 不接受的档位（如 xhigh），LongCat 会返回畸形 200 响应导致 Hermes 回退到 fallback provider；官方已确认该问题（详见测评目录 06）。

适用边界

• 免费入口的额度、有效时间与速率以 Nous Portal / OpenRouter 实时页面为准；本采集日的 $0.00 不代表长期免费。

• 官方直连（api.longcat.chat）与 Nous Portal/OpenRouter 渠道的模型行为（如缓存计费、思考模式默认值）可能不完全一致。

• Hermes 的 reasoning effort 与 LongCat 的 thinking 参数是两个独立概念，混用时注意上述 Bug。