Hermes Agent Integration

Hermes Agent Integration for OpenClaw. Connect OpenClaw with NousResearch Hermes Agent (53K stars) for self-improving AI capabilities. Triggers: hermes agent...

Security Scan

The skill's documented purpose (integrating Hermes Agent with OpenClaw) matches the instructions, but the runtime instructions ask you to run remote install scripts and to provide service tokens that are not declared in the skill metadata — that mismatch and the use of third‑party repos warrant caution.

Purpose & Capability

The name/description and the SKILL.md are consistent: the document describes installing Hermes Agent and integrating it with OpenClaw. However the skill instructs cloning a third‑party repository (jnMetaCode/agency-agents-zh) and installing many components (pip packages, npx tools) not mentioned in the short registry description — this expands the footprint beyond a minimal integration and should be expected but is notable.

Instruction Scope

SKILL.md contains explicit runtime instructions to run remote install scripts (curl | bash), pip install packages, git clone/execute install scripts, and to configure tokens (e.g., TELEGRAM_BOT_TOKEN, DISCORD_BOT_TOKEN) and a home config path (~/.hermes). The registry metadata declared no required env vars or install steps, yet the instructions reference environment variables and mutating user config and filesystem. The instructions therefore ask for actions and secrets not declared in the skill metadata and direct execution of remote code — this is a scope and transparency concern.

Install Mechanism

There is no formal install spec in the registry (instruction-only). The instructions recommend running a script from raw.githubusercontent.com (a well-known host), pip installing packages, and cloning a third‑party GitHub repo. While GitHub raw and PyPI are common distribution points, piping remote scripts to bash and running third‑party install scripts carries nontrivial risk; users should review those scripts before running them.

Credentials

Registry metadata lists no required environment variables or credentials, but the SKILL.md expects service tokens (TELEGRAM_BOT_TOKEN, DISCORD_BOT_TOKEN) and implies credentials for model providers (nous-portal, OpenRouter, etc.). This mismatch (undeclared secrets) is disproportionate and reduces transparency — the skill will require secrets to operate but does not declare them in metadata.

Persistence & Privilege

The skill does not set always:true and is user-invocable (normal). However the integration directs creating ~/.hermes, suggests enabling autoSpawn in OpenClaw config, and describes cross-session memory and cron scheduling. That implies persistent storage and background scheduled activity; these are reasonable for this integration but increase long‑term persistence and potential impact — the user should expect files and scheduled tasks to be created.

What to consider before installing

This skill is plausible for integrating Hermes with OpenClaw but has several transparency gaps and moderately risky install steps. Before installing: (1) Inspect any remote install script (the raw.githubusercontent.com URL) — do NOT run curl | bash blindly. (2) Review the agency-agents-zh repo and its install script; it is a third‑party repo, not clearly an official NousResearch artifact. (3) Be aware the SKILL.md references TELEGRAM_BOT_TOKEN and DISCORD_BOT_TOKEN and other provider credentials that the registry did not declare — only provide tokens you trust and consider creating limited-scope/test credentials. (4) Prefer installing in an isolated environment (container or VM) or reviewing scripts locally, and back up your OpenClaw config (~/.openclaw or equivalent) before enabling autoSpawn or modifying plugin configs. (5) If you need higher assurance, ask the skill author for signed releases or an explicit install manifest and for the list of exact permissions the installed components will need.

Hermes Agent Integration — OpenClaw × Hermes Agent

功能说明

将 OpenClaw 与 NousResearch 的 Hermes Agent (53K⭐) 集成，获得自改进 AI 能力。Hermes Agent 是唯一内置学习循环的 AI Agent——从经验中创建技能、在使用中改进、跨会话记忆。

Hermes Agent 核心能力

能力	说明
🧠 自改进学习循环	从经验中创建技能，使用中持续改进
💾 跨会话记忆	搜索历史对话，建立用户模型
📱 多平台支持	Telegram/Discord/Slack/WhatsApp/CLI
⏰ 内置 cron 调度	日报、备份、审计等自动化任务
🔄 子代理并行	spawn isolated subagents for parallel work
🌐 任意模型	Nous Portal/OpenRouter/z.ai/Kimi/MiniMax/OpenAI
🖥️ 六终端后端	local/Docker/SSH/Daytona/Singularity/Modal

