Hermes Agent 安装指南

汉堡大王9527
0 阅读2分钟

Hermes Agent 安装指南

当前状态

⚠️ 自动安装失败原因：WSL2 网络连接 GitHub 超时（TLS 连接被终止）

手动安装步骤

方法 1：在 WSL2 中手动安装（推荐）

  1. 打开 WSL2 终端（Ubuntu）

    # 在 Windows 中打开 PowerShell 或 CMD，运行：
wsl

  2. 设置 Git 使用 SSH 或镜像（解决网络问题）

    # 方法 A：使用国内镜像加速
git config --global url."https://ghproxy.com/https://github.com/".insteadOf "https://github.com/"

# 方法 B：或者设置代理
export https_proxy=http://your-proxy:port
export http_proxy=http://your-proxy:port

  3. 克隆仓库

    git clone --depth 1 https://github.com/NousResearch/hermes-agent.git ~/.hermes/hermes-agent
cd ~/.hermes/hermes-agent

  4. 创建虚拟环境并安装

    # 确保 uv 已安装
curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.bashrc

# 创建环境
uv venv venv --python 3.11
source venv/bin/activate

# 安装核心包（不含浏览器工具，避免 sudo）
uv pip install -e ".[cli]"

  5. 创建启动命令

    # 添加 hermes 命令到 PATH
echo 'export PATH="$HOME/.hermes/hermes-agent/venv/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

  6. 启动 Hermes

    hermes

方法 2：使用 Windows 直接安装（通过 pip）

如果 WSL2 网络持续有问题，可以在 Windows 上直接安装：

  1. 确保 Python 3.11+ 已安装

  2. 创建虚拟环境

    # 在 PowerShell 中
python -m venv C:\Users\liufafu\.hermes\venv
C:\Users\liufafu\.hermes\venv\Scripts\activate

  3. 下载源码并安装

    # 手动下载 https://github.com/NousResearch/hermes-agent/archive/refs/heads/main.zip
# 解压到 C:\Users\liufafu\.hermes\hermes-agent

cd C:\Users\liufafu\.hermes\hermes-agent
pip install -e ".[cli]"

方法 3：使用 Docker（最简单）

# 如果已安装 Docker
docker run -it --rm \
  -v ~/.hermes:/root/.hermes \
  nousresearch/hermes-agent:latest

安装后配置

  1. 运行设置向导

    hermes setup

  2. 配置模型（选择 API）

    hermes model
# 推荐：OpenRouter（支持 200+ 模型）或 OpenAI/Anthropic

  3. 启动对话

    hermes

从 OpenClaw 迁移数据

hermes claw migrate

这会迁移：

  • SOUL.md（人格文件）
  • MEMORY.md 和 USER.md（记忆）
  • 自定义 skills
  • API 密钥
  • 消息平台配置

常见问题

Q: 浏览器工具无法使用？

A: 安装时跳过了 Playwright（需要 sudo）。如需浏览器功能，在 WSL 中运行：

sudo ~/.hermes/hermes-agent/venv/bin/playwright install-deps chromium

Q: 网络连接失败？

A: 尝试更换 DNS 或设置代理：

# 更换 DNS
echo "nameserver 8.8.8.8" | sudo tee /etc/resolv.conf > /dev/null

# 或设置代理
export https_proxy=http://127.0.0.1:7890

Q: 如何更新？

cd ~/.hermes/hermes-agent
git pull
source venv/bin/activate
uv pip install -e ".[cli]"

官方文档

功能对比：Hermes vs OpenClaw

特性HermesOpenClaw
开源✅ 完全开源✅ 开源
自学习✅ 自动创建 skills⚠️ 需手动创建
长期记忆✅ 内置✅ 内置
定时任务✅ 内置 cron✅ 内置 cron
子代理✅ 支持✅ 支持
消息平台Telegram/Discord/Slack/WhatsApp/Signal更多国内平台
浏览器✅ Playwright✅ Playwright
MCP 支持✅ 支持✅ 支持
模型选择200+（OpenRouter等）依赖配置
学习闭环✅ 自动改进❌ 需手动优化
avatar
文章
阅读
粉丝