「0基础AI应用入门 - HERMES篇」第三弹 - 安装 HERMES AGENT
目录
归类：操作指引 | HERMES
前置知识：已完成 第二弹 - 安装Ubuntu系统
阅读时间：约 4 分钟
读完这篇指南，你将学会： ✅ 打开并使用 Terminal（终端） ✅ 运行官方安装脚本部署 HERMES Agent ✅ 启动并访问 HERMES Agent 控制台
在完成 Ubuntu 系统的安装后，本文将指导你如何部署 HERMES Agent。
HERMES 官方提供了自动化安装脚本，该脚本会自动处理 Node.js 等依赖项的安装、SQLite 数据库的初始化以及安全沙盒的配置。
步骤正文#
第一步：更新系统并安装必要工具 (curl 和 git)#
在安装 HERMES Agent 之前，我们需要打开终端，确保 Ubuntu 软件源和系统软件是最新的，并安装后续需要的下载工具
curl和代码管理工具git。
操作方法：
- 打开终端：在 Ubuntu 桌面环境中，按下快捷键
Ctrl + Alt + T。 - 更新系统软件源：在弹出的终端窗口中，输入以下命令并按回车（如果提示输入密码，请盲打你的系统密码，输入时屏幕不会显示任何字符）：
# 更新软件，确保获取最新版本，-y 参数表示自动确认安装
sudo apt update && sudo apt upgrade -y
- 安装 curl 和 git：Ubuntu 更新完成后，继续输入以下命令并按回车：
# 同时安装 curl 和 git 工具，-y 参数表示自动确认安装
sudo apt install curl git -y
第二步：执行一键安装脚本#
操作方法：
- 确保电脑已连接至互联网。
- 在打开的终端中，输入或粘贴以下安装命令（终端内粘贴的快捷键为
Ctrl + Shift + V，或单击鼠标右键选择粘贴）：
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
- 按回车键执行该命令。
- 注：
curl命令用于从指定网址下载install.sh脚本文件，| bash管道符则将下载的脚本直接交由 bash 执行。
- 注：
- 安装程序将自动运行。在运行过程中，如果提示
[sudo] password for your_username:，请输入你登录系统时使用的密码（⚠️请注意 Linux 系统中输入密码时屏幕不会显示任何“*”或“●”字符，需要盲打密码中间不要出错，否则就要重新输入），然后按回车确认。 - 等待安装进度完成，通常需要 3 到 5 分钟。
第三步：傻瓜式初始化配置 (hermes setup)#
目前最新版本的 HERMES Agent 安装完成后会自动进入一个交互式的配置向导。请注意，这里不支持鼠标点击，你需要使用键盘的**上下方向键（↑/↓）来移动选项，用回车键（Enter）**来确认。请跟着以下傻瓜步骤一步步操作：
操作方法：
配置方法：1.快速配置 2.完全配置
- 终端显示：
How would you like to setup Hermes? - 使用键盘的
↓键，将高亮光标移动到第二项Full Setup上，然后按回车键 (Enter) 确认。
- 终端显示：
模型配置：选择你的 AI 模型提供商。这里我们以 Minimax 中国版为例配置。
第 1 步：选择模型提供商 (Model Provider)
- 终端显示：
? Select provider: - 使用键盘的
↓键，将高亮光标移动到Minimax China (domestic direct API)上，然后按回车键 (Enter) 确认。（如果还没有账号，请参考这篇文章：Minimax 中国版账号申请）。
- 终端显示：
第 2 步：输入 API Key (密钥)
- 终端显示：
MINIMAX_CN_API_KEY (or Enter to cancel): - 将你在官网申请到的一长串字母数字混合的密钥复制下来。回到终端，按下快捷键
Ctrl + Shift + V粘贴，按回车键 (Enter) 确认。 - ⚠️ 避坑警告：在 Linux 终端里粘贴密钥时，屏幕上什么都不会显示（连星号都没有），不要以为没贴上而反复尝试！粘贴一次后，直接按下回车键 (
Enter) 即可。
- 终端显示：
第 3 步：输入Base Url
- 终端显示：
BASE_URL [https://api.minimaxi.com/anthropic]: - 这里直接按回车键 (
Enter) 使用这个默认地址。
- 终端显示：
第 4 步：选择默认的大语言模型 (Default Model)
- 终端显示：
Select default model: - 列表里会出现所有可用模型。这里选择主力模型
MiniMax-M2.7，按回车键 (Enter) 确认。
- 终端显示：
第 5 步：设置模型轮换
- 终端显示：
Same-Provider Fallback & Rotation - 如果你的用量很大，可能需要轮换使用几个账号。本文中我们不开启，直接按回车键 (
Enter) ，保持默认(不开启模型轮换功能)。
- 终端显示：
** 选择 TTS 模型**
- 终端显示：
Select TTS provider: - TTS 是 Text-To-Speech（文本转语音） 的缩写，即语音合成。列表里会列出所有可用的 TTS 模型。除非有特殊需求，这里选择免费且无需设置的默认模型
Keep current (Edge TTS)，按回车键 (Enter) 确认。
- 终端显示：
** 终端后端配置**
- 终端显示：
Select terminal backend: - Hermes 支持六种终端后端。每种后端决定了 Agent 的 shell 命令实际执行的位置。这里选择默认的
Keep current (local)，按回车键 (Enter) 确认。
- 终端显示：
** 其他设置 (Agent Settings)**：这里可以配置一些其他选项，比如迭代预算压力、开启本地记忆、开启安全沙盒等。
第 1 步：迭代预算压力 (Maximum tool-calling iterations per conversation)
终端显示：
Max iterations[60]:Agent 在处理复杂任务并进行大量工具调用时，每轮对话允许的最大迭代次数，默认为60轮。这里直接回车保持默认。
第 2 步：显示设置 (Tool Progress Display)
终端显示：
Tool Progress mode[all]:在消息平台中，后台工作时是否显示工具调用进度。这里直接回车保持默认(每次工具调用均显示简短预览)。
第 3 步：上下文压缩 (Context Compression)
终端显示：
Compression threshold (0.5-0.95) [0.5]:Hermes 会自动压缩长时间对话，这里设置压缩的阈值(越大则保留越长的上下文)，默认为0.5。这里直接回车保持默认。
第 4 步：对话重置方式 (Session reset mode)
终端显示：
Session reset mode:长时间无输入 + 每日固定时间重置。直接按回车键 (
Enter) 选择默认。
然后继续回车设置超时时长为默认 (1440分钟)，然后输入每天自动重置时间 (默认04:00)。
消息平台设置
- 终端显示：
Select platforms to configure: - 列表里会出现所有可用的消息平台。这里我们选择飞书
Feishu / Lark，按回车键 (Enter) 确认。
- 终端显示：
工具设置 (Tools for CLI)：选择要配置的工具，这里保持默认直接回车，之后每一项都可以暂时跳过，之后申请了对应的API Key之后再设置。
结束 输入
n确认结束。
常见问题#
Q1：执行安装命令时，提示 curl: command not found 或 git: command not found 怎么办？
- 【错误原因】：系统中未正确安装或找不到
curl或git工具（可能在第一步中安装失败或被跳过）。 - 【修复思路】：重新通过系统的包管理器（apt）下载并安装缺失的依赖工具。
- 【解决办法】：在终端中依次运行
sudo apt update和sudo apt install curl git -y，安装完成后重新执行第二步的安装脚本。
Q2：安装过程中报错，提示网络连接超时（Timeout）？
- 【错误原因】：由于网络连接不稳定，导致从官方服务器下载脚本或依赖失败。
- 【修复思路】：中断当前的卡死进程，并重新尝试连接。
- 【解决办法】：在终端中按
Ctrl + C终止当前操作，随后重新粘贴并运行安装命令即可。
Q3：每次开机都需要手动输入 hermes start 来启动吗？
- 【错误原因】：默认情况下，程序只在当前终端会话中运行，关闭终端或重启系统后会退出。
- 【修复思路】：将 HERMES 注册为系统的后台服务，使其能够开机自启并在后台持续运行。
- 【解决办法】：在终端中执行
hermes service enable，将 HERMES 设置为系统服务。
结语#
至此，你已成功在本地环境中部署了 HERMES Agent。在下一篇指南中，我们将开始探索配置飞书消息渠道，以便直接利用飞书与 Hermes 进行对话。
这里还没有任何文章可以列出。