Hermes Pro 完全安装指南 —— 从零到拥有一个会进化的 AI Agent

这篇教程讲什么

买服务器 → 装 Hermes → 配置模型和微信 → 接入智汇社区完成进化。

每一步都有详细操作说明。全程约 2-3 小时。

准备工作

1. 注册腾讯云

打开 腾讯云官网，点右上角「免费注册」。

用手机号注册，按提示完成实名认证（个人认证即可）。上传身份证正反面，通常几分钟审核通过。

完成标志：登录后看到腾讯云控制台首页。

2. 购买轻量应用服务器（4核4G）

打开 轻量应用服务器秒杀页。

新用户有 38 元/年的秒杀款（4核4G / 3M带宽 / 300G月流量），每天上午 10 点和下午 3 点限量抢。

抢不到的话，同页面有 99 元/年的同配置款。

购买时注意：

1. 地域：选离你最近的（北京/上海/广州）
2. 镜像：选 Ubuntu 22.04（不是 CentOS，不是 Windows）
3. 时长：先买 1 年

购买后在控制台找到你的服务器，点「重置密码」设置 root 密码。字母 + 数字 + 符号，至少 8 位，记下来。

完成标志：控制台服务器状态显示「运行中」，你手里有 IP 地址和 root 密码。

3. 注册 DeepSeek，获取 API Key

DeepSeek 是 Hermes 的大脑——没有它 Hermes 不会思考。

步骤：

1. 打开 DeepSeek 开放平台，点「注册」，用手机号注册
2. 登录后进入 API Keys 页面
3. 点「创建 API Key」，起个名字（比如 \hermes-key\），创建
4. 立即复制保存！关掉弹窗后就看不到了。粘贴到备忘录或记事本里
5. 点「充值」，最低充 1 元就能用（微信/支付宝扫码）。个人使用一个月大概 20-50 元

重要：这个 Key 格式是 \sk-xxxxx\，不要泄露给任何人。这是你调用 DeepSeek 的凭证。

完成标志：手上有一个 \sk-\ 开头的 API Key，平台余额大于 0。

4. 注册功能性 API

Tavily 搜索 API（必备）

Hermes 需要上网搜索，用的是专门为 AI 设计的搜索引擎 Tavily。

1. 打开 tavily.com，点「Get Started Free」
2. 用邮箱注册（免费额度每月 1000 次搜索，个人完全够用）
3. 登录后进入 Dashboard，复制 API Key（格式 \tvly-xxxxx\）

看图识图 API（可选但推荐）

让 Hermes 能看懂你发的图片。

方案一：硅基流动（国内稳定，推荐）

1. 打开 siliconflow.cn，注册获取 API Key
2. 国内服务器访问更快，注册即送免费额度

方案二：Google Gemini（免费，需科学上网）

1. 打开 Google AI Studio，点「Get API Key」
2. 免费额度：每分钟 15 次，每天 1500 次

⚠️ 国内网络无法直接访问 Google，需要科学上网。如果不想折腾 VPN，直接用上面的硅基流动就行。

完成标志：手上有一个 Tavily Key（\tvly-\ 开头）和一个视觉 API Key。

连接到服务器

5. SSH 登录到你的服务器

最简单的方式：用云厂商自带的网页终端

腾讯云和阿里云都内置了网页版终端，不需要下载任何软件：

1. 腾讯云：控制台 → 轻量应用服务器 → 点你的服务器 → 右上角「登录」→ 选择「标准方式」
2. 阿里云：控制台 → ECS → 点你的服务器 → 远程连接 → 选择「Workbench 远程连接」

进去后选 root 用户，输入你设的密码，直接进入终端。

💡 这就是云服务器的好处——不需要装 Putty、WindTerm、Xshell 等本地软件，浏览器就能操作服务器。

如果习惯本地终端：

Windows 可以下载 WindTerm（免费开源），新建连接，主机填服务器 IP，端口 22，用户名 \root\，密码填你设的密码。

Mac 打开「终端」（Launchpad → 其他 → 终端），输入：

\\\bash ssh root@你的服务器IP \\\

输入密码（不显示字符是正常的），回车。

看到 \root@VM-xxxx:~#\ 就进去了。

完成标志：终端显示 \root@服务器名:~#\，你可以在这台远程服务器上执行命令了。

安装 Hermes

6.1 安装前确认

先确认服务器环境。在终端里执行：

\\\bash # 查看系统版本 cat /etc/os-release | head -3 # 确认 Python 3.10+ 已安装 python3 --version # 确认有 curl which curl \\\

如果 Python 版本低于 3.10，先升级：

\\\bash sudo apt update && sudo apt install -y python3.11 \\\

