Hermes Agent CLI 用法：安装、模型切换与网关命令

核对日期：2026 年 9 月 24 日。本文面向自建 Hermes Agent，命令以当前上游文档和 CLI 源码为准。上游主分支可能领先于你安装的版本；遇到参数不支持，先查看该子命令的 --help。

安装与首次配置

Linux、macOS 和 Windows 的 WSL2 环境可使用上游安装脚本。以下是官方安装入口；完整环境准备见中文安装教程。

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

# 安装完成后，按提示重新打开终端
hermes --version
hermes --help
hermes setup
hermes

Windows 原生 PowerShell 使用官方提供的 install.ps1 安装入口，具体步骤见上游安装说明。不要根据同名 npm 包推断 Hermes Agent 的安装命令。

常用命令速查

终端聊天与脚本调用

直接运行 hermes 即可对话。需要指定初始问题时，用 hermes chat -q。当前上游在交互式终端中会继续保留会话；希望回答后退出，显式加 --oneshot。

# 回答一次后退出
hermes chat -q "用三句话解释什么是 AI Agent" --oneshot

# 脚本调用：减少界面输出并退出
hermes chat -q "把 hello 翻译成中文" -Q

# 恢复最近的会话
hermes --continue

# 查看当前版本的聊天参数
hermes chat --help

-Q 会抑制横幅、动画和工具预览；它不等于 JSON 输出。模型调用仍可能产生费用。命令在当前用户和配置环境中启动会话，不会因为本机装了 CLI 就自动连接到某个远程托管实例。

切换模型：hermes model 与 /model

添加供应商、填写 API Key、进行 OAuth 授权或设置默认模型时，先退出聊天，再在系统终端运行：

hermes model
hermes config get model.provider
hermes config get model.default

如果供应商已配置好，只想在正在进行的对话里换模型，在 Hermes 输入框中输入 /model。它默认只更改当前会话；需要持久保存时，按当前版本的提示使用 --global。它不能代替终端中的供应商登录向导。

默认配置文件是 ~/.hermes/config.yaml，模型字段为 model.provider 与 model.default。通过 OpenRouter 使用模型时，模型 ID 遵循 OpenRouter 的目录格式，不要额外套用 OpenClaw 的 openrouter/ 前缀。更换默认模型后，新会话使用新默认值；已有会话应检查自己的选择。

消息网关：配置、启动与重启

终端聊天与消息网关是不同入口。连接 Telegram、Discord 等平台，先运行 hermes gateway setup。平台所需的 Token、权限和配对步骤不同，按向导及对应渠道文档完成。

前台运行

hermes gateway setup
hermes gateway run

前台模式适合观察启动输出，上游也推荐 WSL 等环境使用它。不要在已有服务管理同一个实例时再启动第二个网关。Docker 镜像可能自带进程管理器，应遵循该镜像的启动方式。

Linux 或 macOS 后台服务

需要 systemd 或 launchd 管理后台进程时，先安装服务，再启动；以下命令用于支持这些服务的自建环境：

hermes gateway install
hermes gateway start
hermes gateway status

# 重启已运行的网关
hermes gateway restart
hermes gateway status

# 停止网关
hermes gateway stop

重启命令是 hermes gateway restart，不是 hermes restart。网关重启与更新软件是两件事，也不需要为了切换当前聊天模型而反复重启。详细行为见上游 gateway 命令参考。

配置与日志：先定位，再修改

hermes config path
hermes config show
hermes config check
hermes doctor

# 网关日志与近期错误
hermes logs gateway -f
hermes logs errors --since 30m

编辑配置可用 hermes config edit；单项修改使用 hermes config set KEY VALUE，其中 KEY 必须是当前版本支持的字段。不要假定所有配置修改都会热加载。分享日志或配置前，删除密钥、聊天内容和个人信息。

如果 CLI 中的设置没有影响消息机器人，先确认两者是否使用相同的系统用户、HERMES_HOME 与 profile。当前 CLI 读取的路径可由 hermes config path 确认，网关还需检查其服务配置。多套配置的用法见Profiles 指南。

插件、Skills 与 Docker 中的 CLI

插件和 Skills 各有自己的子命令。先查看帮助和插件列表，再按来源说明安装；安装、启用与实际加载是不同步骤。具体流程见插件中文教程。

hermes plugins --help
hermes plugins list
hermes skills --help

自建 Docker 实例且镜像内提供 hermes 命令时，可以进入容器执行 CLI。将 CONTAINER_NAME 替换为实际容器名，并使用该实例运行 Hermes 的用户和配置环境：

docker exec -it CONTAINER_NAME hermes --help
docker exec -it CONTAINER_NAME hermes model

OpenClaw Launch 托管用户应通过仪表盘提供的模型、集成与重启入口管理实例。这里的自建服务安装命令不代表托管容器允许安装 systemd 服务，也不要在托管容器里另开一套网关。

常见报错怎么查？

• 找不到 hermes：重新打开终端，检查安装脚本的 PATH 提示。在 Linux、macOS 或 WSL 中可用 command -v hermes 确认可执行文件位置。
• 子命令或参数不存在：运行 hermes --version 与对应的 --help，对照安装版本。不要把其他智能体的命令套到 Hermes 上。
• 模型列表不完整：退出会话，用 hermes model 配置缺少的供应商，再回到聊天中切换。
• gateway start 失败：检查是否安装后台服务、系统是否支持相应服务管理器；WSL 可按上游建议选择前台运行方式。
• 网关在运行但平台不回复：先检查 hermes status 和网关日志，再核对平台凭据、授权与当前配置目录。

官方参考资料

• Hermes Agent 上游仓库与安装说明
• CLI 命令参考：model、gateway、config 与 logs
• 终端交互界面使用说明
• CLI 子命令解析源码

常见问题

相关阅读

• Hermes Agent 安装教程
• Hermes 插件安装与排错
• Hermes Profiles 配置隔离
• Hermes 连接 Telegram
• Hermes 中文文档导航