🐴 Hermes Agent v0.15.2 部署指南

Hermes Agent（爱马仕）是由 Nous Research 开源的自进化 AI 智能体。与普通 AI 助手不同，它具备自主学习能力——在执行任务过程中会自动创建、改进并持久化技能，实现"越用越聪明"。本指南基于 v0.15.2 (2026.5.29) 最新版本，所有命令均已实测验证。

一、什么是 Hermes Agent？

Hermes Agent 是一款自进化 AI 智能体框架。与传统的 chatbot 或 AI 网关不同，Hermes 的核心创新在于：

• 技能自进化 — 完成复杂任务后自动提炼为 Skill，存到 ~/.hermes/skills/，下次复用
• 四层持久记忆 — 事实 / 会话 / 技能 / 用户画像 跨会话保留
• 多 Agent 协作 — Kanban 多 Agent 编排，支持 OpenCode/Codex/Claude Code 等委派
• 15+ 聊天平台 — 飞书 / Telegram / Discord / QQ / 微信 / Slack 等
• Setup Wizard — 引导式配置 model / TTS / terminal / gateway / tools / agent 六章节

二、🆚 Hermes v0.15.2 vs OpenClaw 2026.5.27 对比

三、Mac / Linux 部署（5 步）

3.1 系统要求

• macOS 13 Ventura 及以上 / Ubuntu 22.04+ / 其他主流 Linux
• Python 3.10+（推荐 3.12，Hermes 0.15.2 已在 3.12.13 实测）
• 8GB 内存起步，本地大模型建议 16GB+
• （可选）Ollama 跑本地模型

3.2 安装 Hermes

方式 A：uv（推荐，速度快 10x）

# 安装 uv（如未安装）
curl -LsSf https://astral.sh/uv/install.sh | sh

# 装 Hermes
uv pip install --upgrade hermes-agent

方式 B：pip

pip install --upgrade hermes-agent

3.3 验证安装

hermes --version
# 期望输出: Hermes Agent v0.15.2 (2026.5.29.2)
#          Project: ~/.hermes/hermes-agent
#          Python: 3.12.x · OpenAI SDK: 2.24.0

3.4 Setup Wizard（关键）

hermes setup

进入分章节引导（v0.15.2 新增），可单独跑某章节：

hermes setup model      # 配置模型 provider + API key
hermes setup tts        # 配置 TTS 语音
hermes setup terminal   # 配置终端工具
hermes setup gateway    # 配置 Gateway（Web UI 端口/认证）
hermes setup tools      # 配置工具集
hermes setup agent      # 配置 agent 行为

常用 flags：

hermes setup --portal    # 一键 Nous Portal OAuth 登录
hermes setup --quick     # 快速补缺（已配项跳过）
hermes setup --reset     # 重置全部配置
hermes setup --non-interactive  # 用环境变量/默认值（非交互）

3.5 启动 Hermes

⚠️ v0.15.2 关键变化：hermes 命令现在指向CLI 模式，不再启动 Web UI！

# 前台 CLI 模式（管理用）
hermes

# 后台 Gateway（启动 Web UI）⚠️ 新命令
hermes-web-ui-bin

# 常用管理（4 个命令）
hmst           # = hermes status
hmrestart      # = hermes restart
hmlog          # = hermes log（实时日志）
hermes stop    # 停止 Gateway

四、Windows 部署（3 步）

4.1 启用 WSL2（管理员 PowerShell）

wsl --install -d Ubuntu-22.04
wsl --shutdown

# 进入 WSL Ubuntu
wsl

4.2 在 WSL Ubuntu 内

# 装 pip + venv
sudo apt update
sudo apt install python3-pip python3-venv -y

# 装 Hermes
pip install --upgrade hermes-agent
# 或用 uv：curl -LsSf https://astral.sh/uv/install.sh | sh && uv pip install --upgrade hermes-agent

# Setup Wizard
hermes setup

# 启动 Web UI
hermes-web-ui-bin

4.3 访问 Web UI

WSL2 默认网络已与 Windows 互通，浏览器直接打开 http://127.0.0.1:18789/ 即可。

五、装完必做的 4 件事

1. 配置模型 — hermes setup model，选 DeepSeek / OpenAI / 智谱 / Ollama / Nous Portal，填 API key。本地模型零消耗跑 ollama pull gemma3:4b
2. 接入聊天平台 — 在 Web UI Settings → Channels 选飞书 / Telegram / Discord 引导配置。或 CLI：openclaw channels add（如果你同时装了 OpenClaw）
3. 观察技能进化 — 给 Agent 几个复杂任务，做完后看 ~/.hermes/skills/，会看到自动生成的 SKILL.md
4. 配 cron 定时任务（替换 OpenClaw cron）— hermes cronjob create，支持 cron 表达式 + 交付目标（feishu/telegram/local）

六、🔧 v0.15.2 常用命令速查

七、升级与故障排查

7.1 升级到最新版

uv pip install --upgrade hermes-agent

# 验证
hermes --version

升级后建议跑一次 hermes setup --quick 补缺新配置项。

7.2 常见问题

Q：hermes 命令报"now points to Hermes Agent CLI"

A：v0.15.2 默认安全行为，hermes 是 CLI 工具。启动 Web UI 用 hermes-web-ui-bin。

Q：Web UI 端口被占用

A：hermes setup gateway 改端口，或在配置 ~/.hermes/config.yaml 直接改 gateway.port。

Q：setup 时模型选 Nous Portal 提示未授权

A：hermes setup --portal 会自动打开浏览器走 OAuth，登录后 token 存到 ~/.hermes/auth.json。

Q：OpenAI SDK 2.24.0 与其他库版本冲突

A：建议用 venv 或 uv 隔离：uv venv ~/.hermes-venv && source ~/.hermes-venv/bin/activate。

八、相关资源

• PyPI · hermes-agent
• 官方文档
• GitHub 仓库
• OpenClaw 2026.5.27 部署指南 →

本文由 AI Know 工具教程组实测于 2026-06-13，基于 Hermes Agent v0.15.2 (2026.5.29.2)。版本更新请关注 PyPI release history。