5 分钟跑通第一个 Hermes：安装、启动与第一句对话

上篇我们把”为什么要数字员工”讲透了。这篇不废话，直接把它跑起来。5 分钟，你拥有的不再是个白纸聊天框，而是一个装在本地、能记住你、能动手干活的 Agent。

而且对中国用户有个好消息：中文社区 hermesagent.org.cn 提供了一个开箱即用的中文桌面版——不用配 WSL、不用手工装 Python/Node，下载双击就跑。下面先把这条路讲透，再给你完整的其他方式备选。

一、中国用户的福音：中文社区桌面版（最省心）

中文社区（hermesagent.org.cn）维护了一个开源的 Hermes 中文桌面版，技术栈是 Tauri V2 + Rust + React，当前版本 v0.7.0（内置运行时 runtime-v0.19.0-cn.7），覆盖 Windows / macOS / Linux。

它为什么对中国用户友好：

• 内置运行时，零环境配置：安装包里直接带了 Hermes 内核、MCP、IM SDK、Node 与 TUI。无需 WSL，也无需手工配 Python 与 Node。
• 针对中国网络环境优化（据社区自述）：优先支持国内模型服务商、国内镜像回退、Anthropic 协议中转兼容；Windows 下用系统 PowerShell 而非 Git Bash，修复了 GBK 乱码等老问题。
• 桌面端开箱即用：集中呈现对话/文件、Skills/记忆/MCP 管理、模型配置、运行状态四大区。

⚠️ 诚实提示：这是社区开源构建，不是 Nous Research 官方签名发布的版本。首次打开可能被 Windows SmartScreen 或杀软拦截（站点自己也承认）。下载后请核对发布者、版本与 SHA-256 再运行；如被误杀，去杀软隔离区放行即可。它和官方 Electron 桌面版（hermes desktop 命令启动的那个）是两个不同的软件，别混为一谈。

下载与安装

国内网盘备用（仅 Windows）：百度网盘 https://pan.baidu.com/s/1YrCijCHjA6qUzHfcKNKCMw?pwd=9545（提取码 9545）、夸克网盘 https://pan.quark.cn/s/5296160f01b1。

Windows 安装版提供了 SHA-256 校验值：

SHA-256: 4704102dff97e4517b44f02a26757df6dbdb342ac8e223e5e4c30b8286a4198c

# Windows 下校验（建议跑一下再安装）
Get-FileHash .\Hermes.Agent.CN.Desktop_0.7.0_x64-setup.exe -Algorithm SHA256

安装后打不开？先去杀软/系统安全工具的隔离区看是否被误杀。macOS / Linux 的六个产物站点未提供校验值，下载后请自行确认来源可靠。

首次启动三步：选择模型服务商 → 填入 API Key → 新建一条任务。就这么简单，无需碰命令行。

下面以 Astral API Platform（https://api.chatallais.com）为例，走一遍「注册拿 Key → 在 Hermes Desktop 里填好」的完整流程。

第一步：注册并创建 API Key

打开 https://api.chatallais.com 注册账号，登录后进入左侧 常规 → API 密钥，点击右上角 「+ 创建 API 密钥」。给密钥起个名字（比如 Hermes），创建成功后复制完整的 sk- 开头密钥——只显示一次，务必当场保存。

第二步：在 Hermes Desktop 添加自定义服务商

回到 Hermes Desktop，按界面提示选择「添加自定义服务商」，逐项填入：

填好后点击 「添加并选中」，Hermes 就会用这个服务商作为默认模型来源。

💡 小提示：Base URL 末尾的 /v1 不要漏；如果刷新模型列表失败，先检查网络能否访问 api.chatallais.com，再确认 API Key 是否复制完整。配置成功后，直接 新建一条任务 就能开始第一句对话了。

二、安装方式怎么选

平台支持层级（以官方文档为准）：Tier 1 = macOS Apple Silicon、Windows 10/11、Linux(x86_64/aarch64)、WSL2、Docker；Tier 2 = Termux(Android)、Nix。别在 Intel x86 老 Mac 上硬刚。

三、三种安装方式实操

方式 A：中文桌面版（GUI，最省心）

下载安装包 → 双击安装 → 打开后选模型服务商、填 API Key、新建任务。内置运行时已就绪，无需任何前置环境。

方式 B：curl 国内镜像（Linux / macOS / WSL2 / Termux）

中文社区提供了国内镜像加速的安装脚本（res1.hermesagent.org.cn），优先走国内可直连链路：

# ⚠️ 安全两步法：先下载、审阅、再执行，别盲目管道执行第三方脚本
curl -fsSL https://res1.hermesagent.org.cn/install.sh -o hermes-install.sh
less hermes-install.sh          # 确认无异常
bash hermes-install.sh
source ~/.bashrc                # 或 source ~/.zshrc
hermes                          # 启动聊天

镜像安装器默认精简了部分国外功能（浏览器自动化、Chromium、WhatsApp 桥接等）。如果你需要这些，用官方源： curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

它会自动克隆仓库到 ~/.hermes/hermes-agent/，把 hermes 软链到 ~/.local/bin/hermes，全程不需要 sudo。非 Windows 只需 Git；Linux 额外需要 curl + xz-utils（sudo apt install curl xz-utils）。

方式 C：PowerShell（Windows 原生）

