Nous Research 开源的 Hermes Agent 是一款终端原生的 AI 智能体框架，和 Claude Code、Codex 属于同类产品，但它的核心区别在于：技能系统（Skills）和模型无关性。

你可以用任何 LLM 驱动它——OpenRouter、Anthropic、OpenAI、DeepSeek，甚至本地模型。本文记录在 Windows 11 上安装 Hermes、配置 DeepSeek V4 Flash、以及装技能的完整流程。

一、Hermes Agent 是什么

先一句话说清楚定位：

  • Claude Code = Anthropic 官方终端 Agent，只跑 Claude 模型
  • Codex CLI = OpenAI 官方终端 Agent，只跑 OpenAI 模型
  • Hermes Agent = 开源框架，任何模型都能驱动，支持技能系统自我进化

Hermes 的关键特性：

特性说明
模型无关支持 20+ 提供商，可随时切换
技能系统内置 80+ 技能，还能从 Hub 安装、自己写
跨会话记忆记住你的偏好、项目、习惯
子代理并行拆任务给多个 AI 并发执行
多平台网关同一个 Agent 跑在 Telegram、Discord、终端
定时任务后台自动干活
开源免费MIT 协议，全部代码可见

二、安装前提

2.1 硬件/系统要求

  • 系统：Windows 11（本文环境），也支持 Linux / macOS / WSL
  • Python：3.11 或 3.12（实测 3.12.2 正常工作）
  • 网络：能访问 api.deepseek.com（国内直连即可，无需代理）
  • 磁盘：安装占用约 200MB，技能文件后续增长不大

2.2 安装 Python

Hermes Agent 通过 pip 安装。如果你还没装 Python：

  1. 去 python.org 下载 Python 3.12
  2. 安装时勾选 "Add Python to PATH"
  3. 打开 PowerShell 或 git-bash，验证：
python --version
# Python 3.12.2

注意：本文使用 git-bash（MSYS2 环境）作为 shell。Hermes 在 Windows 上的终端工具通过 bash 执行命令，不是 PowerShell。如果你只装了 PowerShell 没装 Git for Windows，去 git-scm.com 下载安装。

三、安装 Hermes Agent

3.1 用 pip 安装

pip install hermes-agent

或者用 uv（更快）：

pip install uv
uv pip install hermes-agent

安装完成后验证：

hermes --version
# Hermes Agent v0.14.0 (2026.5.16)

3.2 运行初始化

首次运行会自动创建配置目录：

hermes

这会启动交互式 CLI。这时会提示你配置模型——先退出（Ctrl+C），我们手动配更可控。

配置文件位置：

  • 主配置：~/AppData/Local/hermes/config.yaml
  • 密钥文件：~/AppData/Local/hermes/.env
  • 技能目录：~/AppData/Local/hermes/skills/

四、配置 DeepSeek V4 Flash

4.1 获取 API Key

去 platform.deepseek.com 注册账号，创建 API Key。DeepSeek 目前价格极低，V4 Flash 模型性价比很高。

4.2 写 .env 文件

编辑 ~/AppData/Local/hermes/.env：

DEEPSEEK_API_KEY=sk-你的密钥放这里

安全提醒：.env 文件不要提交到 Git、不要截图发群里。Hermes 默认开启密钥脱敏（security.redact_secrets: true），工具输出中的密钥字符串会被自动遮蔽。

4.3 配置模型

编辑 ~/AppData/Local/hermes/config.yaml，找到 model 部分，改成：

model:
  default: deepseek-v4-flash
  provider: deepseek

DeepSeek 是 OpenAI 兼容接口，所以 providers 段配成：

providers:
  deepseek:
    type: openai_compatible
    base_url: https://api.deepseek.com
    api_key: ${DEEPSEEK_API_KEY}
    models:
    - id: deepseek-v4-flash
      name: deepseek-v4-flash
      context_length: 1000000

关键参数说明：

  • type: openai_compatible — DeepSeek 接口兼容 OpenAI SDK，直接复用
  • base_url — API 端点，国内直连无压力
  • api_key: ${DEEPSEEK_API_KEY} — 从 .env 读环境变量，不硬编码
  • context_length: 1000000 — V4 Flash 支持 1M 上下文，足够处理大型代码库

4.4 验证配置

hermes doctor

检查输出：

  • API key or custom endpoint configured ✓
  • Config version up to date ✓

然后用一条简单查询测试：

hermes chat -q "你好，说一句话验证 DeepSeek V4 Flash 正常工作"

看到中文回复就说明通了。

五、技能系统详解

这是 Hermes 区别于其他终端 Agent 的核心能力。

5.1 技能的分类

执行 hermes skills list 可以看到当前已安装的技能。它们分几类：

来源说明
builtin框架内置，开箱即用。76 个
hub-installed从 Skills Hub 安装的扩展技能
local自己写的自定义技能

5.2 内置技能（无需安装，直接可用）

大量技能已经内置，覆盖面很广：

开发/运维类（程序员必看）：

  • github-pr-workflow — PR 全流程管理
  • github-code-review — 代码审查
  • github-issues — Issue 管理
  • test-driven-development — TDD 工作流
  • systematic-debugging — 四阶段根因调试
  • plan — 先写计划再执行
  • spike — 快速验证实验
  • writing-plans — 写实现计划
  • node-inspect-debugger — Node.js 调试

生产力类：

  • powerpoint — 自动做 PPT
  • ocr-and-documents — 文档 OCR 提取
  • nano-pdf — PDF 文字编辑
  • google-workspace — Gmail/Calendar/Drive
  • notion — Notion 集成
  • llm-wiki — 本地知识库

