mac 安装

安装python3.11

由于hermes-agent安装依赖python3.11 所以这个版本即可，3.12也可以

 1.brew update
 2.brew install python@3.11
 3.brew install python3

由于brew install python3默认安装3.14.我这里制定了采用python@3.11指定版本，这样方便兼容性。
输入
python3.11 --version 显示版本好如下：

说明安装成功

hermes-agent安装

安装指令：curl
1.官网：

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

2.官网加速

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

3.国内镜像：

curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash

我这里直接选择国内镜像
直接执行指令3
如果出现如下错误，则说明安装python的版本过低或者过高。
所以建议安装pyhon>=3.11以上

错误1:

错误2:

需要执行如下指令进行授权，由于～/.local目录属于root所以在安装过程中才会出现没有权限安装依赖包和源码
进行目录授权当前用户即可

 chown -R $(whoami):staff ~/.local ~/.hermes
 chmod -R 755 ～/.local

安装成功

安装成功配置界面
1.配置截图如下：

1.OpenClaw 数据导入选择
有 OpenClaw 历史记录：选Y预览并导入会话、配置；
不需要旧数据：选N直接跳过导入。
我这里直接选择N

跳转下一步截图如下：

选项 1：Quick Setup（默认选中，推荐新手）
Quick Setup (Nous Portal)：官方免费 OAuth 登录，不用自己找 API 密钥，自动绑定 Nous 官方模型，开箱即用（软件推荐）
操作：直接按回车键 Enter
后续会给出一个网页链接，浏览器打开链接登录 Nous 账号授权即可，授权完自动配置完毕。
选项 2：Full setup
Full setup：全自定义配置，需要你自备 DeepSeek/OpenAI/Ollama 等 API Key，手动逐个填模型、参数
操作：按↓光标切到第二项，回车选中，后续一步步填入自己的密钥。
我这里默认选中 选项1
跳转下一步

终端正在等待网页授权（每秒轮询），按下面两步操作：
1、浏览器打开链接
plaintext
https://portal.nousresearch.com/manage-subscription?user_code=KLWP-PDPG
2、页面操作
注册 / 登录 Nous 账号（邮箱注册即可免费使用）
页面提示输入验证码时填入：KLWP-PDPG
点击授权 Allow
这里跳转官网授权，我直接crtl+c退出

判断安装成功命令

hermes --version

目录管理

配置目录：~/.hermes/（config.yaml、会话缓存、记忆文件）
程序源码：~/.hermes/hermes-agent/
可执行程序：~/.local/bin/hermes

常用命令

指令 作用
hermes setup 重新打开完整配置向导（换模型、换账号）
hermes setup gateway 单独配置 Telegram/Discord 消息网关
hermes doctor 环境自检，检查 Python 版本、依赖、权限问题
hermes config show 查看当前完整配置文件（模型、技能、终端后端）
hermes config edit 直接编辑配置文件（vim/nano 打开）

指令 作用
hermes skills list 列出所有已安装的技能和功能说明
hermes skills browse 浏览官方技能库，找新功能
hermes skills search git 关键词搜索技能（如搜索 Git 相关）
hermes skills install 技能名 安装新技能，例：hermes skills install official/draw/excalidraw
hermes skills uninstall 技能名 卸载已安装的技能
hermes skills inspect 技能名 查看单个技能的详细信息（参数、依赖）
hermes skills 打开交互式面板，可视化开关技能

至此结束