FollowAgents AI AGENTS 目录
首页/ 横向对比/ Hermes Agent 安装与首次使用指南

返回 Hermes Agent 介绍与源码审查 →

安装与使用指南

Hermes Agent 安装与首次使用指南

安装 Hermes Agent，用 Nous Portal 或自己的 API key 接入模型，弄清命令审批和本机执行的默认设置，再安全地接入 Telegram、Discord 等聊天软件，均链接官方文档。

文档核验

核验日期：2026-10-20。本文依据 Hermes Agent 官方文档整理，本站尚未在新版 Hermes 上完成安装实测。Hermes 发版很频繁（核验时为 v0.22.2），命令以文中链接的官方页面为准。

Hermes Agent 是 Nous Research 开源的个人 Agent，和 OpenClaw 属于同一类：装在你自己的电脑或服务器上，可以在终端里对话，也可以接到 Telegram、Discord、Slack 等聊天软件里，替你执行命令、查资料、处理文件。正因为它能直接在你的机器上跑命令，第一次用时要先弄清三件事：模型从哪来、谁付费，它执行命令前会不会问你，以及接上聊天软件后谁能给它下指令。本文按安装 → 模型 → 安全 → 聊天渠道的顺序讲。

如果你还在比较工具，先看 Hermes Agent 的功能、适用场景与源码审查结果，或 OpenClaw 与 Hermes Agent 怎么选。

第一步：安装

macOS（仅 Apple Silicon）和 Windows 可以直接下载官网的 Hermes Desktop 安装包，里面同时带命令行和桌面应用。只要命令行的话：

Linux、macOS、WSL2：

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Windows 原生 PowerShell：

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

安装脚本会自己准备 uv、Python 和 Node.js 等依赖，不需要提前装 Python；Linux / macOS 只需要有 Git、curl、tar。默认还会装上浏览器和电脑操作工具，不想要可以加 --skip-browser、--skip-computer-use（PowerShell 用 -SkipBrowser、-SkipComputerUse）。程序装在 ~/.hermes/hermes-agent/，你的配置和数据在 ~/.hermes/（Windows 是 %LOCALAPPDATA%\hermes\）。

装完重新加载 shell（如 source ~/.zshrc），出问题先运行 hermes doctor，它会告诉你缺什么、怎么补。见 官方安装文档。

第二步：接入模型

运行设置向导：

hermes setup

向导提供三种方式：

方式 适合谁 说明
Quick Setup（Nous Portal） 想一次登录就能用 Nous Research 的订阅服务，一次登录同时拿到模型和联网搜索、生图、语音、云端浏览器等工具；按订阅收费，价格见 Portal 页面
Full Setup（自带 key） 已有 OpenRouter、OpenAI、Anthropic 等账号 填自己的 API key，按各家价格计费
Blank Slate 想从最少的功能开始 只开最小工具集，其他全部关闭

之后随时可以用 hermes model 换模型，或者直接写配置：

hermes config set OPENROUTER_API_KEY sk-or-...
hermes config set model anthropic/claude-opus-4.6

注意模型的上下文长度：官方要求至少 64K，小于这个值启动时会被拒绝。用本地小模型时最容易碰到这个问题。密钥写在 ~/.hermes/.env，其他设置在 ~/.hermes/config.yaml，hermes config set 会自动写到对的文件里。见 官方快速上手 和 Nous Portal 说明。

然后开始对话：

hermes --tui

hermes --tui 是官方推荐的新界面，hermes 是经典命令行；hermes -c 可以接着上一次会话。

第三步：弄清它能在你机器上做什么（重要）

Hermes 的命令默认在你自己的机器上直接执行，没有隔离（terminal.backend 默认是 local）。官方的保护措施是命令审批，按 官方安全文档：

  • approvals.mode 默认是 smart：由另一个模型判断风险，低风险命令自动放行，危险命令自动拒绝，拿不准的才来问你。
  • 想让每条危险命令都先问你，改成 manual：
hermes config set approvals.mode manual
  • 审批请求 300 秒没人回应就按拒绝处理；rm -rf /、fork 炸弹这类命令无论什么设置都会被拒绝。
  • --yolo、/yolo 或 approvals.mode: off 会跳过所有审批。不要在装有重要数据的机器上这么用。

更稳妥的做法是让它在容器里执行命令（需要先装好 Docker）：

hermes config set terminal.backend docker

第四步：接入聊天软件

先确认终端里的对话正常，再接聊天渠道：

hermes gateway setup     # 交互式配置平台
hermes gateway           # 启动网关
hermes gateway status    # 查看状态

Hermes 支持 Telegram、Discord、Slack、WhatsApp、Microsoft Teams 等 20 多个平台。接上之后，谁能给它发指令是最关键的设置：

  • 在 ~/.hermes/.env 里写白名单，例如 TELEGRAM_ALLOWED_USERS=123456789；GATEWAY_ALLOWED_USERS 对所有平台生效。
  • 没配置任何白名单时，默认拒绝所有人。陌生人私信会收到一个配对码，由你用 hermes pairing approve <平台> <配对码> 批准。
  • 官方不建议在正式环境用 GATEWAY_ALLOW_ALL_USERS=true，那等于把你的电脑交给群里的任何人。

见 官方聊天渠道文档。

日常维护

  • 更新：hermes update
  • 排错顺序（官方建议）：hermes doctor → hermes model → hermes setup → hermes sessions list → hermes --continue → hermes gateway status

Windows 用户注意

Hermes 支持 Windows 原生 PowerShell 安装，也支持 WSL2，官方没有偏向哪一种。原生安装的数据在 %LOCALAPPDATA%\hermes\；WSL2 里则和 Linux 一样在 ~/.hermes/。两边是各自独立的安装，配置不共享。也可以直接用官网的 Hermes Desktop 安装包。

常见问题

Hermes Agent 免费吗？ 软件本身开源免费（MIT 许可证，源码在 NousResearch/hermes-agent）。花钱的是模型和工具：Nous Portal 订阅，或者你自己的 API key。

和 OpenClaw 有什么区别？ 两者都是自托管的个人 Agent，都能接聊天软件。具体差异见 OpenClaw vs Hermes Agent，也可以看 个人 / 通用 AI Agent 排行榜。

能用 Hermes 4 模型吗？ 可以选，但官方说明 Hermes 4 是为对话调优的，工具调用不是它的强项，不建议在 Hermes Agent 里当主力模型。

在中国大陆能用吗？ 软件本身可以安装；能不能用取决于你接入的模型服务和聊天平台在当地是否可用。可以在 Full Setup 里填国内可访问的模型服务的 key，聊天渠道选当地能用的平台。

有哪些插件和配套项目？ 本站收录的 Web 界面、桌面端、技能包等见 Hermes Agent 详情页的“生态与扩展”。