Hermes Agent 安装指南：先跑通最小闭环，再把它变成长期工作台

先别急着把所有功能打开：安装的正确顺序

Hermes Agent不是一个模型，而是一套把模型、终端、文件、网页、记忆、Skills和消息平台组织起来的Agent环境。安装成功不能只看命令是否存在，还要确认模型能响应、工具按预期启用、会话可以保存，密钥没有混入项目目录。

建议按这个顺序操作：安装运行环境，配置一个provider，完成一次真实对话，再逐步打开工具、Skills、记忆和Gateway。一次性加入多个模型、浏览器和MCP，会让故障定位变得困难。

使用官方安装器：

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

重新加载Shell并检查：

source ~/.zshrc  # macOS
source ~/.bashrc # Linux/WSL2
command -v hermes
hermes --version
hermes doctor

常规用户安装会把运行环境放在~/.hermes/hermes-agent/，启动器放在~/.local/bin/hermes，普通配置放在~/.hermes/config.yaml，密钥放在~/.hermes/.env。不要把.env或auth.json提交到Git。

Windows PowerShell使用：

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

安装后重新打开PowerShell。Termux请使用官方专门指南，不要直接安装桌面环境的全部语音扩展。

hermes model

Nous Portal可以用快速路径：

hermes setup --portal

OpenRouter、Anthropic、Gemini、DeepSeek、Kimi和MiniMax等服务商也可以在模型向导中配置。本地Ollama、LM Studio、vLLM和SGLang需要确认Base URL、模型ID、API模式和认证方式。

Hermes的多步工具调用需要至少64,000 tokens上下文。云端模型通常满足要求，本地模型却经常默认只有4K、8K或32K。llama.cpp可以从--ctx-size 65536开始配置，其他推理服务也要设置同等或更大的窗口。

hermes chat -q "请回复：Hermes基础对话验证成功"

再做一次不修改文件的读取测试：

hermes chat -q "请只读检查当前目录并列出项目文件，不要修改任何文件"

确认会话恢复：

hermes --continue

如果这些步骤都通过，基础环境才算成立。失败时先运行hermes doctor和hermes config check，不要马上增加更多功能。

hermes tools list查看工具，hermes tools进入配置。终端和文件权限最值得先审查；浏览器、代码执行、MCP、联网搜索和委派应按任务逐步启用。Skills是可复用流程，记忆保存跨会话信息，但API Key和私钥不应进入长期记忆。

hermes gateway setup
hermes gateway install
hermes gateway start
hermes gateway status

Gateway可连接Telegram、Discord、Slack、WhatsApp、Signal和飞书。先证明CLI可用，再单独排查网关状态和日志。Linux服务器上运行用户服务时，还要考虑SSH退出后的服务存活问题。