hermes portable

HermesPortable 是 Hermes Agent（Nous Research 出品）的"开箱即用"版本。

它把 AI 助手、Python 运行时、依赖库，和一个图形化配置页面全部打包在一个文件夹里。你什么都不用装，下载、解压、双击，就能在 macOS、Linux、Windows 上直接运行。

能做什么

功能	说明
智能对话	多行输入、流式回复、斜杠命令
接入聊天软件	Telegram / Discord / Slack / WhatsApp / Signal / 邮件
持久记忆	自动记录关键信息，跨会话保留上下文
内置工具	40+ 工具：网页浏览、搜索、文件操作、语音、定时任务…
模型供应商	支持 15+ 家（OpenRouter、Anthropic、OpenAI、Google、DeepSeek 等）
子代理	分身协作、并行处理任务

把 zip 文件解压到一个方便访问的位置。推荐：

系统	推荐位置
Windows	U 盘根目录，或 D:\HermesPortable
macOS	"应用程序" 文件夹，或桌面
Linux	用户主目录 ~/HermesPortable

解压完成后，找到对应平台的启动器，双击它。你不需要打开终端、不需要输任何命令。

接下来会发生什么

以后再次启动

下次用的时候，直接双击同一个启动器就行。Hermes 会读取上次保存的配置，跳过浏览器配置页面，直接进入对话。

进入对话之后，你可以在任何时候按 Ctrl+C 退出，然后在同一个终端里输入以下命令。

命令	说明
hermes	启动交互式对话
hermes -q "问题"	单次提问，回答完就退出
hermes model	切换使用的 AI 模型
hermes setup	重新进入配置向导
hermes gateway	管理消息网关（Telegram 等）
hermes config	查看、修改配置
hermes status	查看所有组件的运行状态
hermes doctor	自动诊断问题
hermes cron	管理定时任务
hermes skills	管理技能（Skills）
hermes sessions	管理历史会话
hermes memory	管理持久记忆
hermes auth	管理各家 API Key
hermes backup	备份 / 恢复数据
hermes logs	查看日志
hermes dashboard	打开 Web 仪表盘
hermes version	显示版本号
hermes update	更新 hermes-agent 到最新

启动对话

hermes                          # 进入对话窗口
hermes -q "帮我写一个冒泡排序"    # 单次问答
hermes --toolsets web,terminal  # 只启用指定工具

对话窗口里的"斜杠命令"

在对话里以 / 开头的就是斜杠命令，不会发给 AI 而是交给 Hermes 自己处理。

命令	说明
/new /reset	清空上下文，开一个新对话
/model [供应商:模型]	切换 AI 模型
/personality [名字]	切换 AI 的"人格"（见下）
/retry	重新生成上一轮回复
/undo	撤销上一轮
/compress	压缩上下文（当对话太长时）
/usage	查看 Token 用量
/insights [--days N]	查看过去几天的使用统计
/skills	查看已安装的技能
/stop	打断 AI 当前正在做的事
/sethome	设置 Hermes 的工作目录

AI 的"人格"

通过 /personality 切换 AI 的说话风格。比如 /personality pirate 让它变成海盗口吻。

最常用的办法：Web 配置中心

启动 Hermes 后，配置中心会一直在后台运行（端口 17520），打开 http://127.0.0.1:17520 即可：

命令行修改

命令	说明
hermes config show	显示当前配置
hermes config edit	用默认编辑器打开配置文件
hermes config set 键 值	设置单个配置项
hermes config path	显示配置文件的位置
hermes config check	检查配置是否有误

API Key 管理

命令	说明
hermes auth add	添加新的 API Key
hermes auth list	列出已保存的 Key
hermes auth remove	删除某个 Key
hermes auth status	查看 Key 是否有效

关键文件

文件	说明
data/.env	API Key 存放位置（必须配置）
data/config.yaml	主配置文件

支持的 AI 供应商

# 交互式切换模型（推荐）
hermes model

# 命令行直接指定
hermes config set model.default "anthropic/claude-opus-4.6"

Hermes 提供三种交互方式，全部内置，不需要额外安装。

Web 仪表盘（hermes dashboard）

基于 React 的浏览器管理界面，端口 9119。

# 启动仪表盘（自动打开浏览器）
hermes dashboard

# 仅启动后端 API（不打开浏览器）
hermes web --no-open

仪表盘包含三个页面：

• 状态页 — Agent 运行状态、活跃会话、最近会话、PID、内存占用
• 配置页 — 动态配置编辑器，从后端读取 schema 自动生成表单，改完保存即生效
• 环境变量页 — 管理所有 API Key，支持保存、清除、查看（Key 自动脱敏）

TUI 终端图形界面（hermes --tui）

基于 React + Ink 的终端 UI，在终端内提供图形化对话体验，无需浏览器。

hermes --tui

TUI 通过 JSON-RPC 与后端通信，支持完整对话交互、命令输入、实时流式输出。适合喜欢纯终端体验的用户。

对话查看器

启动 Hermes 后打开 http://127.0.0.1:17521，在浏览器中可视化浏览所有历史对话。

