快速入门

本指南将引导你完成安装 Hermes Agent、配置提供者，并进行首次对话。完成之后，你将了解其核心功能，并知道如何进一步探索。

1. 安装 Hermes Agent

运行一键安装命令：

# Linux / macOS / WSL2 / Android (Termux)
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Android / Termux

如果你在手机上安装，请参阅专用的 Termux 指南，获取经过测试的手动安装路径、支持的附加功能以及当前 Android 特有的限制。

Windows 用户

请先安装 WSL2，然后在你的 WSL2 终端中运行上述命令。

安装完成后，重新加载你的 shell：

source ~/.bashrc   # or source ~/.zshrc

2. 配置提供者

安装程序会自动为你配置 LLM 提供者。如需后续更改，可使用以下任一命令：

hermes model       # Choose your LLM provider and model
hermes tools       # Configure which tools are enabled
hermes setup       # Or configure everything at once

hermes model 会引导你选择推理提供者：

提供者	是什么	如何配置
Nous Portal	基于订阅、零配置	通过 `hermes model` 进行 OAuth 登录
OpenAI Codex	ChatGPT OAuth，使用 Codex 模型	通过 `hermes model` 进行设备码认证
Anthropic	直接使用 Claude 模型（Pro/Max 或 API 密钥）	使用 `hermes model` 进行 Claude 代码认证，或提供 Anthropic API 密钥
OpenRouter	跨多种模型的多提供者路由	输入你的 API 密钥
Z.AI	GLM / Zhipu 托管模型	设置 `GLM_API_KEY` / `ZAI_API_KEY`
Kimi / Moonshot	Moonshot 托管的代码与聊天模型	设置 `KIMI_API_KEY`
MiniMax	国际 MiniMax 接口	设置 `MINIMAX_API_KEY`
MiniMax 中国区	中国区域 MiniMax 接口	设置 `MINIMAX_CN_API_KEY`
阿里云	通过 DashScope 使用 Qwen 模型	设置 `DASHSCOPE_API_KEY`
Hugging Face	通过统一路由使用 20+ 开源模型（Qwen、DeepSeek、Kimi 等）	设置 `HF_TOKEN`
Kilo Code	KiloCode 托管模型	设置 `KILOCODE_API_KEY`
OpenCode Zen	按使用量付费访问精选模型	设置 `OPENCODE_ZEN_API_KEY`
OpenCode Go	每月 $10 订阅，访问开源模型	设置 `OPENCODE_GO_API_KEY`
DeepSeek	直接访问 DeepSeek API	设置 `DEEPSEEK_API_KEY`
GitHub Copilot	GitHub Copilot 订阅（GPT-5.x、Claude、Gemini 等）	通过 `hermes model` 进行 OAuth，或设置 `COPILOT_GITHUB_TOKEN` / `GH_TOKEN`
GitHub Copilot ACP	Copilot ACP 代理后端（启动本地 `copilot` CLI）	使用 `hermes model`（需安装 `copilot` CLI 并执行 `copilot login`）
Vercel AI Gateway	Vercel AI Gateway 路由	设置 `AI_GATEWAY_API_KEY`
自定义端点	VLLM、SGLang、Ollama 或任何 OpenAI 兼容 API	设置基础 URL + API 密钥

提示

你可以随时通过 hermes model 切换提供者——无需修改代码，无锁定风险。配置自定义端点时，Hermes 会提示你输入上下文窗口大小，并在可能的情况下自动检测。详情请参见上下文长度检测。

3. 开始对话

hermes

完成！你将看到包含模型信息、可用工具和技能的欢迎横幅。输入消息并按 Enter 键。

❯ What can you help me with?

该代理已具备访问网络搜索、文件操作、终端命令等工具的能力——开箱即用。

4. 尝试核心功能

让它使用终端

❯ What's my disk usage? Show the top 5 largest directories.

代理将代表你执行终端命令，并显示结果。

使用斜杠命令

输入 / 可查看所有命令的自动补全下拉菜单：

