hermes-agent
NousResearch Hermes Agent 通用集成 Skill。通过 CLI 调用 Hermes Agent 的核心能力： - 🚀 自改进技能系统（从任务中自动创建可复用技能） - 🧠 持久化记忆（FTS5全文搜索 + LLM摘要） - 🤖 子代理委托（任务隔离和并行处理） - 🔌 MCP 双向集成 - 🌐 浏览器自动化 - 💻 代码执行 - 🔍 网页研究 - 📦 完全可移植，支持任意 Claw/WorkBuddy 实例一键安装
By wihy · 568 installs
npx skills add wihy/hermes-agent-skill --skill hermes-agent
Source repository · Upstream listing
Hermes Agent Skill v2.0
概述
本 Skill 封装了 [NousResearch Hermes Agent](https://github.com/NousResearch/hermes agent) 的 CLI 调用能力，让 WorkBuddy/Claw 可以通过 Shell 命令利用 Hermes 的核心功能。
v2.0 改进：完全可移植，无硬编码路径，支持任意实例一键安装。
首次安装
一键安装（推荐）
当检测到 Hermes 未安装时，运行：
安装脚本会自动：
1. ✅ 检测 Python 3.11+ 环境
2. ✅ 克隆 Hermes Agent 源码
3. ✅ 创建 Python 虚拟环境并安装依赖
4. ✅ 创建 ~/.local/bin/hermes CLI 入口
5. ✅ 初始化 ~/.hermes/ 配置目录
6. ✅ 生成默认 .env 配置模板
安装后配置 API Key
可选提供商（任选其一）：
验证安装
迁移到其他 Claw 实例
将整个 Skill 目录复制到目标实例即可：
核心工作流
1. 调用模式速查
场景 命令 说明
快速问答 hermes run "问题" non interactive no stream 最简调用
带上下文 hermes run "问题" context file ./ctx.md non interactive 注入项目上下文
子代理委托 使用 scripts/hermes delegate.sh 复杂任务分解
技能查询 hermes skills list 查看已学技能
记忆搜索 hermes memory search "关键词" 检索历史知识
状态检查 hermes status 或 hermes doctor 诊断安装状态
2. CLI 命令完整参考
基础命令
子代理委托
记忆管理
技能管理
插件管理
定时任务 (Cron)
MCP 集成
Wrapper 脚本
scripts/hermes wrapper.sh
统一的 CLI 封装脚本，提供 JSON 格式化输出和错误处理：
输出格式 ：JSON（包含 success , output , error , duration ms 字段）
scripts/hermes delegate.sh
子代理委托专用脚本：
scripts/install hermes.sh
一键安装脚本（详见上方「首次安装」章节）：
模型配置
运行交互式配置向导：
或直接编辑 ~/.hermes/config.yaml ：
支持的提供商 ：openrouter, anthropic, openai, gemini, zai, kimi coding, nous, custom
最佳实践
✅ 推荐做法
1. 始终使用 non interactive no stream ：避免 TUI 阻塞
2. 设置合理的超时时间 ：简单任务 60s，复杂任务 300s
3. 限制工具集 ：用 toolset 减少 Token 消耗
4. 使用上下文文件 ：将大段背景信息放入文件，而非 prompt 中
5. 错误重试机制 ：网络问题时自动重试 1 2 次
⚠️ 注意事项
1. Token 成本 ：每次调用都有成本
2. 并发限制 ：最多 3 个并发子代理
3. 超时保护 ：长时间运行的任务必须设置 timeout
4. API Key 安全 ：不要在 Skill 文件中硬编码密钥
5. Python 版本 ：确保使用 Python 3.11+
故障排除
问题 解决方案
command not found: hermes 运行 export PATH="$HOME/.local/bin:$PATH" 或重新执行 install hermes.sh
TypeError: unsupported operand 确保 Python 3.11+
API Key 错误 检查 ~/.hermes/.env 配置
连接超时 检查网络，或更换 LLM 提供商
子代理失败 减少 max concurrent 或增加 timeout
安装脚本失败 运行 hermes doctor 诊断
文件结构
更新日志
v2.0.0 (2026 04 12): 完全可移植版 — 移除所有硬编码路径，添加一键安装脚本，支持任意 Claw 实例迁移
v1.0.0 (2026 04 11): 初始版本，支持基础 CLI 调用、子代理委托、记忆/技能管理