夜雨聆风字数：约 3,000 字 · 阅读时间：8 分钟
如果你是 AI 开发者或者效率工具控，最近肯定听过 AI Agent 这个词。Claude Code、OpenAI Codex、Cursor……它们本质上都是让 AI 直接操作终端和文件。
Hermes Agent 是 Nous Research 开源的同类型产品。它跟 Claude Code 平级，但有三个核心差异：开源免费（MIT 协议）、多平台网关（一个代理跑在 Telegram/Discord/Slack 等 10+ 平台）、跨会话记忆（记得你是谁和你的偏好）。
以下是中国大陆环境下的完整安装指南。每一步都有备选方案，不会因为 GitHub 连不上就卡死。
🚀 第一步：安装
海外用户一条命令：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
中国大陆用户 —— 三个坎，逐个破：
坎一：raw.githubusercontent.com 被污染
加 hosts 或走镜像：
echo "185.199.108.133 raw.githubusercontent.com" >> /etc/hosts# 或直接用镜像wget https://ghproxy.net/https://raw.githubusercontent.com/.../install.shbash install.sh
坎二：GitHub 克隆慢
等 install.sh 卡住后 Ctrl+C，手动用镜像克隆：
git clone https://ghproxy.net/https://github.com/NousResearch/hermes-agent.git ~/.hermes/hermes-agentbash install.sh # 跳过已存在的目录
坎三：pip 安装依赖慢
装之前配好清华镜像：
pip config set global.index-url https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple
安装后验证：
hermes --version # 检查版本hermes doctor # 检查依赖完整性
🔑 第二步：配置 API Key
API 密钥存在 ~/.hermes/.env：
# 推荐方案一：DeepSeek（国内直连，便宜）DEEPSEEK_API_KEY=sk-xxx...# 推荐方案二：OpenRouter（模型最多，需代理）OPENROUTER_API_KEY=sk-or-v1-xxx...# 推荐方案三：通义千问 DashScope（国内直连）DASHSCOPE_API_KEY=sk-xxx...
选模型：
运行 hermes model 交互式选择。常用搭配：
▸ 日常用 — DeepSeek，便宜国内直连
▸ 代码 — Claude Sonnet 4，最强但贵
▸ 推理 — QwQ-32b，中等价格
💬 第三步：启动聊天
终端模式：
hermes # 交互式聊天hermes --resume last # 恢复上次会话
常用命令：
▸ /new — 新会话（切换模型后必须执行）
▸ /model — 查看/切换模型
▸ /quit — 退出
📱 第四步：接入 Telegram（最常用）
这是新手踩坑最多的地方，但也是 Hermes 最实用的功能——手机上随时给 AI 分配任务。
1. 获取 Bot Token
Telegram 找 @BotFather → /newbot → 取名 → 复制 token。
2. 启动网关
# 前台测试hermes gateway run# 后台服务hermes gateway installhermes gateway start
3. 三个天坑（必看）
🕳 坑一：匿名管理员
群里的匿名管理员，sender ID 是 12253623534，不是你的真实 ID。需要在 .env 里配置 TELEGRAM_GROUP_ALLOWED_CHATS。
🕳 坑二：中国无法直连 Telegram
启动网关前设代理：export http_proxy=http://127.0.0.1:7890，再 hermes gateway run。
🕳 坑三：网关自动重启后代理失效
systemd 服务需要把代理写入 service 文件的 Environment 字段，否则重启后不认终端环境变量。
🧠 新手五大误区
误区 1：装完就跑
装完直接 hermes → 没配 API Key → 报错退出。正确顺序：安装 → hermes doctor → 配 API Key → hermes model → 开用。
误区 2：切换模型后不重启
/model xxx 后必须 /new，否则工具列表还是旧模型的，调用必崩。
误区 3：记忆写满不知道
默认 2200 字符，写满了会自动删旧记忆。调大：hermes config set memory.memory_char_limit 5000
误区 4：Windows 上硬来
Hermes 依赖大量 Linux 工具，Windows 用户必须用 WSL2。
误区 5：不开代理跑 Telegram 网关
Telegram Bot API 在中国是被阻断的。不配代理，网关能启动但收不到任何消息。日志全是超时。
⚡ 5 分钟快速上手指南
海外用户：
curl -fsSL ... | bash # 安装echo 'OPENROUTER_API_KEY=xxx' >> ~/.hermes/.env # 配 Keyhermes model # 选模型hermes # 开用
中国大陆用户额外步骤：
▸ 安装前配 pip 清华镜像
▸ 遇到 GitHub 慢就加代理或镜像
▸ DeepSeek 国内直连，不需要翻墙
▸ Telegram 网关必须配代理
项目地址：github.com/NousResearch/hermes-agent（开源免费，MIT 协议）
关注获取更多 AI Agent 实战经验