最后更新:2026-04-14
还没装 Hermes 的小伙伴,可以不用装 OpenClaw 了。
现在 GitHub 上已经 40.4k Star,Fork 也有 5.2k,涨得飞快。
我踩了 3 天坑,整理了这个 Mac 小白专用版,半小时就能跑起来。
先看成品

安装完 Hermes,对比 OpenClaw 你能获得什么:
核心差异:Hermes 会越用越聪明。
传统 AI 每次都从零开始,但 Hermes 有个内置的学习循环,会把你的偏好、常用工具、解决路径都记下来,下次自动优化流程。
你让它整理文档,它会记住你的格式偏好,下次直接按你的风格来。
Hermes Agent 到底是个啥?

Hermes Agent 是 Nous Research 开源的自进化 AI Agent 框架,GitHub 上已经 40.4k Star,Fork 也有 5.2k,涨得飞快。
核心特点就一句话:用得越多越聪明。
三大核心能力
内置学习循环
Hermes 完成复杂任务后,会把整个解决过程沉淀成一个 Markdown 格式的 Skill。后续发现更好的路径,还会自动更新这个 Skill。
这解决了一个超大痛点:不用手写 Rules 去规定不同工具的调用顺序。
三层记忆系统
用 SQLite 存对话历史,FTS5 做全文检索,大模型自动做摘要。所有历史对话都存下来,跨会话记住你的偏好和习惯。
安全拉满
和 OpenClaw 依赖大模型自己判断风险不同,Hermes 在框架层面做了用户授权、危险命令审批、容器隔离和上下文扫描。
就算用一般模型也够安全。
第一步:打开终端
按 Command + 空格,输入"终端",回车。
后面所有操作都在这个黑窗口里,复制命令、粘贴、回车。
就这么简单。
第二步:检查网络
curl -I https://github.com能看到 HTTP/2 200,说明能访问 GitHub,直接跳到"第三步"。
超时或报错?往下看。
访问不了 GitHub
三种解决方式:
镜像站下载方法:
浏览器打开这个地址,下载压缩包:
https://github.com/NousResearch/hermes-agent/archive/refs/heads/main.zip
下载完成后,终端运行:
mkdir -p ~/.hermesunfile=~/Downloads/hermes-agent-main.zipif [ -f "$unfile" ]; then unzip "$unfile" -d ~/.hermes/ mv ~/.hermes/hermes-agent-main ~/.hermes/hermes-agent echo "解压完成!"else echo "没找到压缩包,请检查下载路径"fi然后看第三步的"手动安装"部分。
第三步:配置国内源(重要)

这一步不做,安装会慢到你怀疑人生。
pip 源(Python 包):
mkdir -p ~/.pipcat > ~/.pip/pip.conf << 'EOF'[global]index-url = https://pypi.tuna.tsinghua.edu.cn/simpletrusted-host = pypi.tuna.tsinghua.edu.cnEOFecho "pip 国内源配置完成"npm 源(Node.js 包):
npm config set registry https://registry.npmmirror.comecho "npm 国内源配置完成"如果还没装 Node.js,提前装(比自动装快):
# 方式一:Homebrewbrew install node@22# 方式二:去国内镜像站下载 .pkg 安装包# https://npmmirror.com/mirrors/node/ (选最新 LTS 版本)Homebrew 源(如果需要):
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"安装过程选 1(中科大)或 4(清华)。
配置一次,终身受用。
第四步:安装 Hermes
能访问 GitHub
直接运行:
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash安装脚本会自动做这些事:
检查/安装 Python 创建虚拟环境 安装所有依赖 配置启动路径
不需要你手动操作。
已经下载了压缩包
cd ~/.hermes/hermes-agentbash scripts/install.sh --dir ~/.hermes/hermes-agent验证安装
hermes --version看到版本号(如 hermes x.x.x)就成功了。
第五步:配置模型
Hermes 需要配置 AI 模型才能对话。
用小米 MiMo(推荐)
免费,通过 Nous 平台使用,不需要单独申请 API Key。
hermes setup按提示操作:
Provider → 选 Nous 模型 → 选 xiaomi/mimo-v2-pro 打开浏览器登录认证
有账号直接登录,没有就注册。
其他可选模型
如果 MiMo 不好用,可以随时切换:
hermes model会显示可选的模型列表,包括:
小米 MiMo(免费) DeepSeek(国产,便宜) 智谱 GLM(国产) Kimi / Moonshot(国产) OpenRouter(聚合平台,有免费模型)
检查配置
hermes doctor看到绿色 ✅ 就没问题。
第六步:开始对话
hermes试试输入:
你好,请介绍一下你自己常用命令
/help | |
/new | |
/model | |
/quit |
输入 /quit 或按 Control + D 退出。
第七步:连接飞书(可选)
想用飞书聊天?配置网关就行。
创建飞书应用
打开飞书开放平台:https://open.feishu.cn/ 登录 → "创建企业自建应用" 填写名称(比如"Hermes助手") 开启"机器人"能力 事件订阅选 WebSocket 模式 添加权限: im:messageim:resourceim:message.receive_v1记录 App ID 和 App Secret
配置连接
hermes gateway setup选 Feishu,按提示输入 App ID 和 App Secret。
启动网关
# 前台运行(看日志)hermes gateway run# 后台运行(关终端不停)hermes gateway start现在可以在飞书里给机器人发消息了。
如果收不到消息
检查这两点:
在 .env文件中加一行:GATEWAY_ALLOW_ALL_USERS=true在飞书开放平台开通"接收用户发给机器人的单聊消息"权限
然后重启网关:
hermes gateway restart实际使用场景
安装完成后,你可以试试这些场景:

场景一:飞书定时任务提醒
在飞书里跟 Hermes 说"每天早上 9 点提醒我看邮件",它会自动创建一个定时任务,时间到了直接推送到飞书。
自然语言描述时间就行,不用手写 cron 表达式。
场景二:技能自动沉淀
你让 Hermes 帮你做一些复杂任务,调用了五次以上工具,它会自动把整个流程沉淀成一个 Skill 文件。
下次遇到类似任务,直接调用这个 Skill,不用重新描述。
场景三:会议纪要自动化
飞书会议结束后,你直接跟 Hermes 说"把刚才的会议纪要整理一下发给我",它会自动提取会议中的待办事项、关键决议,整理成结构化文档。
如果你有固定的周报格式,告诉 Hermes 一次,它就会记住。
以后你只要说"生成这周的周报",它就会按你的格式从飞书文档、会议记录、聊天记录里自动提取内容,生成一份完整的周报。
场景四:代码助手
你可以在飞书里直接让 Hermes 帮你写代码、审查代码。
比如你私聊它"用 Python 写一个飞书 webhook 消息推送脚本",它会生成完整代码,甚至直接帮你把部署步骤列出来。
常用命令速查

终端命令
hermeshermes chat -q "问题"hermes --continuehermes sessions listhermes confighermes modelhermes doctorhermes update
飞书网关
hermes gateway runhermes gateway starthermes gateway stophermes gateway status
常见问题
Q: curl 下载很慢或超时
先下载到本地再运行:
# 浏览器打开下载https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh# 下载后在终端运行bash ~/Downloads/install.shQ: hermes 命令找不到
手动添加路径:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrcsource ~/.zshrc关掉终端重新打开。
Q: Python 相关报错
Hermes 会自动管理 Python,一般不需要手动装。
如果报错:
# 用 Homebrew 安装/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"brew install python@3.11Q: pip 安装依赖很慢
检查国内源:
pip3 config list# 应该显示 global.index-url = https://pypi.tuna.tsinghua.edu.cn/simple如果没有,回到"第三步"重新配置。
Q: 模型调用报错
# 检查配置hermes doctor# 重新配置hermes setup# 切换模型hermes modelQ: 飞书收不到消息
# 检查网关状态hermes gateway status# 查看日志tail -50 ~/.hermes/logs/gateway.log# 重启网关hermes gateway restartQ: 上下文长度不足
Hermes 的上下文窗口确实有限制。
解决方法:
使用支持长上下文的模型(如 Claude、GPT-4) 定期清理历史会话: hermes sessions list查看后删除不需要的在新会话中提供必要的背景信息
安装目录
Hermes 的文件都在 ~/.hermes/:
~/.hermes/├── config.yaml # 主配置├── .env # API 密钥├── hermes-agent/ # 程序代码├── skills/ # 已安装技能├── sessions/ # 对话记录└── logs/ # 运行日志一般不需要手动改这些文件。
扩展阅读
官方文档 GitHub 仓库
你不需要懂技术,但你需要懂你要解决的问题。
工具不是门槛,心态才是。
当 AI 开始从经验中学习,我们就离真正的智能更近了一步。
夜雨聆风