让 Hermes 在 Telegram、Discord、Slack、WhatsApp、Signal、邮件里当你的 AI 机器人。朋友发消息给这些平台上的 bot，Hermes 会自动回。

命令	说明
hermes gateway setup	图形化配置消息平台
hermes gateway start	启动网关
hermes gateway stop	停止网关
hermes gateway restart	重启网关
hermes gateway status	查看是否在运行
hermes gateway install	安装为系统后台服务（开机自启）

让 Hermes 每天早上 8 点读新闻摘要给你、每周一汇总一周工作，就用这里的命令。

命令	说明
hermes cron create	创建一个定时任务
hermes cron list	列出所有任务
hermes cron edit	编辑任务
hermes cron pause	暂停任务
hermes cron resume	恢复任务
hermes cron run	立即跑一次
hermes cron remove	删除任务
hermes cron status	查看调度器状态

技能（Skills）是打包好的"做某件事的流程"。比如"整理我的邮箱"、"生成周报"。你可以从社区安装，也可以让 Hermes 从经验中自动创建。

命令	说明
hermes skills browse	浏览可用技能
hermes skills search	搜索技能
hermes skills install	安装技能
hermes skills list	列出已安装
hermes skills inspect	查看技能详情
hermes skills update	更新技能
hermes skills uninstall	卸载技能
hermes skills publish	把自制技能发布到社区

Hermes 会自动保存每次对话。下面的命令让你管理这些历史记录。

命令	说明
hermes sessions list	列出所有历史会话
hermes sessions export	导出会话到文件
hermes sessions delete	删除某个会话
hermes sessions prune	清理旧会话
hermes sessions stats	查看统计
hermes sessions rename	重命名会话

更新到新版本（推荐：下载新 zip）

有新版本发布时，最简单的方法就是：

只更新内部 AI 引擎

如果只是想把核心引擎 hermes-agent 升级到最新，而不换整个便携包，可以用：

hermes update

等同于在终端里运行 python lib/update.py update。

备份数据

解压后打开文件夹，你会看到：

文件 / 文件夹	作用
Hermes.bat	Windows 启动器（双击运行）
Hermes.command	macOS 启动器（双击运行）
Hermes.sh	Linux 启动器
data/	你的所有数据（Key、对话、记忆、设置）
data/.env	API Key 文件（可手动编辑）
data/config.yaml	主配置
data/sessions/	对话历史
data/skills/	已安装技能
data/memories/	持久记忆
data/cron/	定时任务
data/logs/	运行日志（排错用）
_home/	沙箱目录（首次启动自动创建）
python/ venv/ node-*/	运行环境（别动）

以下方案均无需付费即可使用 AI 模型，按推荐程度排序。第一次用的话，强烈建议从方案一开始。

方案一：OpenRouter（最推荐）

注册账号就给免费 Key，支持多个免费模型，最适合新手。

免费模型	说明
openrouter/elephant-alpha	OpenRouter 自有模型
openrouter/owl-alpha	OpenRouter 自有模型
tencent/hy3-preview:free	腾讯 HY3
minimax/minimax-m2.5:free	MiniMax M2.5
nvidia/nemotron-3-super-120b-a12b:free	NVIDIA Nemotron
arcee-ai/trinity-large-preview:free	Arcee Trinity

方案二：Google Gemini 免费层

Google 提供免费额度，模型质量高，但有请求频率限制（短时间请求过多会被限流）。

方式 A：API Key

方式 B：浏览器登录，免 API Key

可用模型	说明
gemini-3.1-pro-preview	最强（额度有限）
gemini-3-pro-preview	次强
gemini-3-flash-preview	快，日常推荐
gemini-3.1-flash-lite-preview	最轻量

方案三：Nous Portal 免费层

Hermes 官方提供的免费模型入口，通过浏览器登录。

已知免费模型：xiaomi/mimo-v2-pro、minimax/minimax-m2.5:free 等。

方案四：Hugging Face 推理服务

每月 $0.10 的免费额度，可调用多种开源模型。

可用模型	说明
deepseek-ai/DeepSeek-V3.2	通用大模型
Qwen/Qwen3.5-397B-A17B	超大参数
Qwen/Qwen3.5-35B-A3B	轻量高效
moonshotai/Kimi-K2.5	Kimi 系列
XiaomiMiMo/MiMo-V2-Flash	小米 MiMo
MiniMaxAI/MiniMax-M2.5	MiniMax
zai-org/GLM-5	智谱 GLM

方案五：Qwen OAuth（通义千问）

方案六：本地部署（完全免费、完全离线）

在自己电脑上跑模型，不需要任何 API Key。适合有独立显卡的用户。

工具	配置	说明
Ollama	provider: "ollama"	最易上手
LM Studio	provider: "lmstudio"	图形界面
vLLM	provider: "vllm"	高性能
llama.cpp	provider: "llamacpp"	轻量 C++

# 以 Ollama 为例
ollama pull llama3.1
hermes config set model.default "ollama/llama3.1"

以下内容整理自花叔《Hermes Agent 橙皮书 2.0》（基于 v0.16.0），帮助你从"会用"到"理解它为什么这样设计"。