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
    
    -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
  • 命令升级

    hermes update
  • kanban界面点击升级

telegram

  • 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自己配置

trilium-mcp