Hermes Agent安装完整指南(保姆级教程)

2026-04-14 14:52:53
文章摘要
这是一篇Hermes Agent安装完整指南。

Hermes Agent 是由 Nous Research 团队开发的一款开源 AI 智能体。与普通的聊天机器人不同,它具备以下核心能力:

长期记忆:能记住你过去的所有对话。

自我进化:能在任务中学习并创建新技能。

实际执行:能真正帮你做事,如浏览网页、管理文件、执行命令等。

多端协同:支持连接 Telegram、飞书等,在手机上就能指挥工作。

官网文档(推荐收藏):

https://hermes-agent.nousresearch.com/docs/

GitHub 项目:

https://github.com/NousResearch/hermes-agent

准备工作


Windows 用户听我一句劝:别在 PowerShell 里硬刚,老老实实装个 WSL2。不然遇到各种编码和权限问题,会搞到你心态爆炸。

API 准备(重要):别傻乎乎去充 OpenAI 的官方余额,那个门槛高。新手直接去 OpenRouter.ai。注册就送点余额,里面集成了 200+ 种模型,你按量付费就行,Claude 和 Grok 都能调,还不用担心 IP 被 Ban。

支持系统:

Linux(推荐)

macOS

Windows + WSL2

必备条件:

一台联网电脑

一个大模型 API Key(推荐使用 OpenRouter,它支持 Grok、Claude、GPT 等多种模型,且有免费额度)

获取 API Key 步骤(以 OpenRouter 为例):

访问 https://openrouter.ai/ 注册账号。

充值少量额度(几美元足以测试)。

在 Dashboard 中复制你的 API Key。

一键安装指南


打开你的终端(Terminal),我们一条龙解决。

第一步:无脑安装脚本

这是官方给的传送门,自动检测环境,30 秒装好。

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

跑完之后,重点来了,一定要刷新一下配置文件,不然终端不认识 hermes 这个命令:

source ~/.bashrc
# 或者如果你用的是 zsh
source ~/.zshrc

验证一下装没装上:

hermes --help

看到一长串命令列表,恭喜,地基打好了。

第二步:喂饭式初始化配置 输入 hermes setup,它会一步步问你。

  1. 问你 Provider:选 OpenRouter。
  2. 问你 API Key:把你在 OpenRouter 后台复制的长串字符粘进去(记得前面带 sk-or-v1-...)。
  3. 问你模型:新手无脑选 Claude 3.5 Sonnet 或者 GPT-4o-mini。别一上来就用本地 Ollama,先把路走通再折腾本地模型。

首次配置向导


只在终端里用太屈才了。让它接入 Telegram,才是这个的正确打开方式。

去 Telegram 搜 @BotFather,发送 /newbot,按提示起名,拿到 Token。

回到终端,把 Token 喂给它:

hermes config set TELEGRAM_BOT_TOKEN "这里粘贴你的Token"

前台启动网关:

hermes gateway telegram

看到控制台刷出一行 Connected... 的日志,掏出手机,给你的 Bot 发个 /help。 完美。现在你有一个 24 小时在线的、懂你的、会进化的私人管家了。

常用命令速查

hermes:进入交互聊天模式

hermes setup:重新启动配置向导

hermes model:切换模型

hermes tools:配置可用工具

hermes config set KEY 值:设置特定配置项

hermes claw migrate:从 OpenClaw 一键迁移数据

小白常见问题排查


安装卡住了? 可能是网络问题,请多等一会儿。若速度太慢,请检查网络环境。

没有 API Key 怎么办? 优先使用 OpenRouter 的免费额度。或者配置本地模型 Ollama(需电脑性能较强)。

想实现 24/7 在线? 你的电脑关机它就掉线。真想 7x24 用,去 RackNerd 或者 DigitalOcean 买台最便宜的 Linux VPS,用 screen 命令挂个后台。别用家里电脑硬扛,电费都不止那几刀。

从 OpenClaw 迁移? 如果你以前是 OpenClaw 用户,直接跑 hermes claw migrate,记忆无缝衔接,眼泪都要流下来。

关于安全,虽然它很强,但别上来就给它 sudo 权限。在 hermes tools 里把那些危险命令先禁用,让它先从“查看文 件”、“写周报”这种脏活累活干起。

学习更多? 查看官方文档:https://hermes-agent.nousresearch.com/docs/ 在 B 站或 YouTube 搜索 “Hermes Agent” 观看实操教程。


关注塔猴公众号,扫码下载塔猴APP,查看更多干货

扫码加入官方社群



声明:该内容由作者自行发布,观点内容仅供参考,不代表平台立场;如有侵权,请联系平台删除。
标签:
开源项目
智能体(Agent)
对话式 AI
模型部署