# 社区镜像
irm https://res1.hermesagent.org.cn/install.ps1 | iex
# 或官方源
iex (irm https://hermes-agent.nousresearch.com/install.ps1)

原生安装目录是 %LOCALAPPDATA%\hermes。

方式 D：Docker（可选，适合常驻 / 服务器）

docker pull nousresearch/hermes-agent:latest

# 首次交互式 setup
mkdir -p ~/.hermes
docker run -it --rm -v ~/.hermes:/opt/data nousresearch/hermes-agent setup

# 网关常驻（后台）
docker run -d --name hermes --restart unless-stopped \
  -v ~/.hermes:/opt/data -p 8642:8642 \
  nousresearch/hermes-agent gateway run

⚠️ Docker 内不支持 hermes update，升级要 docker pull 后重建容器（数据目录 ~/.hermes 已挂载，不会丢）。

四、最快路径：把模型接好

不管用哪种方式装的，跑通模型这一步都建议走最简路径：

• 桌面版：在 GUI 里选服务商 + 填 API Key 即建任务（见上方截图）。
• CLI：用 Portal OAuth 一条命令搞定（浏览器登录、写令牌、选模型、开 Tool Gateway 全自动）：

hermes setup --portal     # 完成 Portal OAuth 登录，写为默认 provider，并启用 Tool Gateway
hermes portal status      # 检查状态
hermes chat               # 进对话

无头 / SSH 远程机器，用 ssh -L 端口转发把 OAuth 转到本地浏览器即可。如果你不想用 Portal，也可以 hermes setup 走通用向导，或手动在 ~/.hermes/config.yaml + ~/.hermes/.env 里填 provider 与 key。

五、源码与数据在哪：~/.hermes

所有东西都落在 ~/.hermes（Windows 原生是 %LOCALAPPDATA%\hermes）。这一篇你先认得它就行，目录结构第 03 节会拆开讲：

~/.hermes/
├── config.yaml     # 配置项（模型、终端、TTS、压缩等）
├── .env            # API 密钥与敏感信息
├── auth.json       # OAuth 提供商凭证（Nous Portal 等）
├── SOUL.md         # 主 Agent 身份（系统提示第 1 槽位）
├── memories/       # 持久记忆（MEMORY.md、USER.md）
├── skills/         # Agent 创建的技能
├── cron/           # 定时任务
├── sessions/       # 网关会话
└── logs/           # 日志（自动脱敏）

记住：你的记忆、技能、配置、会话全在这里，自托管 = 数据不出本机。

六、三种工作模式

Hermes 不是只有一种玩法：

补充：从文件读提示 hermes chat --query-file PATH（- 表示 stdin）；恢复会话 hermes -c（最近）/hermes -r "标题"（按 ID/标题）。

七、首次运行：让 AI 当场”记住你”

进对话后，第一件事不是问”你好吗”，而是录入你的个人基础信息——这就是第 03 节要讲的 MEMORY.md 的初稿，也是第 05 节深度记忆管理的前奏。直接跟它说：

我是做后端开发的，主力语言 Go 和 Python，团队用 PostgreSQL + Redis，
讨厌过度设计的代码，喜欢直接给结论。请把这些记下来。

它会在会话中通过 memory 工具把这条写进持久记忆。下一章再开，它已经带着这些认知开工——这就是从”临时工”变”同事”的那一下。

你也可以在 config.yaml 里显式打开记忆（第 05 节会深挖）：

memory:
  memory_enabled: true
  user_profile_enabled: true
  memory_char_limit: 2200    # 约 800 tokens
  user_char_limit: 1375      # 约 500 tokens

第一句对话也可以直接验证记忆是否生效：

你还记得我用什么数据库吗？

如果它答得出 PostgreSQL + Redis，恭喜，你的数字员工已经有记忆了。

八、避坑提示（⚠️ 全是真坑）

• Python 版本：硬性要求 Python ≥ 3.11。中文桌面版 / 镜像安装器会自动处理；用老版本会直接起不来。
• SmartScreen / 杀软误报：中文桌面版可能触发拦截（社区开源构建、未官方签名），核对 SHA-256 后放行即可。命令行方式下，Defender 也可能把 uv.exe 当病毒，加个排除项：Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\hermes\bin"。
• 镜像安装器裁剪：国内镜像默认不含浏览器自动化 / Chromium / WhatsApp 桥接，需要这些的改用官方源。
• 本地模型吃显存：想跑本地模型（Ollama 等），需要足够 GPU 显存、上下文至少 64000。显存不够就走 Nous Portal / OpenRouter 云端模型，别硬上。
• Windows 编码坑：写文件容易踩 cp125x 编码导致 UnicodeEncodeError，中文输出时显式用 encoding="utf-8"。
• 别急着 --yolo：--yolo 跳过危险命令审批，仅限可信环境。个人开发用默认 approvals.mode: smart 更安全。

九、本节能造出什么数字员工

跑完这篇，你已经拥有一个最基础的个人助理数字员工：

• 它住在你本机（或你信任的服务器），数据不出门；
• 它已经接好模型和云端工具（Portal 或你填的 Key）；
• 它已经记住了你的技术栈和偏好；
• 你可以用 hermes chat 随时派活，用 hermes -z "..." 把它塞进脚本自动跑。

这还只是”裸装”。下一篇我们拆开它的”大脑结构”——Profile、Memory、Skills 三大基石。

十、下篇预告

《拆开数字员工的”大脑结构”：Profile、Memory、Skills 三大基石》。我会用一张目录树告诉你 ~/.hermes 里到底装了什么，讲清每个 Profile 为什么是独立的”工位”，以及为什么先跑通单个 Profile，再谈扩展是新手最稳的路线。

延伸阅读

• 中文社区文档：https://hermesagent.org.cn/docs
• 中文桌面版下载：https://hermesagent.org.cn/desktop
• 官方文档：https://hermes-agent.nousresearch.com/docs
• GitHub：https://github.com/NousResearch/hermes-agent