Hermes Agent 部署与配置完全指南

Hermes Agent 部署与配置完全指南

Hermes Agent 是 Nous Research 开发的开源 AI 智能体，支持15+平台接入，具备记忆、技能学习、语音交互等能力。本指南覆盖从零部署到生产使用的全流程。

一、环境要求

• Python 3.11+
• Node.js 20+（浏览器工具依赖）
• Git、ffmpeg、ripgrep
• uv 包管理器

二、一键安装

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

三、模型配置

运行 hermes model 交互式选择模型和 provider，或手动编辑 ~/.hermes/config.yaml：

model:
  default: doubao-seed-2-0-pro-260215
  provider: custom
  base_url: " http://localhost:8866/v1\
 api_key: \your-api-key\
 context_length: 128000

四、平台接入

Hermes 支持 Telegram、Discord、微信、Slack 等 15+ 平台：

hermes gateway setup # 交互式配置
hermes gateway run # 前台运行
hermes gateway install # 安装为系统服务

五、语音功能

在 config.yaml 中添加：

voice:
 stt:
 enabled: true
 provider: local
 local:
 model: base
 tts:
 enabled: true
 provider: edge
 edge:
 voice: zh-CN-XiaoxiaoNeural

安装本地 STT：pip install faster-whisper

在聊天中发送 /voice on 启用语音模式。

六、Skills 管理

hermes skills list # 查看已装skills
hermes skills search \关键词\ # 搜索skills
hermes skills install identifier # 安装skill

七、Web UI 部署

npm install -g hermes-web-ui
hermes-web-ui start 8648 # 启动Web界面

配合 Nginx 反向代理即可对外提供 Web 访问。

常见问题

Q: 502 Bad Gateway？
A: 检查 hermes-web-ui 是否在运行，端口是否匹配 nginx 配置。

Q: 回复出现英文/配置内容？
A: 在 AGENTS.md 中添加强制中文和禁止输出文档的规则，并考虑升级模型。

Q: 语音不生效？
A: 确认 faster-whisper 已安装，voice 配置已写入，发送 /voice on 开启。