admin 教程 27天前

Hermes（爱马仕）保姆级部署教程

Hermes Agent 部署指南

🐴 Open Source AI Agent · 2026

Hermes Agent
Mac 部署完全指南

写给完全不懂技术的你，一步一步跟着做，保证能跑起来。

⭐ GitHub 11万+ Stars
🍎 Intel & Apple Silicon
🇨🇳 中国用户友好
📅 2026年5月更新

本文目录

1什么是 Hermes Agent？
2Hermes 能做什么？
3Hermes vs OpenClaw 对比
4在 Mac 上部署 Hermes
5配置适合中国用户的 Web UI
6常见问题 Q&A

什么是 Hermes Agent？

Hermes Agent

用大白话说

你有没有用过 ChatGPT 或者 Claude？每次打开新对话，它对你一无所知。上次跟它说过”我是程序员、不喜欢废话、项目用 Python 写的”，下次又得重新说一遍——它什么都不记得。

Hermes Agent 就是为了解决这个痛点而生的。

Hermes 是一个会学习、会记忆、越用越聪明的 AI 智能体，由 AI 研究机构 Nous Research 在 2026 年 2 月发布。它不是一个聊天框，而是一个真正能帮你干活的”AI 助手员工”：

🧠
记得你是谁、你的项目、你的习惯偏好

💻
操作电脑、搜索网络、写代码、执行命令

📚
完成任务后自动提炼”技能”，下次直接调用

📲
定时任务推送到微信 / Telegram / 钉钉

🌟

发布不到两个月，GitHub 已超过 11 万颗星，是 2026 年增长最快的开源 AI 项目，目前在 OpenRouter 全球应用排行榜排名第一。

技术背景

Hermes Agent 本身是一个智能体框架（Agent Framework），它自己不是大语言模型，而是连接并驱动大语言模型的”大脑壳”。你需要给它配一个 AI 模型的 API Key（比如 DeepSeek、MiniMax、Claude、GPT 等），它来负责记忆、工具调用、任务规划、技能学习。

Hermes 能做什么？

🧠 持久记忆，认识你这个人

Hermes 会维护两个核心文件：

MEMORY.md
记录关于你的项目、环境、重要信息

USER.md
记录你的偏好、习惯、沟通风格

你告诉它”我们的数据库用 PostgreSQL，不要建议用 MySQL”，它下次就不会再给你推荐 MySQL 了。

🛠️ 70+ 内置工具

💻

终端执行

运行命令、查磁盘、安装软件

📁

文件操作

读写、搜索、批量重命名

🔍

网络搜索

实时搜索、抓取网页内容

🌐

浏览器自动化

填表、截图、抓取动态数据

🖼️

图像生成

支持 9 种图像模型

🎙️

语音交互

实时语音输入与回复

📚 技能系统，越用越聪明

分析这次任务是怎么解决的

把解题思路提炼成一个”技能”文件

下次遇到类似任务，直接调用这个技能，又快又准

💬 连接 20+ 消息平台

国内常用：微信、企业微信、钉钉、飞书、QQ Bot
国际通用：Telegram、Discord、Slack、WhatsApp、Signal、Email、Microsoft Teams

Hermes vs OpenClaw：有什么区别？

OpenClaw（”龙虾助手”）是 2025 年末发布的开源 AI 助手，GitHub 星数一度超过 34 万，核心特点是连接各种聊天平台，让你到处都能和 AI 说话。

对比维度	Hermes 🐴	OpenClaw 🦞
核心定位	会自我进化的智能体运行时	连接各平台的助手网关
学习能力	✅ 自动提炼技能，越用越强	❌ 技能需人工编写
记忆方式	智能策划型记忆 + 用户画像建模	简单 Markdown 文件
安全性	记录干净，内置快照 / 回滚	曾爆多个漏洞，暴露实例超13.5万
安装难度	✅ 一行命令，2 分钟	Docker Compose，30 分钟
中国平台	微信、企业微信、钉钉、飞书、QQ	相对较少
GitHub 星数	11 万+（10 周内）	34.5 万+（更成熟）
适合谁	想要”会学习的 AI 员工”	想要”到处能聊天的 AI 管家”

在 Mac 上部署 Hermes

准备工作清单

🖥️Mac（Intel 或 Apple Silicon）

🌐稳定的网络连接

🔑至少一个 AI 模型 API Key

