windows部署手册

安装升级

脚本升级

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

# 完全重装：Remove-Item -Recurse -Force $env:LOCALAPPDATA\hermes
# 干扰的包卸载：pip uninstall hermes-cli hermes-agent gateway -y

-NonInteractive               • 作用: 跳过所有交互提示
-SkipSetup                    • 作用: 跳过 setup 配置向导
-NoVenv                       • 作用: 不创建 venv（已有系统 Python 时用）
-IncludeDesktop               • 作用: 同时构建桌面版 Hermes.exe

命令升级
```
hermes update
```
kanban界面点击升级

issue

# update报错：UV锁问题和解决 -> 最后怎么解决的搞不清楚很混乱

# update报错：Failed to fetch updates from origin -> 进hermes\hermes-agent，修复.git执行，git gc --prune=now，再次update即可

# update报错：Reclaim ~60% of your session database disk -> hermes gateway stop;hermes sessions optimize-storage

# update报错：Could not install browser-use CLI, HTTP status client error (429 Too Many Requests) for url (https://mirrors.ustc.edu.cn : venv: uv lock exited -> 修改.env的UV_INDEX=https://pypi.tuna.tsinghua.edu.cn/simple再执行hermes update

# doctor报告issue：Browser tools (agent-browser) has 1 npm vulnerability -> 临时修复：进tools/agent-browser执行，npm i --package-lock-only，npm audit fix --force; 永久修复：开发者已知漏洞#116774，本地修复无法持久，下次更新还会拉取官方仓库里的依赖版本（带有漏洞）。

install.ps1时，如果已经.env有telegram配置，它会安装
hermes setup 流程配置，也会自动安装 -→ 这个比较有效！
事后手动安装 C:\Users\cat\AppData\Local\hermes\hermes-agent\venv\Scripts\python.exe -m pip install “python-telegram-bot[webhooks]>=22.6,<23”
对话处理跑 hermes doctor，看 telegram 那行是什么状态

searxng-tool

把url和key给ai自己配置

windows部署手册

安装升级

telegram

searxng-tool

trilium-mcp