Hermes Agent 安装与使用入门完整教程

Hermes Agent 是一个开源的 AI Agent 框架，由 Nous Research 开发。它运行在你的终端里，能操作文件、执行命令、搜索网络、管理 GitHub、收发邮件——而且有跨会话记忆，越用越懂你。

这篇教程覆盖安装、配置、日常使用三个部分，跟着做就行。

一、系统要求

支持 Linux、macOS、WSL2（Windows 子系统）。不支持原生 Windows，Windows 用户需要先装 WSL2。

唯一的前置依赖：Git。其他所有东西（Python 3.11、Node.js v22、ripgrep、ffmpeg）安装脚本会自动处理。

# 检查 Git 是否已安装
git --version

二、一键安装

复制下面这一行命令，在终端里执行：

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

01-install

安装脚本会自动完成以下操作：

安装 uv（Python 包管理器）
安装 Python 3.11
安装 Node.js v22
安装 ripgrep、ffmpeg
克隆仓库并创建虚拟环境
注册全局 hermes 命令
启动模型配置向导

会问你是否需要导入openclaw小龙虾，一路输入 Y 就行

02-install

推荐使用快速配置

三、配置模型

支持的供应商（部分）：

Anthropic — Claude 系列（API Key 或 Claude Code 登录）
OpenAI Codex — ChatGPT OAuth 登录
OpenRouter — 多模型路由（一个 Key 访问几十个模型）
Z.AI（智谱） — GLM 系列，Zhipu AI direct API 设 ZAI_API_KEY
DeepSeek — 设 DEEPSEEK_API_KEY
Kimi / Moonshot — 设 KIMI_API_KEY
阿里云 — 通义千问，设 DASHSCOPE_API_KEY
Hugging Face — 20+ 开源模型，设 HF_TOKEN
GitHub Copilot — Copilot 订阅直接用
自定义端点 — VLLM、Ollama 等任何兼容 OpenAI API 的服务

image (1)

重要：模型需要至少 64K tokens 的上下文窗口。Claude、GPT、Gemini、Qwen、DeepSeek 等主流模型都满足。

是否显示配置对话通道

image (2)

选择你要配置的通道即可，这一步如果不想配置也可以直接esc，后续还能继续配置，后续一路输入y

image (3)

image (4)

Hermes 不绑定任何模型。后续如果切换模型运行以下命令选择你的 LLM 供应商：

hermes model

API Key 的设置方式：

# 方法一：交互式配置
hermes model

# 方法二：直接写入配置
hermes config set OPENROUTER_API_KEY sk-or-v1-xxxxx

# 方法三：编辑配置文件
vim ~/.hermes/.env
# 写入：
# ZAI_API_KEY=your-key
# DEEPSEEK_API_KEY=your-key

四、验证安装

hermes version    # 查看版本
hermes doctor     # 诊断问题
hermes status     # 查看配置状态

三个命令都正常通过，就可以开始使用了。

五、开始使用

直接输入 hermes 启动对话。你会看到欢迎界面，显示当前模型和可用工具。

hermes

试几个操作：

❯ 查看磁盘使用情况，列出最大的5个目录

❯ 在当前目录创建一个 Python FastAPI 项目脚手架

❯ 帮我搜索最近一周 AI Agent 领域的重要新闻

❯ 读一下 ~/project/main.py，告诉我有什么 bug

Hermes 会自动拆解任务、调用工具、执行操作。你不需要告诉它具体怎么做。

六、常用命令速查

对话中的斜杠命令：

/help — 查看所有命令
/tools — 列出可用工具
/model — 切换模型
/save — 保存对话
/skills — 浏览和安装技能

终端命令：

hermes — 开始对话
hermes --continue 或 hermes -c — 恢复上次对话
hermes model — 切换模型
hermes tools — 配置工具
hermes setup — 完整设置向导
hermes doctor — 诊断问题
hermes update — 更新版本
hermes gateway — 启动消息网关（Telegram/Discord/微信等）

快捷键：

Alt+Enter 或 Ctrl+J — 多行输入
Ctrl+C — 中断当前任务
直接输入新消息按回车 — 也会中断当前任务

七、技能系统

技能是预定义的任务流程，教 Hermes 怎么完成特定工作。社区有大量现成技能可用。

# 搜索技能
hermes skills search kubernetes
hermes skills search react --source skills-sh

# 从 URL 发现技能
hermes skills search https://docs.example.com --source well-known

# 安装技能
hermes skills install openai/skills/k8s
hermes skills install official/security/1password

# 在对话中管理
/skills

八、消息平台连接

Hermes 可以接入 Telegram、Discord、Slack、WhatsApp、Signal、邮件等平台，在手机上也能用：

hermes gateway setup    # 交互式配置各平台
hermes gateway          # 启动网关

九、语音模式

支持语音输入和语音回复：

pip install "hermes-agent[voice]"
pip install faster-whisper   # 推荐，免费本地语音转文字

# 在对话中开启
/voice on

# Ctrl+B 录音，/voice tts 开启语音回复

十、安全配置

Hermes 默认直接操作你的系统。如果需要隔离环境：

# Docker 隔离
hermes config set terminal.backend docker

# 远程服务器执行
hermes config set terminal.backend ssh

十一、手动安装（可选）

如果你想完全控制安装过程：

# 1. 安装 uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# 2. 克隆仓库
git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

# 3. 创建虚拟环境
uv venv venv --python 3.11
export VIRTUAL_ENV="$(pwd)/venv"

# 4. 安装依赖
uv pip install -e ".[all]"
npm install   # 可选，浏览器和 WhatsApp 功能

# 5. 创建配置目录
mkdir -p ~/.hermes/{cron,sessions,logs,memories,skills,pairing,hooks,image_cache,audio_cache,whatsapp/session}
cp cli-config.yaml.example ~/.hermes/config.yaml
touch ~/.hermes/.env

# 6. 设置 API Key
echo 'OPENROUTER_API_KEY=sk-or-v1-your-key' >> ~/.hermes/.env

# 7. 注册全局命令
mkdir -p ~/.local/bin
ln -sf "$(pwd)/venv/bin/hermes" ~/.local/bin/hermes
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# 8. 验证
hermes doctor

十二、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: command not found

重载 shell（source ~/.bashrc），或检查 ~/.local/bin 是否在 PATH 中。

API key not set

运行 hermes model 配置，或 hermes config set OPENROUTER_API_KEY your_key。

更新后配置丢失

运行 hermes config check，然后 hermes config migrate。

其他问题

运行 hermes doctor，它会告诉你缺什么、怎么修。

GitHub：github.com/NousResearch/hermes-agent

文档：hermes-agent.nousresearch.com/docs

Discord：discord.gg/NousResearch

Hermes Agent 安装与使用入门完整教程

一、系统要求

二、一键安装

三、配置模型

四、验证安装

五、开始使用

六、常用命令速查

`/skills` — 浏览和安装技能

`hermes gateway` — 启动消息网关（Telegram/Discord/微信等）

七、技能系统

八、消息平台连接

九、语音模式

十、安全配置

十一、手动安装（可选）

十二、MCP 集成

十三、常见问题

一、系统要求

二、一键安装

三、配置模型

四、验证安装

五、开始使用

六、常用命令速查

/skills — 浏览和安装技能

hermes gateway — 启动消息网关（Telegram/Discord/微信等）

七、技能系统

八、消息平台连接

九、语音模式

十、安全配置

十一、手动安装（可选）

十二、MCP 集成

十三、常见问题

`/skills` — 浏览和安装技能

`hermes gateway` — 启动消息网关（Telegram/Discord/微信等）