Hermes Agent 入门教程

这篇文章带你从零把 Hermes 装起来，能跑起来发第一条消息。不讲原理，就是一步一步操作。

装之前先确认几件事

系统支持：Linux、macOS 10.15+、Windows（需要先装 WSL2）、Android（Termux）。

你需要准备的：一个 AI 模型的 API Key。Hermes 本身免费，但跑起来需要调用大模型，费用是按使用量算的。

国内用户推荐几个可以直连的选择：

• 智谱 AI（GLM）：glm.cn
• 月之暗面（Kimi）：platform.moonshot.cn
• MiniMax：api.minimax.chat
• 阿里云 DashScope（Qwen）：dashscope.aliyun.com

不想折腾多个账号的话，OpenRouter 一个账号可以访问 200+ 模型，包括 Claude 和 GPT，新手首选。

第一步：安装

一行命令搞定，脚本会自动处理 Python、Node.js、依赖安装等所有事情：

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

装完之后终端会提示安装路径，大概 2-5 分钟。装好后重新打开终端，或者执行 source ~/.bashrc，让 hermes 命令生效。

验证一下：

hermes --version

能看到版本号就说明装好了。

第二步：配置

运行配置向导：

hermes setup

向导会问几个问题：

选模型提供商：选你准备好 API Key 的那个。国内用户选智谱 AI、Kimi 或者 MiniMax 都行，直接输入对应 Key 就行。

输入 API Key：把你准备的 Key 粘贴进去。

选默认模型：向导会列出可用的模型，选一个就行。如果不确定，选提供商推荐的默认选项。

配置完之后你可以用这个命令检查一遍：

hermes config

第三步：发第一条消息

直接运行：

hermes

会打开一个终端界面，输入你的问题，回车发送。比如：

你好，自我介绍一下你能做什么

它回复了就说明整个链路通了。

你也可以不进交互界面，直接一行命令问答：

hermes -q "帮我写一个 Hello World 的 Python 脚本"

几个常用命令

hermes              # 打开交互界面
hermes -c           # 继续上次对话
hermes -q "问题"    # 直接问一个问题，不进交互界面
hermes doctor       # 检查配置是否有问题
hermes status       # 看当前运行状态
hermes update       # 更新到最新版本

进了交互界面之后，可以用斜杠命令：

/model    切换模型
/tools    看当前可用的工具
/voice on 开启语音输入（需要额外安装）
/exit     退出

第四步：开启 Docker 沙箱（强烈建议）

默认情况下，Hermes 执行终端命令是直接在你的机器上跑的，有一定安全风险。建议配置 Docker 沙箱，让它在隔离容器里执行命令：

先装 Docker（官网下载安装包，或者 brew install docker），然后：

hermes config set terminal.backend docker

设好之后，它执行的所有命令都在容器里跑，不会影响你的主机环境。

第五步：接入消息平台（可选）

装好之后只能在终端里用。如果想在飞书、Telegram 或者其他平台里跟它对话，需要配置网关：

hermes gateway setup
hermes gateway start

向导会引导你选消息平台，按步骤配置就行。配好之后 Hermes 会在后台跑着，你在消息平台里发消息，它就能接到。

常见问题

装完之后提示 command not found: hermes

执行 source ~/.bashrc，或者关掉终端重新打开。

API Key 报错

运行 hermes model 重新配置一遍，检查 Key 是否填对。

想重新配置

hermes setup

重新跑一遍向导就行，会覆盖之前的配置。

想完全卸载

rm -rf ~/.hermes/

再把 PATH 里的 hermes 命令删掉，就清干净了。