前置条件
- ✓ Git / Node.js / Python 可用
- ✓ 模型 API Key 已准备
- ✓ 终端能读取环境变量
- ✓ 日志目录可写
- ✓ Windows 使用 WSL2
1. 先装到本地终端
不要一开始就上 VPS。先在自己的电脑跑通 CLI，问题会少很多。
node -v
python3 --version
git --version
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
hermes --version2. 配置模型 Provider
优先选择一个你已经有额度的模型平台。首次配置后，重新打开一个终端再验证环境变量。
hermes setup model
hermes model
hermes config check
hermes doctor3. 只读跑通第一轮
第一轮只让 Hermes 读文件、总结资料或生成草稿。不要立刻接删除、付款、群发这类动作。
hermes
/model
/skills
请根据当前项目生成一份只读检查清单4. 再迁到长期运行环境
CLI 稳定后再接 Gateway 和 VPS。长期运行要有低权限用户、日志、重启策略和人工确认边界。
hermes gateway setup
hermes gateway start
hermes doctor
tail -n 80 <log-file>环境变量怎么放
✓ API Key 只放在服务端环境变量或 Hermes 配置目录，不写进前端页面。
✓ 开发、测试、生产使用不同 Key，方便限额和撤销。
✓ 高权限 Token 单独命名，先不给 Agent 默认使用。
✓ 每次改完环境变量，重新打开终端或重启服务再验证。
export OPENROUTER_API_KEY="..."
export NOUS_API_KEY="..."
printenv | grep -E "OPENROUTER|NOUS"
hermes config check成本与安全提醒
模型 API、VPS、消息平台和第三方 SaaS 会产生费用。不要把生产数据库写权限、付款权限或群发权限直接交给 Agent。
VPS 长期运行 checklist
- ✓ 创建低权限运行用户，不用 root 长期跑任务。
- ✓ 把 Hermes 工作目录、日志目录和备份目录分开。
- ✓ 使用进程守护，失败后自动重启，并限制重启频率。
- ✓ 日志至少保留 7 天，方便排查 Gateway、模型和工作流问题。
- ✓ 消息平台只允许指定用户或频道调用。
- ✓ 涉及写文件、发消息、改表格、开工单的动作先加人工确认。
安装完成怎么验收
Provider configured：`hermes model` 能看到当前模型并完成一次短对话。
Memory enabled：新会话能读取项目偏好或用户偏好。
Skills ready：`hermes skills browse` 和 `/skills` 都能正常返回。
Gateway connected：目标消息平台能收到测试回复。
Workflow passed：至少一个真实工作流完整跑通并留下日志。
Ops ready：重启、日志、限额和人工确认规则都已检查。