快速上手 Hermes Agent

快速上手的目标不是把功能全部打开，而是先得到一个稳定可用的基础对话。官方文档反复强调的判断标准很简单：如果 Hermes 还不能完成一次普通聊天，就先不要叠加 gateway、cron、skills、voice 或多 provider fallback。

最短路径

先安装 Hermes：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc

然后用交互式配置选择模型供应商：

hermes model

新用户优先选自己最容易拿到凭据的 provider。Hermes 支持 Nous Portal、OpenAI Codex、Anthropic、OpenRouter、Z.AI、Kimi、MiniMax、Alibaba Cloud、Hugging Face、DeepSeek、GitHub Copilot、Vercel AI Gateway、自定义 OpenAI-compatible endpoint 等多种入口。无论选哪一种，模型上下文至少要有 64K tokens；本地模型需要显式把 context size 设到 65536 或更高。

Secrets 和普通配置分开存：

• secrets / token：~/.hermes/.env
• 普通设置：~/.hermes/config.yaml

建议用 CLI 写配置，让 Hermes 自动放到正确位置：

hermes config set model anthropic/claude-opus-4.6
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-...

第一次对话

启动 classic CLI 或 TUI：

hermes
hermes --tui

第一次测试不要问开放问题，选一个能验证工具能力的任务：

Summarize this repo in 5 bullets and tell me what the main entrypoint is.

Check my current directory and tell me what looks like the main project file.

成功的标志是：欢迎 banner 显示正确的 provider 和模型；Hermes 能正常回复；需要时可以调用 terminal / file read / web search 等工具；多轮对话不会马上断。

确认 session 可恢复

基础聊天成功后，马上验证 session：

hermes --continue
hermes -c

它应该恢复刚才那段会话。如果没有恢复，先检查当前 profile 和 session 保存状态。团队环境、多机器环境、长期 bot 都依赖这个能力。

再加下一层能力

基础对话稳定后，再按目标逐层开启：

• bot 或共享助手：先跑 hermes gateway setup，再接 Telegram、Discord、Slack、WhatsApp、Signal、Email 或 Home Assistant。
• 工具访问：用 hermes tools 调整不同平台可用的工具。
• 技能系统：用 hermes skills search 和 hermes skills install 安装可复用 workflow。
• 容器或远程隔离：用 hermes config set terminal.backend docker 或 hermes config set terminal.backend ssh。
• 语音模式：安装 voice extra 后，在 CLI 里用 /voice on 开启。

常用命令入口：

hermes gateway setup
hermes tools
hermes skills search kubernetes
hermes skills install openai/skills/k8s
hermes config set terminal.backend docker

遇到问题时先回到最小闭环：provider 配置正确、普通对话能跑、session 可恢复。这个闭环通过后，再排查更复杂的 gateway、cron、MCP 或 skill。