Hermes 中文指南

第一次对话

从选模型到验证 Hermes 能正常回复并恢复会话

入门15 分钟官方文档
本文内容译自 Nous Research 官方文档,技术细节以英文原文为准。对照官方文档

原则:先跑通对话

在添加网关、cron、MCP 之前,先完成一轮正常对话。若基础聊天不通,不要继续堆功能。

1. 选择 Provider

终端
hermes model

交互式向导会引导你完成 OAuth 或 API Key 配置。国内常用选项包括:

  • OpenRouter — 多模型聚合
  • 通义 DashScope — 设置 DASHSCOPE_API_KEY
  • DeepSeek — 设置 DEEPSEEK_API_KEY
  • Kimi / Moonshot — 设置 KIMI_API_KEY

2. 启动对话

终端
hermes            # 经典 CLI
hermes --tui      # 现代 TUI(推荐)

用容易验证的提示词试一轮,例如:

总结当前目录下项目结构,并指出可能的入口文件。

成功标志:

  • 横幅显示已选模型
  • 能正常回复且无报错
  • 需要时可调用终端、读文件等工具
  • 多轮对话连贯

3. 验证会话恢复

终端
hermes --continue

应回到刚才的会话。若失败,检查是否切换了 profile,或运行 hermes sessions list

4. 试试基础能力

能力示例
终端「查看磁盘占用最高的 5 个目录」
斜杠命令输入 / 查看 /help/tools/model
中断任务过长时直接输入新消息并回车

常见问题

现象处理
空回复或报错重新 hermes model,核对 Provider 与 Key
自定义端点异常先用独立客户端验证 URL 与模型名
--continue 无效hermes sessions list,确认 profile 一致