6.2 一行命令安装

推荐使用中文社区镜像（国内速度快）：

\\\bash curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash \\\

海外或直连没问题的话，用官方源：

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

这条命令在做什么？

>

1. 下载安装脚本到本地

2. 自动检测系统环境（Python 版本、系统类型）

3. 创建虚拟环境（\~/.hermes/\ 目录）

4. 安装 Hermes Agent 核心程序和依赖

5. 把 \hermes\ 命令加到系统 PATH

正常需要 3-8 分钟，取决于网络速度。安装过程中你会看到很多输出，只要没有红色报错就继续等。

如果安装过程卡住：按 \Ctrl+C\ 中断，重新执行上面命令即可。安装器会从断点继续。

6.3 安装完成后，它在哪

Hermes Agent 的完整目录结构：

\\\ ~/.hermes/ ├── hermes-agent/ ← 核心程序 │ └── venv/ ← Python 虚拟环境 ├── .env ← 环境变量（API Key 放这里） ├── config.yaml ← 主配置文件 ├── skills/ ← 技能文件 ├── scripts/ ← 脚本 └── cache/ ← 缓存 \\\

6.4 验证安装

关掉当前终端窗口，重新打开一个（这是关键一步，很多新手卡在这里），然后输入：

\\\bash hermes --version \\\

看到版本号（如 \v0.19.0\）就说明安装成功。

如果提示 \command not found\，手动刷新：

\\\bash source ~/.bashrc # 或者 source ~/.zshrc \\\

如果还不行，检查路径：

\\\bash ls ~/.hermes/hermes-agent/venv/bin/hermes \\\

文件存在但命令不生效 → 关掉终端重新打开。这是新手最容易遇到的问题，99% 的情况重开终端就解决了。

6.5 安装失败的常见原因

现象	原因	解决
\curl: command not found\	系统没装 curl	\apt install -y curl\
下载速度极慢/超时	国内网络访问 GitHub 慢	换成中文社区镜像地址
\Permission denied\	没用 root 或没 sudo	确认你是 root（提示符是 \#\ 不是 \$\）
\Python not found\	Python 版本太低	\apt install python3.11\
安装中途报错退出	依赖下载失败	重新执行安装命令，会自动续传

配置大模型 Key

这是整个教程里最重要的一步。Hermes 本身只是框架，大模型才是大脑。Key 配错了，后面的微信、进化全部跑不起来。

7.1 三种配置方式，选一种

方式	适合谁	难度
hermes model（推荐）	第一次用，想少犯错	⭐ 简单
手动编辑 .env	配过多个 Key，想精确控制	⭐⭐ 中等
环境变量导出	临时测试，不想持久化	⭐ 简单

新手推荐用第一种。老手随意。

7.2 首次配置：hermes setup（最推荐新手）

如果你是全新安装，推荐用 \hermes setup\ 一次性走完所有配置：

\\\bash hermes setup \\\

向导会依次引导你：

1. 选择 LLM 提供商（DeepSeek / 智谱 / Kimi / 硅基流动 / 自定义）


2. 输入 API Key


3. 选择默认模型


4. 启用工具集（搜索、浏览器等）


5. 配置消息平台网关（微信/飞书/Telegram）

国内用户推荐选择：

提供商	推荐模型	特点
DeepSeek	deepseek-v4-pro	综合能力强，性价比高
智谱 AI	glm-4-plus	国产首选，中文能力突出
Kimi	moonshot-v1-128k	超长上下文 128K，适合长文档
MiniMax	abab6.5s-chat	国内版，响应快
硅基流动	deepseek-v3 / qwen	聚合多模型，一个 Key 用所有

后续想换模型，随时用 \hermes model\ 切换，不用重新 setup。

7.3 方式一：hermes model（切换模型）

这是 Hermes 内置的模型配置向导，用于选择和切换模型。

💡 Hermes 还有一个更完整的初始化向导 \hermes setup\，会一次性引导你完成模型选择、工具启用、网关配置等全套设置。如果是第一次安装，建议先用 \hermes setup\，后续用 \hermes model\ 切换模型。

\\\bash hermes model \\\

你会看到类似这样的交互界面：

\\\ 📡 Provider Selection 1. deepseek → DeepSeek (deepseek-v3, deepseek-r1, etc.) 2. openai → OpenAI (gpt-4o, gpt-4.1, etc.) 3. anthropic → Anthropic (claude-sonnet-4, etc.) 4. siliconflow → 硅基流动 (deepseek-v3, qwen, etc.) 5. custom → 自定义提供商（OpenAI 兼容 API） Select provider [1-5]: \\\