命令	功能
`/help`	显示所有可用命令
`/tools`	列出可用工具
`/model`	交互式切换模型
`/personality pirate`	尝试有趣的个性模式
`/save`	保存对话

多行输入

按 Alt+Enter 或 Ctrl+J 可换行。非常适合粘贴代码或撰写详细提示。

中断代理

如果代理运行时间过长，只需输入新消息并按 Enter——它将中断当前任务并切换到你的新指令。Ctrl+C 也有效。

恢复会话

退出时，hermes 会打印出恢复命令：

hermes --continue    # Resume the most recent session
hermes -c            # Short form

5. 进一步探索

以下是一些你可以尝试的进阶操作：

设置沙箱终端

为确保安全，建议在 Docker 容器或远程服务器上运行代理：

hermes config set terminal.backend docker    # Docker isolation
hermes config set terminal.backend ssh       # Remote server

连接消息平台

通过 Telegram、Discord、Slack、WhatsApp、Signal、电子邮件或 Home Assistant 从手机或其他设备与 Hermes 对话：

hermes gateway setup    # Interactive platform configuration

添加语音模式

希望在 CLI 中使用麦克风输入，或在消息中获得语音回复？

pip install "hermes-agent[voice]"

# Optional but recommended for free local speech-to-text
pip install faster-whisper

然后启动 Hermes 并在 CLI 中启用语音模式：

/voice on

按 Ctrl+B 开始录音，或使用 /voice tts 让 Hermes 朗读其回复。完整设置请参见语音模式，涵盖 CLI、Telegram、Discord 及 Discord 语音频道。

安排自动化任务

❯ Every morning at 9am, check Hacker News for AI news and send me a summary on Telegram.

代理将通过网关自动设置一个 cron 任务，定时运行。

浏览并安装技能

hermes skills search kubernetes
hermes skills search react --source skills-sh
hermes skills search https://mintlify.com/docs --source well-known
hermes skills install openai/skills/k8s
hermes skills install official/security/1password
hermes skills install skills-sh/vercel-labs/json-render/json-render-react --force

提示：

使用 --source skills-sh 搜索公共的 skills.sh 目录。
使用 --source well-known 并配合文档/网站 URL，从 /.well-known/skills/index.json 发现技能。
仅在审查第三方技能后使用 --force。它可覆盖非危险策略块，但无法覆盖 dangerous 扫描结论。

也可在聊天中使用 /skills 斜杠命令。

通过 ACP 在编辑器中使用 Hermes

Hermes 还可作为 ACP 服务器运行，兼容 VS Code、Zed 和 JetBrains 等 ACP 编辑器：

pip install -e '.[acp]'
hermes acp

有关设置详情，请参阅 ACP 编辑器集成。

尝试 MCP 服务器

通过模型上下文协议（Model Context Protocol）连接外部工具：

# Add to ~/.hermes/config.yaml
mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"

快速参考

命令	描述
`hermes`	开始聊天
`hermes model`	选择你的大语言模型（LLM）提供商和模型
`hermes tools`	配置各平台启用的工具
`hermes setup`	完整设置向导（一次性配置所有内容）
`hermes doctor`	诊断问题
`hermes update`	更新至最新版本
`hermes gateway`	启动消息网关
`hermes --continue`	恢复上次会话

下一步

CLI 指南 — 掌握终端界面
配置 — 自定义你的设置
消息网关 — 连接 Telegram、Discord、Slack、WhatsApp、Signal、电子邮件或 Home Assistant
工具与工具集 — 探索可用功能

1. 安装 Hermes Agent​

2. 配置提供者​

3. 开始对话​

4. 尝试核心功能​

让它使用终端​

使用斜杠命令​

多行输入​

中断代理​

恢复会话​

5. 进一步探索​

设置沙箱终端​

连接消息平台​

添加语音模式​

安排自动化任务​

浏览并安装技能​

通过 ACP 在编辑器中使用 Hermes​

尝试 MCP 服务器​

快速参考​

下一步​