Hermes(爱马仕)保姆级部署教程
🐴 Hermes Agent Mac 部署完全指南
写给完全不懂技术的你,一步一步跟着做,保证能跑起来!
什么是 Hermes Agent?

用大白话说
你有没有用过 ChatGPT 或者 Claude?每次打开新对话,它对你一无所知。上次跟它说过”我是程序员、不喜欢废话、项目用 Python 写的”,下次又得重新说一遍——它什么都不记得。
Hermes Agent 就是为了解决这个痛点而生的。
Hermes 是一个会学习、会记忆、越用越聪明的 AI 智能体,由 AI 研究机构 Nous Research(就是做 Hermes 系列模型的那家)在 2026 年 2 月发布。它不是一个聊天框,而是一个真正能帮你干活的”AI 助手员工”:
- 它记得你是谁、你的项目是什么、你的习惯偏好
- 它能操作你的电脑、搜索网络、写代码、执行命令
- 它完成一个任务之后,会把经验总结成”技能”,下次遇到类似任务直接调用,不用从头想
- 它可以在你睡觉时自动执行定时任务,结果推送到你的微信 / Telegram / 钉钉
技术背景
Hermes Agent 本身是一个智能体框架(Agent Framework),它自己不是大语言模型,而是一个连接并驱动大语言模型的”大脑壳”。你需要给它配一个 AI 模型的 API Key(比如 DeepSeek、MiniMax、Claude、GPT 等),它来负责记忆、工具调用、任务规划、技能学习。
Hermes 能做什么?
🧠 持久记忆,认识你这个人
Hermes 会维护两个核心文件:
MEMORY.md:记录关于你的项目、环境、重要信息USER.md:记录你的偏好、习惯、沟通风格
每次对话,它都会把新学到的东西写进去。你告诉它”我们的数据库用 PostgreSQL,不要建议用 MySQL”,它下次就不会再给你推荐 MySQL 了。
🛠️ 70+ 内置工具,真正能干活
💻终端执行
运行 shell 命令、查磁盘、安装软件,像人一样操作电脑
📁文件操作
读写文件、搜索代码、批量重命名,处理复杂文件任务
🔍网络搜索
搜索最新信息、抓取网页内容,实时获取最新资讯
🌐浏览器自动化
填表、截图、抓取动态网页数据,完全替代人工点击
🖼️图像生成
用 FLUX / GPT-Image 等模型生图,支持 9 种图像模型
🎙️语音交互
说话输入、语音回复,支持实时语音对话模式
📚 技能系统(Skills),越用越聪明
这是 Hermes 最核心的特性。每次你让它做一个复杂任务,它完成之后会自动:
- 分析这次任务是怎么解决的
- 把解题思路提炼成一个”技能”文件
- 下次遇到类似任务,直接调用这个技能,又快又准
💬 连接 20+ 消息平台
国内常用:微信(WeChat)、企业微信(WeCom)、钉钉(DingTalk)、飞书(Feishu)、QQ Bot
国际通用:Telegram、Discord、Slack、WhatsApp、Signal、Email、Microsoft Teams
⏰ 定时自动化任务
支持自然语言或 cron 表达式设置定时任务。比如:
- “每天早上 8 点发最新的AI资讯,发到我的微信”
- “每周五下午 5 点生成本周工作报告”
🔄 子智能体并行
可以同时派出多个”子 Hermes”并行处理不同任务,然后汇总结果。默认支持 3 个并发子智能体。
Hermes(爱马仕)和 OpenClaw(龙虾):有什么区别?
先说 OpenClaw 是什么
OpenClaw(有人叫它“龙虾助手”)是 2025 年末由奥地利开发者 Peter Steinberger 发布的开源 AI 助手,在国内外都很火,GitHub 星数一度超过 34 万。它的核心特点是连接各种聊天平台,让你到处都能和 AI 说话。
两者全面对比
| 对比维度 | Hermes Agent 🐴 | OpenClaw 🦞 |
|---|---|---|
| 核心定位 | 会自我进化的智能体运行时 | 连接各平台的助手网关 |
| 学习能力 | ✅ 自动提炼技能,越用越强 | ❌ 技能需人工编写 |
| 记忆方式 | 智能策划型记忆 + 用户画像建模 | 简单 Markdown 文件 |
| 安全性 | 较新记录干净,内置快照/回滚 | 曾爆多个严重漏洞,暴露实例超13.5万 |
| 安装难度 | 一行命令,2 分钟 | Docker Compose,30 分钟 |
| 中国平台支持 | 微信、企业微信、钉钉、飞书、QQ | 相对较少 |
| GitHub 星数 | 11 万+(10 周内) | 34.5 万+(更成熟) |
| 适合谁 | 想要”会学习的 AI 员工” | 想要”到处能聊天的 AI 管家” |
在 Mac 上部署 Hermes
准备工作清单
- Mac 电脑(Intel 或 Apple Silicon 都支持)
- 稳定的网络连接(安装需要从 GitHub 下载文件)
- 至少一个 AI 模型的 API Key(见下方推荐)
- 大约 30 分钟的时间
推荐 API Key(中国用户)
新手推荐:先去 OpenRouter 注册,有免费模型可以零成本体验 Hermes,完全不花钱!
常用命令速查表
hermes启动普通聊天界面hermes --tui启动图形化终端界面(推荐)hermes --continue继续上次会话hermes model更换 / 配置 AI 模型hermes tools查看和配置可用工具hermes setup运行完整配置向导hermes doctor诊断问题hermes update更新到最新版本hermes dashboard打开 Web 控制面板hermes gateway run启动消息平台网关
如何开启消息通知(可选)
如果你想从手机上给 Hermes 发消息,可以配置消息网关(以 微信为例):
- 在 Mac 的终端中输入
hermes setup进入配置向导。 - 根据提示找到并选择 Messaging Platforms(消息平台),然后选择 Weixin / WeChat(微信)。
- 系统会询问是否开启微信登录,输入
Y确认。 - 终端会生成一个二维码链接(或者直接弹出二维码)。复制该链接在浏览器中打开,拿出手机微信扫码登录并完成授权。
- 授权成功后,按照终端的后续提示完成配对(有时需要你在微信里把收到的验证码复制回终端),绑定完成后即可通过微信与 Hermes 对话。
配置适合中国用户的 Web UI
命令行界面虽然强大,但不够直观。好消息是,社区开发了多个 Web UI,其中有专门为中国用户优化的版本,原生支持微信、企业微信、钉钉、飞书、QQ。
方案一:官方内置 Dashboard(5 分钟搞定)
Hermes 自带了一个 Web 控制面板,支持中英文切换,开箱即用。
安装依赖
cd ~/.hermes/hermes-agent
uv pip install -e ".[web,pty]"
启动 Dashboard
hermes dashboard
浏览器会自动打开 http://127.0.0.1:9119。在右上角语言切换按钮选择简体中文即可。
Dashboard 提供:状态监控、在线聊天、会话管理、配置管理、API Key 管理、定时任务、技能浏览。
让 Dashboard 开机自动运行
cat > ~/Library/LaunchAgents/com.hermes.dashboard.plist << 'EOF'
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key>
<string>com.hermes.dashboard</string>
<key>ProgramArguments</key>
<array>
<string>/bin/bash</string>
<string>-c</string>
<string>source ~/.zshrc && hermes dashboard --no-open</string>
</array>
<key>RunAtLoad</key>
<true/>
<key>KeepAlive</key>
<true/>
</dict>
</plist>
EOF
launchctl load ~/Library/LaunchAgents/com.hermes.dashboard.plist
以后打开浏览器直接访问 http://127.0.0.1:9119 就可以了。
方案二:EKKO Hermes Web UI(微信 / 钉钉最完善)
如果你的团队主要用微信、企业微信、钉钉或飞书,这个 Web UI 专门为此设计,是目前对中国平台支持最完善的版本。
主要特色:
- 原生支持微信扫码登录(Tencent iLink API)
- 统一配置 8 个平台的消息渠道(微信、企业微信、钉钉、飞书 + Telegram、Discord 等)
- 会话按来源平台分组(微信 / Telegram 分开显示)
- 全中文界面,用量统计和费用监控
一行命令安装(推荐)
bash <(curl -fsSL https://raw.githubusercontent.com/EKKOLearnAI/hermes-web-ui/main/scripts/setup.sh)
或通过 npm 安装
npm install -g hermes-web-ui
hermes-web-ui start
浏览器访问 http://localhost:8648 即可看到中文界面。

配置微信登录
- 打开 Web UI,进入 设置 → 平台配置 → 微信
- 点击”生成二维码”
- 用手机微信扫描二维码
- 扫码成功后,你的 Hermes 就会成为一个微信机器人
配置钉钉 / 飞书
- 进入钉钉开放平台,创建一个企业内部应用
- 获取 AppKey 和 AppSecret
- 在 Web UI 设置中填入对应信息
钉钉配置相对稳定,适合团队内部使用。
方案三:Open WebUI(最漂亮,类 ChatGPT 界面)
如果你只想要一个好看的聊天界面,Open WebUI 的界面和 ChatGPT 几乎一模一样。
前提条件:需要先安装 Docker Desktop(从 docker.com 下载安装)。
第一步:启动 Hermes API 服务器
hermes config set API_SERVER_ENABLED true
hermes config set API_SERVER_KEY my-secret-key-123
hermes gateway run &
# 验证 API 是否正常
curl http://localhost:8642/health
# 应该返回:{"status": "ok"}
第二步:用 Docker 启动 Open WebUI
docker run -d \
--name open-webui \
-p 3000:8080 \
-e OPENAI_API_BASE_URL=http://host.docker.internal:8642/v1 \
-e OPENAI_API_KEY=my-secret-key-123 \
--add-host=host.docker.internal:host-gateway \
--restart always \
ghcr.io/open-webui/open-webui:main
第三步:访问界面
打开浏览器,访问 http://localhost:3000,创建管理员账号即可开始使用!
你能看到实时的工具调用进度(”正在搜索网络…”)、完整的历史会话列表和文件上传功能。
常见问题 Q&A
Q:安装时提示 “Permission denied” 怎么办?
不要用 sudo!Hermes 设计成普通用户权限安装。直接运行官方的一行安装命令即可,它会安装到你的用户目录 ~/.hermes/ 下,不需要管理员权限。
Q:提示 hermes: command not found
运行:
source ~/.zshrc
如果还是不行,手动把路径加入环境变量:
echo ‘export PATH=”$HOME/.local/bin:$PATH”‘ >> ~/.zshrc
source ~/.zshrc
Q:API 调用报错 / 没有响应
运行诊断命令,它会告诉你哪里有问题:
hermes doctor
最常见的原因是 API Key 填写有误,或者模型上下文窗口不足 64K。重新配置模型:hermes model
Q:在国内安装速度很慢
GitHub 在国内访问不稳定。建议开启代理工具,并配置终端走代理:
export https_proxy=http://127.0.0.1:你的代理端口
export http_proxy=http://127.0.0.1:你的代理端口
然后再运行安装命令。
Q:怎么更新 Hermes?
一条命令搞定:
hermes update
会自动更新代码和依赖,并重建前端。
Q:不想用了,怎么卸载?
rm -rf ~/.hermes
rm ~/.local/bin/hermes
完全干净卸载,不影响系统其他任何东西。
Q:Hermes 会把我的数据上传到哪里吗?
Hermes 是完全本地运行的。你的对话、记忆、技能文件都存在 ~/.hermes/ 目录下,只有你自己能访问。对话内容只会发送给你自己配置的 AI 服务商(DeepSeek、OpenRouter 等),和直接使用这些服务完全一样。
🐴 开始你的 Hermes 之旅
Hermes Agent 代表了 AI 助手的一个新方向——不只是”问答机器”,而是真正能学习、能记忆、能自主完成任务的智能伙伴。
教程结束!

