windows安装管理

安装升级

git config --global core.autocrlf false
iex "& { $(irm https://hermes-agent.nousresearch.com/install.ps1) } -Tag v2026.7.7.2"
git config --global core.autocrlf true

# 完全重装：Remove-Item -Recurse -Force $env:LOCALAPPDATA\hermes

-Tag v2026.7.7.2              • 作用: 指定 release 版本，支持无损升级, 会重建venv python略慢，不如hermes update快
-Branch main                  • 作用: 指定分支（Tag 更高优先级，不设 Tag 时生效）
-Commit abc123                • 作用: 指定 commit SHA（优先级最高）
-HermesHome D:\hermes         • 作用: 数据目录（默认 %LOCALAPPDATA%\hermes）
-InstallDir D:\hermes\hermes-agent • 作用: 源码目录（默认 $HermesHome\hermes-agent）
-NonInteractive               • 作用: 跳过所有交互提示
-SkipSetup                    • 作用: 跳过 setup 配置向导
-NoVenv                       • 作用: 不创建 venv（已有系统 Python 时用）
-IncludeDesktop               • 作用: 同时构建桌面版 Hermes.exe

程序管理

启动 / 运行参数（仅本次生效，不写配置文件）

Gateway（后台消息服务）

• gateway随机启动后，需要在.env加入一些变量开关才能自带dashboard等

其他操作

.env 文件

位置：$HermesHome\.env（hermes config env-path 查看）。格式 KEY=value，编辑或命令改动后必须重启 gateway 才生效。

① 直接编写：可以手动写入的 KEY

② 命令改动：以下命令会写 .env

config.yaml 配置

位置：hermes config path 查看。核心 YAML 结构如下。编辑或命令改动后必须重启 gateway 或重开 CLI 才生效。

① 直接编写：关键配置块说明

# ── 模型 / 提供商 ──
model:
  default: deepseek-v4-flash   # 默认模型
  provider: opencode-go        # 默认提供商

# ── 代理行为 ──
agent:
  disabled_toolsets: [browser] # 禁用的工具集（web / browser / 等）
  max_turns: 90                # 单轮最多工具调次数
  gateway_timeout: 1800        # gateway 超时

# ── 权限审批 ──
approvals:
  mode: smart                  # manual / smart / off
  cron_mode: allow

# ── MCP 服务器 ──
mcp_servers:
  trilium:
    command: node
    args: [mcp-server.js]
    url: ""                    # 二选一：command 或 url

# ── 代理（HTTP/S 出站） ──
proxy: http://127.0.0.1:7890  # Hermes 自身 LLM API / MCP 调用的代理

# ── Session 自动重置 ──
session_reset:
  mode: none                   # none / idle / scheduled / both
  idle_minutes: 0
  at_hour: 4

② 命令改动：以下命令会改 config.yaml

查看类命令（不改文件）

Skills & MCP 管理

Session 管理

Profile 管理