Hermes Agent 是由 Nous Research 开发的开源命令行 AI Agent，支持终端访问、工具调用、技能扩展和多平台集成（Telegram、Discord 等）。
一、系统要求
| 组件 | 要求 |
|---|---|
| 操作系统 | macOS（Apple Silicon M1/M2/M3/M4 或 Intel 均支持） |
| Git | 需要（用于拉取仓库） |
| Python | 3.11+（安装脚本可自动通过 uv 安装，无需手动配置） |
| Node.js | 22+（安装脚本自动安装） |
| 网络 | 需能访问 GitHub |
二、安装方式
方式一：一键脚本安装（推荐）
追踪 main 分支，获取最新版本：
bash
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash安装脚本会自动完成以下所有工作：
- 安装
uv（Python 包管理器） - 安装 Python 3.11、Node.js 22、
ripgrep、ffmpeg - 克隆仓库到
~/.hermes/hermes-agent/ - 创建虚拟环境
- 将
hermes命令添加到~/.local/bin/（并配置 PATH）
安装完成后，重新加载 shell 配置：
bash
source ~/.zshrc # zsh 用户（macOS 默认）
# 或
source ~/.bashrc # bash 用户方式二：pip 安装（稳定版）
PyPI 版本追踪正式 release，更稳定但非最新：
bash
pip install hermes-agent
hermes postinstall # 可选：安装 Node.js、浏览器、ripgrep、ffmpeg 并运行向导方式三：Homebrew 安装
bash
brew install nousresearch/tap/hermes-agent三、初始配置
运行安装向导
bash
hermes setup向导会引导你：
- 选择 LLM 提供商
- 配置 API Key（或 OAuth 登录）
- 验证连接是否正常
配置文件位置
| 文件 | 说明 |
|---|---|
~/.hermes/config.yaml | 主配置文件 |
~/.hermes/.env | API Key 等敏感信息 |
~/.hermes/hermes-agent/ | 代码本体 |
四、选择 LLM 提供商
运行以下命令交互式选择模型提供商：
bash
hermes model常用提供商配置方式：
| 提供商 | 配置方式 |
|---|---|
| Nous Portal（推荐新手） | OAuth 登录，一键启用 300+ 模型 |
| Anthropic (Claude) | hermes model → OAuth 登录（需 Max 套餐），或填入 API Key |
| OpenAI | 填入 OPENAI_API_KEY |
| OpenRouter | 填入 API Key，支持多模型路由 |
| Ollama（本地模型） | hermes model → 自定义 endpoint，填写本地地址 |
| 阿里云 Qwen | 设置 DASHSCOPE_API_KEY |
Nous Portal 一键配置（最简方式）：
bash
hermes setup --portal五、开始使用
启动对话
bash
hermes # 直接进入聊天
hermes chat # 等同于上面常用命令一览
bash
hermes # 开始聊天
hermes model # 切换 LLM 模型/提供商
hermes tools # 查看/配置可用工具
hermes skills # 管理技能（Skills）
hermes gateway # 配置消息平台（Telegram/Discord 等）
hermes config set # 修改单项配置
hermes setup # 重新运行完整配置向导
hermes update # 更新到最新版本对话中的内置命令
在聊天界面中，可使用斜杠命令：
| 命令 | 说明 |
|---|---|
/voice on | 开启语音输入（需安装 voice 扩展） |
/skills | 在对话中管理技能 |
Ctrl+C | 退出聊天 |
六、常用功能
1. 安装与使用 Skills（技能）
bash
# 搜索技能
hermes skills search kubernetes
# 安装技能
hermes skills install openai/skills/k8s2. 配置 MCP Server（扩展工具）
编辑 ~/.hermes/config.yaml，添加：
yaml
mcp_servers:
github:
command: npx
args: ["-y", "@modelcontextprotocol/server-github"]
env:
GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"3. 启动 Web UI 仪表盘
bash
hermes start
open http://127.0.0.1:77774. 接入 Telegram Bot
bash
hermes gateway setup # 配置 Bot Token
hermes gateway # 启动网关七、更新与卸载
更新
bash
hermes update或手动更新：
bash
cd ~/.hermes/hermes-agent
git pull
uv pip install -e ".[all]"卸载
bash
rm -rf ~/.hermes
# 同时从 ~/.zshrc 或 ~/.bashrc 中删除相关 PATH 配置八、常见问题排查
| 问题 | 解决方案 |
|---|---|
hermes: command not found | 执行 source ~/.zshrc，确认 ~/.local/bin 在 PATH 中 |
| Python 版本错误 | 安装器会自动锁定 3.11；如报错请参考手动安装模式 |
| 网络超时 / GitHub 无法访问 | 配置代理或使用镜像，确保终端走代理 |
| 安装中断导致状态不一致 | 重新运行安装命令，脚本是幂等的（可安全重复执行） |
| Node.js 安装失败 | brew install node 后重试 hermes postinstall |
发表回复