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 秒装好。
跑完之后,重点来了,一定要刷新一下配置文件,不然终端不认识 hermes 这个命令:
验证一下装没装上:
看到一长串命令列表,恭喜,地基打好了。
第二步:喂饭式初始化配置 输入 hermes setup,它会一步步问你。
- 问你 Provider:选 OpenRouter。
- 问你 API Key:把你在 OpenRouter 后台复制的长串字符粘进去(记得前面带
sk-or-v1-...)。 - 问你模型:新手无脑选 Claude 3.5 Sonnet 或者 GPT-4o-mini。别一上来就用本地 Ollama,先把路走通再折腾本地模型。

首次配置向导
只在终端里用太屈才了。让它接入 Telegram,才是这个的正确打开方式。
去 Telegram 搜 @BotFather,发送 /newbot,按提示起名,拿到 Token。
回到终端,把 Token 喂给它:
前台启动网关:
看到控制台刷出一行 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,查看更多干货
扫码加入官方社群


