概述
hermes setup 是 Hermes Agent 的交互式配置向导。不带参数运行时，它会启动完整向导，以你当前的配置值作为默认值重新配置。你也可以传入某个配置区块的名称，只运行该区块。
用法
hermes setup [-h] [--non-interactive] [--reset] [--reconfigure] [--quick] [--portal]
[{model,tts,terminal,gateway,tools,telemetry,agent}]配置区块
只运行指定区块，而不是完整向导：
| 区块 | 配置内容 |
|---|---|
model |
默认模型、供应商和 API 凭据 |
tts |
语音合成（TTS）供应商和语音设置 |
terminal |
终端后端（local、docker、ssh、modal）和默认值 |
gateway |
消息平台（Telegram、Discord、Slack 等） |
tools |
默认启用的工具集 |
telemetry |
使用分析和遥测偏好 |
agent |
Agent 行为、最大轮数和会话默认值 |
hermes setup model
hermes setup gateway
hermes setup tools选项
| 选项 | 说明 |
|---|---|
--non-interactive |
非交互模式（使用默认值/环境变量） |
--reset |
将配置重置为默认值 |
--reconfigure |
（现有安装的默认行为。）重新运行完整向导，以当前值作为默认值。为向后兼容而保留 —— 现在直接运行 hermes setup 就会执行此操作。 |
--quick |
在现有安装上：只提示缺失或未设置的项目，而不是运行完整的重新配置向导 |
--portal |
一次性 Nous Portal 设置：通过 OAuth 登录、选择 Nous 模型、将 Nous 设为推理供应商，并选择启用 Tool Gateway。跳过向导的其余部分。 |
示例
# 运行完整向导（以当前配置值为默认值重新配置）
hermes setup
# 只配置模型区块
hermes setup model
# 配置消息网关
hermes setup gateway
# 将所有配置重置为默认值
hermes setup --reset
# 在现有安装上只提示缺失或未设置的项目
hermes setup --quick
# 一次性 Nous Portal OAuth 设置
hermes setup --portal
# 用于脚本/CI 的非交互式设置
hermes setup --non-interactive技巧
- 在现有安装上，直接运行
hermes setup会以当前配置值为默认值重新运行向导 —— 随时可以安全地重新运行。 - 使用
--quick只询问缺失或未设置的项目。 - 无头环境或脚本化设置请使用
--non-interactive，依赖默认值和环境变量。 - 设置完成后运行
hermes doctor验证配置是否完整可用。 - 只需修改单项时，
hermes config set key value比完整向导更快。