OpenClaw 企业定制 私人订制工作流 优化运维 openclaw记忆优化 问题咨询解决 请加微信交流
微信: aixbwz
想用Hermes Agent但不知道从哪开始？安装其实很简单，60秒就能跑起来。这篇讲清楚所有安装方式、最小配置、以及常见坑怎么避免。
安装要求
| 要求 | 最低 | 推荐 |
|---|---|---|
| 操作系统 | Linux/macOS/WSL2 | Ubuntu 22.04 |
| Python | 3.10+ | 3.11+ |
| 内存 | 4GB | 8GB+ |
| 磁盘 | 2GB | 10GB+ |
| 网络 | 能访问API | 稳定 |
Windows用户建议用WSL2，macOS直接装，Linux最推荐。
方式一：自动安装（推荐）
curl -s https://hermes-agent.nousresearch.com/install.sh | sh或者
wget -qO- https://hermes-agent.nousresearch.com/install.sh | sh自动脚本会：
- 检查Python环境
- 安装依赖
- 配置初始化
- 创建配置目录
方式二：pip安装
pip install hermes-agent或用uv（更快）：
uv pip install hermes-agent方式三：从源码安装
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
uv pip install -e .开发版，适合想看源码或贡献代码的人。
方式四：Docker安装
# 拉取镜像
docker pull nousresearch/hermes-agent:latest
# 运行
docker run -it --rm -v ~/.hermes:/home/hermes/.hermes -v ~/.ssh:/home/hermes/.ssh nousresearch/hermes-agent:latestDocker方式不需要本地Python环境，但需要注意卷挂载配置。
验证安装
hermes --version看到版本号说明安装成功。
hermes doctor诊断命令，检查环境配置是否正确。
配置API Key
Hermes需要连接AI模型才能工作。最简单的方式是配置OpenRouter：
# 注册 https://openrouter.ai
# 获取API Key
hermes config set OPENROUTER_API_KEY sk-or-xxx或者直接编辑配置文件：
vi ~/.hermes/config.yamlproviders:
openrouter:
api_key: "sk-or-v1-xxx"
default: true
models:
default: "anthropic/claude-sonnet-4"配置国内模型（可选）
如果想用国内模型（如DeepSeek、MiniMax），配置如下：
providers:
deepseek:
api_key: "sk-xxx"
base_url: "https://api.deepseek.com/v1"
minimax:
api_key: "eyJxxx"
base_url: "https://api.minimax.chat/v1"第一次对话
hermes chat看到对话提示符后，直接问问题：
你好，帮我写一个Python函数判断质数AI会回答。如果没反应，检查API Key是否配置正确。
WSL2特别说明
Windows上推荐用WSL2：
# 安装WSL2
wsl --install
# 进入Ubuntu
wsl
# 然后按Linux方式安装
curl -s https://hermes-agent.nousresearch.com/install.sh | shWSL2性能接近原生Linux，比虚拟机好很多。
配置国内镜像源
如果pip安装慢，换国内镜像：
pip install hermes-agent -i https://pypi.tuna.tsinghua.edu.cn/simple或者永久设置：
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple常见安装问题
Python版本不对
# 检查Python版本
python3 --version
# 如果版本太低，安装新版本
# Ubuntu:
sudo apt update && sudo apt install python3.11 python3.11-venv python3.11-dev
# 用uv指定Python版本
uv python install 3.11权限问题
# 不用sudo，避免污染系统环境
# 用uv安装到用户目录
uv pip install hermes-agent --user
# 或者创建虚拟环境
python3 -m venv ~/.hermes/venv
source ~/.hermes/venv/bin/activate
pip install hermes-agent找不到hermes命令
# 检查安装位置
which hermes
pip show hermes-agent
# 如果用虚拟环境，确保激活了
source ~/.hermes/venv/bin/activate
# 添加到PATH
export PATH="$HOME/.local/bin:$PATH"网络问题
# 设置代理（如果有）
export https_proxy=http://127.0.0.1:7890
export http_proxy=http://127.0.0.1:7890
# 或者用国内镜像
pip install hermes-agent -i https://pypi.tuna.tsinghua.edu.cn/simpleOpenSSL错误
# Ubuntu安装ssl库
sudo apt install libssl-dev pkg-config
# macOS
brew install openssl卸载
# pip卸载
pip uninstall hermes-agent
# 删除配置（可选）
rm -rf ~/.hermes
# 删除虚拟环境（如果用了）
rm -rf ~/.hermes/venv升级
# pip升级
pip install --upgrade hermes-agent
# Docker升级
docker pull nousresearch/hermes-agent:latest
# 源码安装的升级
cd ~/hermes-agent && git pull && uv pip install -e .多版本管理
如果需要同时跑多个版本：
# 用虚拟环境隔离
python3 -m venv ~/hermes-env-3.11
source ~/hermes-env-3.11/bin/activate
pip install hermes-agent==1.2.0
# 另一个版本
python3 -m venv ~/hermes-env-1.3.0
source ~/hermes-env-1.3.0/bin/activate
pip install hermes-agent==1.3.0总结
安装三步走：
- 运行安装脚本或pip install
- 配置API Key
- hermes chat开始对话
60秒装好，5分钟配置好，马上能用。
相关文章
© 版权声明
文章版权归作者所有，未经允许请勿转载。
THE END
暂无评论内容