🛡 Hermes Agent 安装入门

第 3 篇 — 装一个能跑在微信/Telegram 上的全能 AI 管家

---

📋 前置检查

# 1. 检查 Python（版本 ≥ 3.10）
python3 --version
# 期望：Python 3.10.x 或更高

# 2. 检查 pip
pip3 --version

# 3. 检查 Git
git --version

# 4. 检查 curl（用来下载安装脚本）
curl --version

如果没有 Python 3.10+？

Ubuntu/Debian:

sudo apt update
sudo apt install python3 python3-pip python3-venv

macOS:

brew install python@3.12

Windows (WSL2):

# 同上 Ubuntu 操作

---

🚀 安装 Hermes Agent

一条命令安装：

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

这个脚本会自动检测你的系统，装好所有依赖。

安装过程中会发生什么：

1. 克隆 Hermes Agent 源代码

2. 创建 Python 虚拟环境

3. 安装所有 Python 依赖

4. 创建 ~/.hermes/ 配置目录

5. 把 hermes 命令加到 PATH

验证安装：

hermes --version
# 期望：显示版本号

hermes doctor
# 检查依赖和配置是否完整

---

⚙ 初始化配置

1. 运行配置向导

hermes setup

向导会引导你配置：

• 模型选择 — 用哪个 AI（推荐 DeepSeek）
• 终端设置 — 在哪执行命令
• 网关设置 — 接入哪些消息平台（微信/Telegram/...）

2. 手动配置模型

# 交互式选择模型和提供商
hermes model

或直接编辑配置文件：

hermes config edit

推荐配置（~/.hermes/config.yaml）：

model:
  default: "deepseek-v4-pro"
  provider: "deepseek"

agent:
  max_turns: 90

terminal:
  backend: "local"
  timeout: 180

display:
  show_reasoning: true
  show_cost: true

3. 设置 API Key

# 编辑环境变量文件
hermes config env-path
# 会显示 .env 文件路径

# 或直接创建（注意：这是覆盖写入，如果 .env 已有其他内容请手动追加）
cat > ~/.hermes/.env << 'EOF'
DEEPSEEK_API_KEY=sk-你的DeepSeek密钥
EOF

---

🔌 支持的 AI 提供商（20+）

Hermes 最大优势：一个软件，任意模型

切换模型很简单：

# 命令行切换
hermes model

# 或在对话中
/model deepseek-v4-flash

---

🎮 启动方式

方式 1：终端对话

# 交互式对话
hermes

# 一句话提问
hermes chat -q "帮我看看当前目录有什么文件"

# 加载特定技能
hermes -s web-search

方式 2：消息平台（微信/Telegram/Discord...）

这是 Hermes 的杀手级功能 — 让 AI 出现在你的聊天软件里。

# 配置网关
hermes gateway setup

# 启动网关
hermes gateway run

# 安装为后台服务（推荐）
hermes gateway install
hermes gateway start

支持的平台：

• 💬 微信 (Weixin) — 直接接入企业微信/个人微信
• 📱 Telegram — Bot API
• 🎮 Discord — Bot
• 💼 Slack — App
• 📧 邮件 — IMAP/SMTP
• 📶 Signal — 端到端加密
• 📱 WhatsApp — Business API
• 🏠 Home Assistant — 智能家居
• 🐧 钉钉 / 飞书 / 企业微信

---

📂 Hermes 的文件结构

~/.hermes/                    # Hermes 主目录
├── config.yaml               # 主配置文件
├── .env                      # API 密钥等敏感信息
├── skills/                   # 安装的技能
├── sessions/                 # 对话记录
├── logs/                     # 运行日志
│   └── gateway.log           # 网关日志
├── hermes-agent/             # 源代码
├── auth.json                 # 认证信息
└── profiles/                 # 多套配置（可选）
    └── default/

---

🧩 技能系统（Skills）

Hermes 的独特能力：用「技能」教它新东西

# 查看已安装技能
hermes skills list

# 搜索技能市场
hermes skills search "web search"

# 安装技能
hermes skills install web-search

# 浏览所有可用技能
hermes skills browse

常用技能推荐：

---

✅ 验证一切正常

# 1. 健康检查
hermes doctor

# 2. 试一次对话
hermes chat -q "请用中文介绍你自己，包括你的模型和框架名称"

# 3. 测试网关（如果配了）
hermes gateway status

---

🎯 实战：配置微信接入

# 正确顺序：先配网关，再装服务，最后启动

# 1. 配置微信
hermes gateway setup
# → 选择 Weixin → 按提示填入企业微信信息

# 2. 安装网关为后台服务
hermes gateway install

# 3. 启动

# 4. 检查状态
hermes gateway status

# 5. 看日志排查问题
tail -f ~/.hermes/logs/gateway.log

---

🚦 下一步

• 👉 深入配置 → 2026-05-08 Hermes Agent 配置与平台接入
• 👉 对比 Claude Code → 2026-05-08 Claude Code vs Hermes Agent 对比选型
• 👉 遇到问题 → 2026-05-08 常见问题与故障排除

---

💡 小白提示

---

❓ 常见问题 (FAQ)

Q1: Python 版本不够 3.10 怎么办？

Ubuntu 22.04+ 自带 Python 3.10+。如果是旧系统：sudo apt install python3.10 或 brew install python@3.12。不要卸载系统自带 Python，会搞崩系统。

Q2: 安装脚本 curl | bash 下载失败？

GitHub 在国内偶尔连不上。三种方案：① 开代理后重试；② 手动 git clone 再 pip install -e .（见 2026-05-08 常见问题与故障排除）；③ 换个网络环境试。

Q3: 装完后 hermes 命令提示 command not found？

安装脚本会自动加 PATH，但有时不生效。手动加：echo 'export PATH="$HOME/.hermes/hermes-agent/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc。

Q4: 安装占多大空间？

Hermes 本体 + Python 依赖约 500MB-1GB，不算大。

Q5: 为什么推荐 DeepSeek 而不是别的模型？

国内首选： 直接注册、支付宝付款、便宜、中文好。Hermes 支持 20+ 模型，后续想换随时 hermes model 切换。

Q6: 装完第一步做什么？

① hermes doctor 检查健康；② hermes chat -q "你好" 试试对话；③ hermes gateway setup 配置消息平台。

Q7: 能和 Claude Code 共存吗？

✅ 完全兼容。两个装在同一台机器上互不影响，还能让 Hermes 通过技能调用 Claude Code。

Q8: 安装脚本安全吗？

脚本来自 Nous Research 官方 GitHub，开源可审计。它会：克隆代码 → 创建虚拟环境 → 安装依赖 → 创建配置目录。不会碰你系统文件。

Q9: 能否不装系统服务、只在终端用？

能。跳过 hermes gateway install，直接用 hermes 进入终端对话模式。网关服务只是多平台接入才需要。

Q10: 怎么更新 Hermes？

hermes update 一条命令搞定。它会自动拉最新代码、更新依赖。

---

⚠ 安装过程中容易翻车的地方

---

标签：#AI #教程 #HermesAgent #安装 #开源