创意类：

  • architecture-diagram — 架构图 SVG
  • excalidraw — 手绘风格图表
  • p5js — 生成艺术
  • ascii-art / ascii-video — 字符画
  • claude-design — 网页/UI 原型

研究类：

  • arxiv — 论文检索
  • youtube-content — YouTube 转录/总结
  • blogwatcher — RSS 监控

GitHub 工具链：

  • github-auth — 认证设置
  • github-repo-management — 仓库管理
  • codebase-inspection — 代码库统计

系统/运维：

  • vps-security — VPS 安全加固
  • static-site — 静态站点部署
  • low-resource-saas — 低配 VPS 跑 SaaS

5.3 从 Hub 安装扩展技能

不是所有技能都内置。Skills Hub 上有 81 个官方可选技能和更多社区技能。

安装 honcho（跨会话记忆增强）：

hermes skills install official/autonomous-ai-agents/honcho

这会请求确认，确认后安装到 ~/AppData/Local/hermes/skills/honcho/。

安装后执行 hermes honcho setup 配置 Honcho 服务（需要额外注册 honcho.dev）。

安装 blackbox（多模型编码代理）：

hermes skills install official/autonomous-ai-agents/blackbox

Blackbox AI 支持多模型协作编码，安装后还需安装 @blackboxai/cli：

npm install -g @blackboxai/cli

安装 docker-management（Docker 管理）：

hermes skills install official/devops/docker-management

5.4 搜索可用技能

hermes skills search "docker"     # 搜 Docker 相关
hermes skills search "memory"     # 搜记忆相关
hermes skills browse              # 浏览全部 312 个可用技能

六、核心技能推荐（按场景）

以下是我实际使用中筛选出的技能组合建议：

场景一：日常编程

必须加载：plan + test-driven-development + systematic-debugging
辅助加载：github-pr-workflow + github-code-review + spike

效果：先计划 → TDD 写代码 → 系统化调试 → PR 审查 → 合入

场景二：研究/学术

必须加载：arxiv + youtube-content + blogwatcher
辅助加载：obsidian（笔记）+ notion（知识库）

效果：搜论文 → 读摘要 → 分析内容 → 整理到知识库

场景三：全栈项目开发

必须加载：superpowers + subagent-driven-development
辅助加载：docker-management（容器化）+ hermes-agent（配置代理）

Superpowers 是社区开发的高级技能包，提供规约优先、TDD、子代理驱动的完整开发流水线。安装方式：

hermes skills install superpowers

场景四：运维/系统管理

必须加载：vps-security + static-site + low-resource-saas
辅助加载：github-repo-management + cron定时任务

七、配置优化

7.1 上下文压缩

Hermes 默认开启上下文压缩，当 token 使用达到 50% 阈值时自动压缩到 20%。这对 1M 上下文的 DeepSeek V4 Flash 来说很够用：

compression:
  enabled: true
  threshold: 0.5        # 50% 触发
  target_ratio: 0.2     # 压缩到 20%
  protect_last_n: 20    # 保护最近 20 条消息

7.2 子代理并行

delegation:
  max_concurrent_children: 3    # 最多 3 个子代理并行
  max_iterations: 50
  child_timeout_seconds: 600

效果：比如同时查 3 篇论文，或者同时做代码审查 + 跑测试 + 部署。

7.3 密钥安全

security:
  redact_secrets: true   # 自动遮蔽工具输出中的密钥

这个默认开启，不用担心终端输出里泄漏 API Key。

7.4 审批模式

approvals:
  mode: manual           # 危险操作先询问

也可以改成 smart，用小模型自动判断风险：

hermes config set approvals.mode smart

八、踩坑记录

8.1 技能 ID 和网上教程对不上

很多教程写的技能 ID 如 official/core/plan 在现有 Hub 中不存在。实际安装要用：

hermes skills search "plan"   # 先搜，看清 ID 再装

大部分核心技能已内置，不需要额外安装。

8.2 Hermes 没有 --now 参数

有些教程里 hermes skills install xxx --now，但实际 Hermes v0.14.0 没有这个参数。安装需要手动确认（或 echo "y" | hermes skills install xxx）。

8.3 文件路径用正斜杠

Windows 下 Hermes 工具接受 C:/Users/... 格式的路径，不需要反斜杠。

8.4 第一次启动没配置不要慌

第一次 hermes 会进入交互式配置，如果不熟可以先退出来（Ctrl+C），手动写 config.yaml 和 .env。

8.5 不是所有技能都能装

用户经常想装的一批技能（如 skill-finder、self-improve、python-debug、sql-expert、shell-master）在公有 Hub 上不存在。这些功能要么已经内置，要么需要通过其他方式实现。

九、总结

Hermes Agent + DeepSeek V4 Flash 在 Windows 11 上的体验总结：

维度评价
安装难度★★☆☆☆（会 pip 就行，比 Claude Code 简单）
配置灵活度★★★★★（20+ 提供商，随便换）
技能生态★★★★☆（80+ 内置 + Hub 扩展）
稳定性★★★☆☆（还在快速迭代，偶尔有小毛病）
DeepSeek V4 Flash 表现★★★★☆（速度快、成本低、中文好）

最大的优势是模型无关：你可以在 DeepSeek V4 Flash 上写代码，切到 Claude 做深度推理，再切回 DeepSeek 做日常对话——都在同一个 Agent 里，配置不变。

最大的学习成本是技能系统：80+ 内置技能初次看到会有点懵，建议按场景分批上手，不要一次全装。

附录：本文环境

  • 操作系统：Windows 11
  • Shell：git-bash (MSYS2)
  • Hermes Agent：v0.14.0 (2026.5.16)
  • Python：3.12.2
  • 模型：DeepSeek V4 Flash（provider: deepseek）
  • 安装方式：pip install hermes-agent

最后更新：2026-05-21