0x00 起因※
之前一直用 AstrBot 跑 QQ 机器人，随着需求变多——要接多种模型、要跨平台（QQ/Telegram）、要持久记忆、要能干活（执行命令、操作文件、定时任务）——AstrBot 越来越不够用。换到 Hermes 后，这些全解决了。这篇记录 Hermes 是什么、Arch 上怎么装、怎么配置、怎么用。
0x01 Hermes 是什么※
Hermes Agent 是 Nous Research 开源的 AI 智能体框架。和传统的"聊天机器人"不同，它是一个真正的 Agent——能调用工具：执行 shell 命令、读写文件、搜索网页、操作浏览器、管理定时任务、发消息到各个平台。
几个关键特性：
- 单机架构：一切本地存储（SQLite），配置、会话、记忆都在
~/.hermes/，隐私可控 - 多平台：QQ、Telegram、Discord、Slack、微信等 20+ 平台，同一套 Agent 核心
- 技能系统：把干过的活沉淀成 skill，下次直接复用，越用越聪明
- 持久记忆：接 Seraph 记忆引擎，跨会话记得你是谁
- 模型无关：DeepSeek、智谱、OpenRouter、本地模型随便切，fallback 自动降级
0x02 Arch 安装※
Arch 上用 AUR 包 hermes-agent。注意这个包默认依赖 python311，构建很慢（20-30 分钟编 CPython）。本机改用了 pkgrel=2 本地重建，依赖 python312（archlinuxcn 有预编译，秒装），构建只要约 13 分钟：
# 安装依赖
sudo pacman -S --needed base-devel git
paru -S python312 # archlinuxcn 预编译
# 本地重建（~/aur/hermes-agent-312/）
git clone https://aur.archlinux.org/hermes-agent.git ~/aur/hermes-agent-312
# 改 PKGBUILD: python311→python312, python3.11→python3.12
makepkg -si # 构建 + 安装
安装后 Hermes 在 /opt/hermes-agent，venv 是 python312。
0x03 配置※
核心配置两个文件：
~/.hermes/config.yaml：模型、平台、工具、记忆等配置（受写保护，用hermes config set改）~/.hermes/.env：API 密钥（600 权限，热加载不用重启）
模型配置示例（主模型 + fallback 链）：
# config.yaml
model:
default: deepseek-v4-flash
provider: opencode-go
fallback_providers:
- model: glm-4.7-flash
provider: custom:zai-coding
- model: deepseek-v4-flash
provider: deepseek
密钥放 .env：DEEPSEEK_API_KEY=sk-xxx。配置好跑 hermes doctor 检查，hermes config check 看配置状态。
0x04 使用※
三种主要使用方式：
1. CLI 终端※
hermes # 交互式对话
hermes chat -q "问题" # 单次查询
hermes -r # 恢复最近会话
2. 消息平台※
装成常驻服务后，QQ/Telegram 直接发消息就是和 Agent 对话：
hermes gateway install # 装成 systemd user 服务
hermes gateway start
hermes gateway setup # 配置平台（QQ/Telegram 等）
平台里发 /new 开新会话、/status 看状态、/title 命名、/retry 重试——斜杠命令管理会话。
3. 能力调用※
对话里直接说就行：
- "查一下 xxx" → web 搜索
- "看看这个文件" → 文件读写
- "跑一下这个命令" → 终端执行
- "每天九点提醒我" → 定时任务
- "记住 xxx" → 存进记忆引擎
0xFF 跋※
这篇是 Hermes 系列的总览。后续还有：