使用场景

1. 安装 Hermes Agent

# Linux/macOS/WSL2
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# Android/Termux
pkg install python
pip install hermes-agent[termux]

2. 配置 Hermes Agent

# 设置模型
hermes model nous-portal

# 配置 Telegram
hermes config telegram --token YOUR_BOT_TOKEN

# 配置 Discord
hermes config discord --token YOUR_BOT_TOKEN

3. OpenClaw + Hermes 协同工作

用户：用 Hermes Agent 处理这个复杂任务

输出：

• 启动 Hermes Agent 子代理
• 并行执行任务
• 返回结果到 OpenClaw

4. 使用 Hermes 的学习能力

用户：让 Hermes 从这次任务中学习

输出：

• Hermes 创建新技能
• 保存到技能库
• 下次自动应用

集成架构

OpenClaw Gateway
    │
    ├── Hermes Agent (自改进核心)
    │   ├── Skill Learning (技能学习)
    │   ├── Memory Search (记忆搜索)
    │   ├── User Modeling (用户建模)
    │   └── Cron Scheduler (定时任务)
    │
    ├── agency-agents (193 个 AI 专家)
    │   ├── Engineering (工程类)
    │   ├── Design (设计类)
    │   ├── Marketing (营销类)
    │   └── More... (18 个部门)
    │
    └── OpenClaw Skills (66+ 技能)

agency-agents 集成

193 个 AI 专家角色

部门	智能体数量	示例
Engineering	45	Security Engineer, DevOps Engineer, Frontend Expert
Design	18	UX Designer, UI Designer, Brand Strategist
Marketing	25	SEO Specialist, Content Strategist, Social Media Manager
Product	15	Product Manager, Growth Hacker, Data Analyst
China Market	46	小红书运营、抖音投放、微信生态、B 站 UP 主
More...	44	Finance, Legal, HR, Gaming, etc.

安装到 OpenClaw

# 克隆 agency-agents-zh
git clone https://github.com/jnMetaCode/agency-agents-zh.git

# 运行安装脚本
cd agency-agents-zh
./scripts/install.sh --tool openclaw

使用示例

用户：激活安全工程师智能体，审查这段代码

输出：

• 安全工程师按 OWASP Top 10 逐项审查
• 输出漏洞报告
• 提供修复建议

多智能体协作

使用 Agency Orchestrator 编排多个智能体：

# workflows/story-creation.yaml
narrator:
  role: 叙事学家
  output: story_outline

psychologist:
  role: 心理学家
  input: story_outline
  output: character_profiles

creator:
  role: 内容创作者
  input: [story_outline, character_profiles]
  output: final_story

npx ao run workflows/story-creation.yaml --input premise='你的创意'

配置示例

Hermes Agent 配置

# ~/.hermes/config.yaml
model:
  provider: nous-portal
  name: Nous-Hermes-2.1

memory:
  enabled: true
  search: fts5
  user_modeling: honcho

platforms:
  telegram:
    enabled: true
    token: ${TELEGRAM_BOT_TOKEN}
  discord:
    enabled: true
    token: ${DISCORD_BOT_TOKEN}

scheduler:
  enabled: true
  timezone: Asia/Shanghai
  tasks:
    - name: daily-report
      schedule: "0 9 * * *"
      action: report --format markdown

OpenClaw 配置

{
  "plugins": {
    "hermes": {
      "enabled": true,
      "config": {
        "path": "~/.hermes",
        "autoSpawn": true
      }
    }
  }
}

性能优势

场景	OpenClaw 单独	OpenClaw + Hermes	提升
复杂任务处理	串行执行	并行子代理	3-5x
跨会话记忆	有限上下文	完整记忆搜索	∞
自动化任务	需 cron 配置	内置调度器	简化
技能学习	手动创建	自动从经验学习	10x

相关文件

• Hermes Agent 官方文档
• Hermes Agent GitHub
• agency-agents-zh
• Agency Orchestrator
• Nous Research

触发词

• 自动：检测 Hermes、Nous、自改进、多智能体相关关键词
• 手动：/hermes, /agency-agents, /multi-agent
• 短语：集成 Hermes、用 Hermes 处理、激活智能体

Usage

1. Install the skill
2. Configure as needed
3. Run with OpenClaw