⏱️大约 30 分钟的时间

推荐 API（中国用户）

🔥 DeepSeek

国内、便宜、中文好，有免费额度

platform.deepseek.com

MiniMax

国内、中文好，注册简单

api.minimax.chat

阿里云 Qwen

通义千问，国内稳定

dashscope.aliyuncs.com

🆓 OpenRouter

有免费模型，零成本体验

openrouter.ai

Kimi / 月之暗面

长上下文表现强

platform.moonshot.cn

💡

新手推荐：先去 OpenRouter 注册，有免费模型可以零成本体验 Hermes，完全不花钱！

第一步

安装 Git

打开 Mac 终端（按 Command + 空格，搜索”终端”，回车打开）。输入以下命令检查：

TERMINAL

git --version

如果显示 git version 2.x.x，跳过这步。如果提示未找到，系统会弹出”安装命令行开发者工具”对话框，点击”安装”即可。

安装 Git

第二步

一键安装 Hermes

完整复制粘贴以下命令，然后按回车：

TERMINAL

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

⚠️

网络提示：国内访问 GitHub 速度较慢，建议先开启代理工具。

安装程序会自动完成 Python 3.11、Node.js 22、ripgrep、ffmpeg 的安装，整个过程约 3–5 分钟。

安装进度
Setup 界面

第三步

设置向导

选择 Quick setup。

选择模型

选择 AI 模型提供商，以 MiniMax 为例演示。

⚠️

本地模型要求上下文窗口至少 64K tokens，且需要高配电脑。Ollama 用户需设置 --ctx-size 65536。

填写 API Key

第四步

获取 MiniMax API Key

登录以下网址：platform.minimaxi.com

MiniMax 注册

手机验证码注册登录，进入 财务管理 → 余额 充值。

充值余额
创建密钥

进入 账户管理 → 接口密钥，点”创建新的 API Key”并复制。

复制密钥
粘贴密钥

回到终端用 Command+V 粘贴密钥（不可见），回车确认。选择 MiniMax-M2.7，然后选择 Skip，最后选 n，配置完成！

选择模型
完成配置

第五步 🎉

进行第一次对话

TERMINAL

# 普通界面
hermes

# 更现代的 TUI 界面（推荐，有鼠标支持）
hermes --tui

启动 Hermes
对话界面
TUI 界面

试试这些入门指令：

EXAMPLE

查看我当前目录里有什么文件，告诉我最大的5个
帮我用 Python 写一个超级玛丽的游戏脚本
每20分钟提醒我注意眼睛，并把我屏幕强行锁屏

验证记忆功能

退出 Hermes 后，用以下命令继续上次会话：

TERMINAL

hermes --continue

✅

Hermes 应该还记得你们刚才聊的内容。这就是持久记忆在起作用，比 OpenClaw 强大很多！

常用命令速查

hermes启动普通聊天界面

hermes --tui图形化终端界面（推荐）

hermes --continue继续上次会话

hermes model更换 / 配置 AI 模型

hermes doctor诊断问题

hermes update更新到最新版本

hermes dashboard打开 Web 控制面板

hermes gateway run启动消息平台网关

配置适合中国用户的 Web UI

命令行界面虽然强大，但不够直观。社区开发了多个 Web UI，有专门为中国用户优化的版本，原生支持微信、企业微信、钉钉、飞书、QQ。

方案一

官方内置 Dashboard（5 分钟搞定）

Hermes 自带 Web 控制面板，支持中英文切换，开箱即用。

TERMINAL

cd ~/.hermes/hermes-agent
uv pip install -e ".[web,pty]"
hermes dashboard

浏览器自动打开 http://127.0.0.1:9119，右上角切换简体中文。

方案二推荐

EKKO Hermes Web UI

🔗
github.com/EKKOLearnAI/hermes-web-ui

✓ 微信扫码登录（Tencent iLink）

✓ 统一配置 8 个平台渠道

✓ 全中文界面

✓ 用量统计和费用监控

TERMINAL

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

EKKO Web UI
EKKO Web UI 详情

方案三

Open WebUI（最漂亮，类 ChatGPT 界面）

🐳

前提条件：需要先安装 Docker Desktop（docker.com）。

TERMINAL

hermes config set API_SERVER_ENABLED true
hermes config set API_SERVER_KEY my-secret-key-123
hermes gateway run &

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，创建管理员账号即可开始使用！