准备环境Step 1
安装 WSL
先按教程安装 WSL：访问 https://docs.heitubobo.com/wsl/ 。如果过程中遇到问题，直接在群里联系技术同学。
这一段在 Windows 环境中完成。
操作前提醒：所有命令默认都在 Ubuntu 中执行；只有文中明确写了 PowerShell 的步骤，才需要切回 Windows 终端。若某一步报错，优先重试一次，再把报错内容发给技术同学。
正式安装：按顺序一路做完
下面的步骤已经重新整理为更易读的卡片式流程，适合边看边操作。
主流程
安装 HermesStep 2
在 Ubuntu 中安装 Hermes Agent
打开 Ubuntu 终端，执行下面的安装命令。若中途报错，先重新执行一次；仍有问题就把报错发给技术同学。
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash命令必须在 Ubuntu 里执行，不要在 PowerShell 里跑。
成功标志Step 3
看到初始化界面 = 安装成功
当终端出现 Hermes 初始化界面时，说明 Hermes Agent 已经安装成功，并进入配置流程。此时继续下一步即可。
下面这张图就是“安装完成并进入初始化向导”的关键标志。
初始化配置Step 4
选择 Quick Setup
在初始化界面中选择 Quick Setup（推荐），进入快速配置流程。
适合大多数人，后续会继续配置 provider、模型与 WebUI 使用方式。
模型提供方Step 5
选择 OpenAI Codex
在 provider 选择页里，选择 “OpenAI Codex (uses OPENAI_API_KEY)”。
这是当前推荐路径。
授权步骤Step 6
把 8 位授权码发给 gpt 订阅账号持有者
输入 1 并回车后，会弹出一个 8 位授权码，格式类似 XXXX-XXXX。把这个 Code 私聊发给我。
这一步是完成授权的关键。
模型选择Step 7
选择 gpt-5.5
授权完成后，选择 gpt-5.5 gpt-5.5；思考深度可以自行选择，推荐 High。
先以能稳定使用为主。
消息通道Step 8
消息连接先选 Skip
先选 Skip。若以后需要连接微信，可在这里配置，或后续在 Ubuntu 中运行 hermes gateway setup。
不是必选项，后面随时可补。
聊天模式Step 9
Hermes Chat 是否开启
出现“是否开启 Hermes Chat”时，可选 n 不打开；也可以选 Y 体验一下，然后用 Ctrl+C 退出。
重点是安装完成后要回到 Ubuntu 终端。
继续操作Step 10
确认自己回到 Ubuntu 终端
确保你当前停留在 Ubuntu 界面，而不是 Hermes 聊天界面；通常右侧会有绿色小字提示当前状态。
后面安装 WebUI 时，一定要在 Ubuntu 终端执行命令。
安装 WebUIStep 11
安装 Hermes WebUI
在 Ubuntu 中先克隆仓库，再运行 bootstrap 脚本。
git clone https://github.com/nesquena/hermes-webui.git hermes-webui
python3 hermes-webui/bootstrap.py两条命令按顺序执行。
打开页面Step 12
打开 WebUI
控制台里会显示 WebUI 地址（http 开头）；也可以直接在浏览器输入 http://localhost:8787/ 。建议收藏这个地址。
以后从浏览器即可进入。
初始化 WebUIStep 13
WebUI 初始化一路下一步
WebUI 首次打开后，初始化过程一路点击“下一步”即可。
默认选项即可正常使用。
语言设置Step 14
可切换中文界面
如果想切到中文：左下角 Hermes WebUI → Preferences → Language。
不是必须，但更适合中文使用者。
工作目录Step 15
查看 workspace
点击右上角 Files，可以查看当前工作区（workspace）。建议后续让 AI 处理的项目都放在 workspace 内。
这样路径最稳定，也最方便。
收尾Step 16
开始指示AI继续工作吧
你可以开始使用Hermes的WebUI了，但还是建议同学们继续去下方的可选配置修改板块看看。
祝你玩得开心。
自检命令
后续可用这两条命令检查安装
以后如果想检查安装完整性或排查问题，可以重新执行安装脚本，或运行 hermes doctor。
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
hermes doctor把输出发给技术同学也便于排查。
日常使用
日常打开方式
如果你没有配置开机自启，就手动启动 WSL，然后运行 python3 ~/hermes-webui/bootstrap.py；如果配置了自启，开机后直接打开浏览器进入 WebUI 即可。
这一步是后续日常使用方式总结。
常用命令速查
如果你只想快速复制关键命令，可以直接看这里。
命令卡片
安装 Hermes Agent
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash安装 Hermes WebUI
git clone https://github.com/nesquena/hermes-webui.git hermes-webui
python3 hermes-webui/bootstrap.py手动打开 WebUI
未设置自动启动时，可在 Ubuntu 中直接运行：
python3 ~/hermes-webui/bootstrap.py安装/问题自检
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
hermes doctor可选高级配置
这一部分全部是可选项，因此我已经去掉标题前的编号，避免与主流程混淆。
可选项
可选配置
断开 Windows 与 WSL 自动挂载
如果你希望 Windows 与 WSL 的文件系统挂载更加独立，可在 Ubuntu 中编辑 /etc/wsl.conf，写入 [automount] enabled = false 。断开挂载后自动连接windows的系统path会报错，所以可以额外加上 [interop] appendWindowsPath = false 。 最后在 PowerShell 里执行 wsl --shutdown。
sudo nano /etc/wsl.conf
[automount]
enabled = false
[interop]
appendWindowsPath = false
# 保存后在 PowerShell 中执行
wsl --shutdown适合希望减少 Windows 磁盘自动挂载影响的人。
可选配置
把 WSL 磁盘移动到其他盘
在确认 WSL 已关闭后，可以用 PowerShell 把 Ubuntu 的存储位置迁移到 D 盘或其他位置。
wsl --manage Ubuntu --move "D:\\wsl"把 D:\wsl 换成你希望保存的位置。
如果切换挂载后启动Ubuntu提示权限错误，可以右键ext4.vhdx文件的属性页面，选择“安全”标签页，选择Authenticated Users选择编辑，勾选完全控制权限并点击确定即可。
可选配置
把 workspace 固定到 Windows 快速访问
在 Windows 文件资源管理器中进入 Linux → Ubuntu → home → 你的用户名，找到 workspace 文件夹，右键选择“固定到快速访问”。这样以后可以在左侧栏直接进入 workspace。
建议需要 AI 操作的项目文件都放进 workspace。
可选配置
Windows 开机自动启动 WSL + WebUI
按 Win + R，输入 taskschd.msc 打开任务计划程序
点击右侧创建任务
常规：填写名称（如 WSL_AutoStart），勾选“只在用户登录时运行”和“使用最高权限运行”。
程序填写 wsl.exe，参数填写 -d Ubuntu -e bash -c "~/hermes-webui/start.sh"。这样电脑开机后可自动启动 WSL 与 WebUI。
wsl.exe
-d Ubuntu -e bash -c "~/hermes-webui/start.sh"适合希望开机后直接进入 WebUI 的用户。
完成后的日常使用方式
安装结束后，日常进入 WebUI 的方式其实非常简单。
收尾说明
如果没有配置自动启动
每次使用时，先打开 Ubuntu，再运行下面命令启动 WebUI：
python3 ~/hermes-webui/bootstrap.py浏览器访问 http://localhost:8787/ 即可进入。
如果已经配置自动启动
电脑开机后，WSL 和 WebUI 会自动拉起。此时你只需要打开浏览器进入 WebUI 即可开始使用。
建议把常用项目都放进 workspace，路径更稳定，也更适合让 AI 直接处理。