快速入门

安装遇到困难？

点击加入中文社区微信群，提问并获取群内专家帮助。

完全没有经验？ 强烈建议先下载 WorkBuddy（微信扫码即用，无需任何配置），然后让它安装中文社区文档 MCP 来协助你安装 Hermes Agent。如果后续 Hermes 出现问题，也可以让 WorkBuddy 对其进行修复，反之亦然——两个 Agent 互为主备，这是社区推荐的最佳方案。

电脑上已经有 Agent？ 如果你已经在用龙虾 OpenClaw 或国内版本（QClaw、AutoClaw），或者 Trae、Claude Code、Codex、Cursor、Qoder 等 Coding Agent，都可以让它读文档来协助你完成安装，你可以不用关心任何技术细节。

如何让你的 Agent 接入中文社区文档？

方式一（最简单）：把中文社区网址 https://hermesagent.org.cn 发给它，让它自己访问并阅读文档。

方式二（更精准，推荐）：直接把下面这段话复制发给你的 Agent，它会自己完成配置：

请把这个 Hermes 中文文档 MCP server 加到你的配置里：
https://mcp.hermesagent.org.cn/v1
（Streamable HTTP，无需 API Key、无需登录）
加完后用它帮我查 Hermes Agent 中文文档来指导我完成安装。

方式二配好后，Agent 就能按关键词直接检索并读取中文社区全部文档的全文。

其他求助途径：也可以先询问豆包、DeepSeek 等 AI 助手。

本指南将引导你完成安装 Hermes Agent、配置大模型提供商，并与 Hermes Agent进行首次对话。

1. 安装 Hermes Agent

类 Linux / macOS / WSL2

curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash

Windows 原生 PowerShell

irm https://res1.hermesagent.org.cn/install.ps1 | iex

什么是 PowerShell？怎么打开？

PowerShell 是 Windows 自带的命令行程序，可以理解成“Windows 里的终端”。
打开方式：按一下键盘左下角 Windows 键，输入 PowerShell，然后点击 Windows PowerShell 或 PowerShell。
如果你看到的是 Windows Terminal 也没关系，只要里面开的标签页是 PowerShell 即可。
不要把上面的命令粘贴到浏览器地址栏、资源管理器地址栏，或“运行”对话框里。

Windows 用户

最推荐：先安装 WSL2，再在 WSL2 终端里运行上面的 install.sh。
想直接在 PowerShell 里安装：运行上面的 install.ps1。
WSL2 是什么？ 可以把它理解成“Windows 里的 Linux 终端环境”。装好以后，你可以在 Windows 电脑上直接打开 Ubuntu 终端，按 Linux 的方式安装和运行 Hermes Agent。
详细说明请看 Windows 安装指南。

中国大陆网络环境提示

当前页的一键安装命令已经由 Hermes Agent 中文社区 提供 国内镜像加速，默认优先走国内可直连链路。

为了提高中国大陆用户的安装体验，镜像版安装器默认精简了部分国人不常用、或体积较大且经常受外网影响的可选功能，例如浏览器自动化、Chromium 下载、WhatsApp 桥接等。建议先完成核心安装，确认 Hermes Agent 可以正常运行；之后可让 Hermes Agent 自身补全这些能力。

如果你需要继续处理 WSL 网络、终端代理或手动镜像配置，可参考：

WSL 安装（中文）：Windows 10/11 安装 WSL2 指南
WSL 网络 / autoProxy（官方）：Microsoft Learn - Accessing network applications with WSL
Python / pip 镜像说明：清华 TUNA - PyPI 镜像帮助
Node.js / npm 镜像说明：清华 TUNA - NodeJS Release 镜像帮助 / npmmirror

安装完成后：

类 Unix / WSL2

source ~/.bashrc   # 或：source ~/.zshrc

Windows PowerShell

# 关闭并重新打开 PowerShell 即可

如果你是第一次接触 Windows 命令行，建议直接继续看 Windows 安装指南，里面把：

什么是 PowerShell
怎么打开 PowerShell
什么时候需要管理员 PowerShell
PowerShell 直装的完整步骤

都拆开写了。

2. 配置大模型提供商

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

hermes model       # 选择大语言模型提供商和模型
hermes tools       # 配置启用哪些工具
hermes setup       # 或一次性完成全部配置

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

提供者	是什么	如何配置
Nous Portal	基于订阅、零配置	通过 `hermes model` 进行 OAuth 登录
OpenAI Codex	ChatGPT OAuth，使用 Codex 模型	通过 `hermes model` 进行设备码认证
Anthropic	直接使用 Claude 模型（Pro/Max 或 API 密钥）	使用 `hermes model` 进行 Claude Code 认证，或提供 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 Agent 后端（启动本地 `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 键。

❯ 你现在能帮我做什么？

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

4. 尝试核心功能

让它使用终端

❯ 帮我看看磁盘空间占用情况，并列出最大的 5 个目录。

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

使用斜杠命令

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

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

多行输入

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

中断 Agent

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

恢复会话

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

hermes --continue    # 恢复最近一次会话
hermes -c            # 简写形式

5. 进一步探索

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

设置沙箱终端

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

hermes config set terminal.backend docker    # 使用 Docker 隔离终端
hermes config set terminal.backend ssh       # 把终端切到远程服务器

连接消息平台

通过微信、飞书、QQ、Discord、WhatsApp、Signal、电子邮件或 Home Assistant 从手机或其他设备与 Hermes 对话：

hermes gateway setup    # 交互式配置消息平台

添加语音模式

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

pip install "hermes-agent[voice]"

# 可选，但推荐：启用免费的本地语音转文字
pip install faster-whisper

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

/voice on

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

安排自动化任务

❯ 每天早上 9 点检查 Hacker News 上的 AI 新闻，并通过飞书给我发一份摘要。

Agent 将通过网关自动设置一个 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）连接外部工具：

# 添加到 ~/.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 指南 — 掌握终端界面
配置 — 自定义你的设置
消息网关 — 连接微信、飞书、QQ、Discord、WhatsApp、Signal、电子邮件或 Home Assistant
工具与工具集 — 探索可用功能

1. 安装 Hermes Agent​

类 Linux / macOS / WSL2​

Windows 原生 PowerShell​

类 Unix / WSL2​

Windows PowerShell​

2. 配置大模型提供商​

3. 开始对话​

4. 尝试核心功能​

让它使用终端​

使用斜杠命令​

多行输入​

中断 Agent​

恢复会话​

5. 进一步探索​

设置沙箱终端​

连接消息平台​

添加语音模式​

安排自动化任务​

浏览并安装技能​

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

尝试 MCP 服务器​

快速参考​

下一步​