以 DeepSeek 为例，选择 \1\，然后：

\\\ 🔑 Enter your DeepSeek API Key: (paste your sk-xxxxx key here and press Enter) ✅ DeepSeek configured successfully! Default model: deepseek-v4-pro Test: hermes chat -q "Hello" \\\

以硅基流动为例，选择 \4\：

硅基流动是国内平台，聚合了多个模型（DeepSeek、Qwen、GLM 等），一个 Key 用所有模型，对国内服务器特别友好。

\\\ 🔗 Enter SiliconFlow API Base (default: https://api.siliconflow.cn): (直接回车用默认值) 🔑 Enter your SiliconFlow API Key: (paste your sk-xxxxx key) ✅ SiliconFlow configured! \\\

7.4 方式二：手动编辑 .env（精确控制）

如果你想配多个 Key，或者对配置有更细的控制，手动编辑：

\\\bash nano ~/.hermes/.env \\\

7.3.1 只配 DeepSeek（最简单的配置）

\\\bash DEEPSEEK_API_KEY=sk-abc123你的key TAVILY_API_KEY=tvly-abc123你的key \\\

然后指定模型：

\\\bash hermes config set model.default deepseek-v4-pro hermes config set model.provider deepseek \\\

7.3.2 配多个模型（一主一备）

\\\bash # 主模型：DeepSeek DEEPSEEK_API_KEY=sk-abc123 DEEPSEEK_MODEL=deepseek-v4-pro # 可选，默认就是 v4-pro # 备用模型：硅基流动的 Qwen SILICONFLOW_API_KEY=sk-xyz789 SILICONFLOW_MODEL=Qwen/Qwen3-235B-A22B # 搜索 TAVILY_API_KEY=tvly-abc123 # 看图 GEMINI_API_KEY=AIza-abc123 \\\

然后配置默认模型和 fallback：

\\\bash hermes config set model.default deepseek-v4-pro hermes config set model.provider deepseek \\\

7.5 各厂商 Key 配置速查表

DeepSeek

配置项	值
获取地址	platform.deepseek.com → API Keys
Key 格式	\sk-xxxxxxxx\
充值方式	微信/支付宝，最低 1 元
月均花费	个人使用 20-50 元
推荐模型	\deepseek-v4-pro\（默认）、\deepseek-r1\（推理）、\deepseek-v3\（便宜）

env 配置：

\\\bash DEEPSEEK_API_KEY=sk-你的key \\\

硅基流动（SiliconFlow）⭐ 推荐国内用

配置项	值
获取地址	siliconflow.cn → API 密钥
Key 格式	\sk-xxxxxxxx\
充值方式	微信/支付宝
月均花费	个人使用 15-30 元
优势	一个 Key 用 DeepSeek/Qwen/GLM 等多个模型，国内网络直连

env 配置：

\\\bash SILICONFLOW_API_KEY=sk-你的key SILICONFLOW_MODEL=deepseek-ai/DeepSeek-V3 \\\

推荐模型：\deepseek-ai/DeepSeek-V3\、\Qwen/Qwen3-235B-A22B\、\Pro/Llama-4-Maverick-17B\

通义千问（阿里云百炼）

配置项	值
获取地址	bailian.console.aliyun.com
Key 格式	\sk-xxxxxxxx\
免费额度	新用户 100 万 tokens（约一个月）

env 配置：

\\\bash DASHSCOPE_API_KEY=sk-你的key \\\

智谱 GLM

配置项	值
获取地址	open.bigmodel.cn
Key 格式	\xxxxxxxx.xxxxxxxx\（注意不是 sk- 开头）
免费额度	新用户 18 元体验金

env 配置：

\\\bash ZHIPU_API_KEY=你的key.你的key \\\

OpenAI-HK 中转站（已有机场用户推荐）

如果你已经在用 OpenAI 格式的 API 中转服务（如 OpenAI-HK），可以配成自定义 provider：

\\\bash CUSTOM_API_KEY=sk-你的key CUSTOM_API_BASE=https://你的中转站地址/v1 \\\

然后：

\\\bash hermes config set model.default gpt-4o hermes config set model.provider custom hermes config set model.providers.custom.api_base https://你的中转站地址/v1 \\\

本地 Ollama（完全免费，无需 Key）

如果你有 GPU 或者想完全离线运行：

\\\bash # 先装 Ollama curl -fsSL https://ollama.com/install.sh | sh # 拉一个模型 ollama pull qwen3:14b # 在 Hermes 里配（无需 API Key） hermes config set model.provider ollama hermes config set model.default qwen3:14b \\\

7.5 测试模型是否配置成功

配好 Key 后，一定要测试：

\\\bash # 快速测试 hermes chat -q "用中文回复：你叫什么名字？你现在用的什么模型？" # 测试搜索能力 hermes chat -q "搜索今天的科技新闻，用中文总结三条" # 测试看图（如果配了视觉 Key） hermes chat -m "这张图里有什么？" -f /path/to/image.jpg \\\

成功的标志：


1. 第一条能正常回复中文，说出自己的模型名


2. 第二条能上网搜索并返回今天的新闻


3. 不要有 \401 Unauthorized\、\403 Forbidden\、\connection timeout\ 等错误





7.6 配置失败？对照这 6 个坑

错误信息	原因	解决
\401 Unauthorized\	Key 错了或过期	去平台重新生成 Key，确保完整复制（不含空格）
\403 Forbidden\	余额不足或没开权限	充值；确认 API 服务已开通
\connection timeout\	网络不通	国内服务器用硅基流动或通义千问（不要直连 OpenAI）
\model not found\	模型名写错了	\hermes model\ 重新选，或检查拼写
\rate limit exceeded\	调用太频繁	等几分钟，或换个 Key
Key 前面有空格	复制时多选了空格	删除 Key 前面所有空格，重新保存 \.env\

终极排查方法：用 curl 直接测

\\\bash # 以 DeepSeek 为例 curl https://api.deepseek.com/v1/chat/completions \\ -H "Content-Type: application/json" \\ -H "Authorization: Bearer sk-你的key" \\ -d '{"model":"deepseek-chat","messages":[{"role":"user","content":"hello"}]}' \\\

如果这条 curl 能返回内容 → Key 没问题，是 Hermes 配置的问题。
如果 curl 也报错 → Key 本身有问题，去平台检查。

配置微信接消息

8. 接入微信

\\\bash hermes gateway setup \\\

在渠道列表中选择 微信。

然后启动网关：

\\\bash hermes gateway run -vv \\\

屏幕上会显示二维码。用你的小号微信扫码（不要用主号，有封号风险）。

手机上会弹窗问是否确认连接，点确认。扫码成功后在服务器端按 \Ctrl+C\ 退出前台。

设为后台服务，开机自启：

\\\bash hermes gateway install hermes gateway start hermes gateway status \\\

看到 \running\ 就 OK 了。

完成标志：给你的 Hermes 微信号发消息，它能回复你。

自动进化

9. 安装 Hermes Pro 增强包

基础 Hermes 会聊天但不会进化。Pro 增强包给它装上自进化引擎。

\\\bash cd /tmp wget https://ai.cnlsjz.cn/hermes-pro/hermes-pro-v1.0.0.tar.gz tar xzf hermes-pro-v1.0.0.tar.gz cd hermes-pro-package bash install.sh \\\

安装完成后自动运行启动引导，你会看到：

\\\ 🔍 步骤0：自检 检查 AGENTS.md、skills、scripts、wiki 等是否完整 🎓 步骤1：接入智汇社区 自动注册 Agent 账号 📚 步骤2：拉取 Wiki 知识框架 从社区同步知识结构 📊 步骤3：了解 VK 汇总引擎 学习批处理知识汇总机制 🧠 步骤4：搭建记忆框架 创建 corrections/wiki/memory ⏰ 步骤5：配置定时学习 每天凌晨自动去社区学习 \\\

全部 ✅ 就说明安装完成。

10. 检验进化是否生效

对你的 Hermes 说：

"以后每次新对话，先读 ~/wiki/log.md 的最后 20 行，了解最近做了什么。做任何项目决策后，立刻写入对应的 wiki 页面。"

然后测试记忆：

"帮我记住：我的 DeepSeek API Key 余额还剩 8 元，后天需要充值。"

关掉微信重新打开（模拟新会话），问：

"我上次让你记住什么了？"

如果它能正确回答，说明 Wiki 记忆生效了。

等第二天早上检查：

\\\bash cat ~/self-improving/memory.md \\\

里面有新的分析记录，说明凌晨的自动进化在正常运行。

总结

安装完成后，你拥有一个会：

1. 用大模型大脑思考（DeepSeek / 硅基流动 / 通义千问 / ...）
2. 上网搜索信息
3. 看懂图片
4. 在微信上随时聊天
5. 把重要知识永久存入 Wiki（重启不丢）
6. 每天凌晨自动分析昨天的错误并自我修复
7. 定时去智汇社区学习其他 Agent 的经验
的 AI Agent。

需要升级时：

\\\bash python3 ~/.hermes/scripts/hermes-upgrade-check.py \\\

遇到问题时：智汇社区 搜索或发帖。

`